Cómo conectar OpenClaw con WhatsApp paso a paso

Paso 1: instala OpenClaw y ejecuta el asistente

Abre tu terminal y ejecuta el instalador oficial:

curl -fsSL https://openclaw.ai/install.sh | bash

Después, inicia el asistente de configuración:

openclaw onboard

El asistente te guía por la configuración del gateway, workspace, selección de canales y proveedor de IA. Si es tu primera vez, selecciona QuickStart para usar valores por defecto seguros. Al terminar tendrás tu workspace listo en ~/.openclaw/.

Paso 2: vincula tu cuenta de WhatsApp

Ejecuta el comando de login para el canal de WhatsApp:

openclaw channels login --channel whatsapp

Aparecerá un código QR en la terminal. Escanéalo desde tu teléfono:

• Abre WhatsApp en tu teléfono.
• Ve a Ajustes → Dispositivos vinculados → Vincular dispositivo.
• Apunta la cámara al QR de la terminal.

Si manejas varias cuentas (por ejemplo, una para ventas y otra para soporte), puedes nombrarlas:

openclaw channels login --channel whatsapp --account ventas
openclaw channels login --channel whatsapp --account soporte

Paso 3: configura quién puede hablar con tu agente

Este paso es clave para seguridad. En el archivo ~/.openclaw/openclaw.json defines la política de acceso a mensajes directos:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+521234567890"]
    }
  }
}

Las opciones de política son:

• pairing (recomendado para empezar) — Los desconocidos reciben un código de vinculación que tú apruebas manualmente.
• allowlist — Solo los números que listes en allowFrom pueden interactuar.
• open — Cualquier persona puede hablar con el agente (úsalo con precaución).
• disabled — Los mensajes directos quedan desactivados.

Si también quieres que tu agente participe en grupos, configura groupPolicy con las mismas opciones y opcionalmente lista los grupos permitidos en groups.

Paso 4: levanta el gateway y aprueba solicitudes

Inicia el gateway para que tu agente empiece a escuchar mensajes:

openclaw gateway

Si usas el modo pairing, cuando alguien nuevo le escriba a tu agente recibirá un código. Para aprobar solicitudes pendientes:

# Ver solicitudes pendientes
openclaw pairing list whatsapp

# Aprobar una solicitud
openclaw pairing approve whatsapp <CÓDIGO>

Los códigos de pairing expiran después de 1 hora y solo puede haber 3 solicitudes pendientes por canal. Si necesitas abrir acceso rápido, cambia temporalmente a allowlist con los números específicos.

3 automatizaciones prácticas para WhatsApp

Con el gateway corriendo, tu agente ya puede recibir y responder mensajes. Aquí tienes tres flujos que puedes implementar desde el primer día.

"Eres el asistente de soporte de [tu negocio].
Responde preguntas sobre horarios, precios y servicios
usando esta información: [pega tu FAQ aquí].
Si no puedes resolver, responde: 'Te conecto con un
asesor humano, dame un momento.'"

"Ayuda al cliente a agendar una cita. Pregunta:
1) Nombre completo
2) Servicio que necesita
3) Fecha y hora preferida
4) Confirma los datos antes de cerrar.
Responde siempre en español y de forma amable."

"Cuando un cliente envíe un número de pedido,
busca el estado en [tu fuente de datos].
Responde con: número de pedido, estado actual
y fecha estimada de entrega.
Si no encuentras el pedido, pide que verifique
el número o lo conectes con soporte."

Consejos para producción

• Usa un número dedicado. No mezcles tu WhatsApp personal con el del agente. Un número dedicado da separación limpia y reduce riesgo de restricciones en tu cuenta personal.
• Desactiva escritura de configuración en producción. Configura channels.whatsapp.configWrites = false para evitar cambios accidentales.
• Monitorea con openclaw doctor. Este comando diagnostica problemas de conexión, sesiones expiradas y errores comunes.
• Respalda tus credenciales. La carpeta ~/.openclaw/credentials/whatsapp/ contiene la sesión de tu agente. Si la pierdes, necesitas re-vincular.
• Límites de archivos. OpenClaw acepta archivos entrantes hasta 50 MB y envía hasta 5 MB por defecto. Soporta imágenes, video, audio, documentos y notas de voz.

Video recomendado (tutorial OpenClaw)

Si prefieres formato visual, este tutorial completo de OpenClaw te ayuda a entender el setup general antes de configurar WhatsApp.

Si no se reproduce dentro de la página, ábrelo en YouTube.

Preguntas rápidas