La integración más popular. OpenClaw se conecta como un dispositivo vinculado de WhatsApp, igual que WhatsApp Web.
📱 Paso 1: Vincular con el QR
La terminal muestra un código QR. Para escanearlo:
- Abre WhatsApp en tu teléfono.
- Ve a Configuración → Dispositivos vinculados.
- Toca Vincular dispositivo.
- Escanea el QR de la terminal.
Comprueba que quedó conectado:
🔐 Paso 2: Decide quién puede escribirle
Por defecto, OpenClaw usa pairing: cuando alguien nuevo escribe, recibe un código y tú decides si lo apruebas. Así nadie usa tu agente sin permiso.
Si prefieres una lista fija de números, edita ~/.openclaw/openclaw.json:
{
channels: {
whatsapp: {
dmPolicy: "allowlist",
allowFrom: ["+50255551234"],
},
},
}
Los números van en formato internacional (+ y código de país).
dmPolicy | Qué hace |
|---|---|
pairing | Los nuevos contactos piden acceso con un código (por defecto) |
allowlist | Solo responde a los números de allowFrom |
open | Responde a cualquiera: úsalo con mucho cuidado |
disabled | No responde mensajes directos |
🧪 Paso 3: Probar
Pídele a alguien de tu lista que te escriba. Una conversación de ejemplo con la personalidad de la lección anterior:
Luna
En línea
Hola, ¿cuáles son sus horarios?
3:15 PM
¡Hola! 👋 Nuestro horario es de lunes a viernes de 9 a. m. a 6 p. m., y sábados de 9 a. m. a 1 p. m. ¿Te ayudo con algo más?
3:15 PM
Primera interacción (en SOUL.md)
## Primera interacción
Cuando alguien escribe por primera vez, saludo con:
"¡Hola! 👋 Soy Luna, asistente de [Negocio]. ¿En qué te ayudo?"
Importante
OpenClaw funciona como un dispositivo vinculado. Si desvinculas la sesión desde el teléfono, tendrás que escanear el QR de nuevo.
🚨 Problemas comunes
| Problema | Solución |
|---|---|
| El QR expiró | Vuelve a correr openclaw channels login --channel whatsapp |
| Se desconectó | Revisa Dispositivos vinculados en el teléfono y openclaw channels status --probe |
| No responde | Revisa que el número esté aprobado o en allowFrom, y mira openclaw logs --follow |
| Responde mal | Edita SOUL.md y AGENTS.md con más contexto |
💡 Tips para producción
Pro tip avanzado
- Usa un número dedicado para el negocio, no tu número personal.
- WhatsApp Business funciona igual y se ve más profesional.
- Los primeros días, revisa las conversaciones para afinar SOUL.md.
Fuente: OpenClaw — WhatsApp.
¿Qué necesitas hacer para conectar WhatsApp?