La mayoría de tutoriales de “WhatsApp + IA” empiezan pidiéndote que te registres en la API oficial de Meta, pases una verificación de empresa, esperes días y pongas la tarjeta. OpenClaw permite una ruta distinta: conectar una sesión tipo WhatsApp Web y probar tu agente sin pasar por la API oficial.
Este es ese tutorial.
Si todavía estás ordenando instalación, memoria y permisos, vuelve a la guía OpenClaw en español antes de conectar WhatsApp.
Por que OpenClaw y no la API oficial de WhatsApp
Antes de entrar en pasos, toca aclarar algo: hay tres formas de conectar IA a WhatsApp, y no son iguales.
La API oficial de WhatsApp Business de Meta requiere cuenta verificada como empresa, aprobación manual, una plantilla de mensajes aprobada para cada tipo de mensaje que envíes, y un proveedor intermediario como Twilio o 360dialog que te cobra por mensaje. El proceso de registro puede tardar semanas. Para un solopreneur o equipo pequeño, es overkill.
Twilio, 360dialog y similares son más rápidos pero siguen requiriendo cuenta Business y tienen costes por mensaje (entre 0,004€ y 0,08€ según el tipo de conversación). Para volúmenes altos tiene sentido. Para gestionar tu WhatsApp personal o de un negocio pequeño, es dinero que no necesitas gastar.
OpenClaw con whatsapp-web.js se conecta a WhatsApp de forma similar a WhatsApp Web en tu navegador: usando una sesión vinculada por QR. No sustituye las normas de WhatsApp ni elimina la necesidad de definir límites, pero evita empezar por la API oficial de Meta.
El enfoque tiene una limitación importante: si usas ese número para spam masivo o automatizas sin criterio, Meta puede limitar o cerrar la cuenta. Úsalo como asistente para conversaciones legítimas, con revisión humana cuando toque.
Antes de conectar WhatsApp: define límites
WhatsApp suele mezclar clientes, contactos personales, datos sensibles y conversaciones de alta intención. Antes de activar el canal, decide qué puede leer el agente, a quién puede responder, cuándo debe pedir revisión humana y qué casos quedan fuera.
Revisa seguridad en OpenClaw antes de automatizar
Si vas a conectar un número real, revisa primero la guía de seguridad en OpenClaw. Te ayudará a pensar en permisos, logs, credenciales y supervisión antes de abrir el canal.
Requisitos previos
Antes de empezar necesitas tener tres cosas:
1. OpenClaw instalado en un VPS (o en tu máquina local si solo quieres probarlo). Si aún no lo tienes, sigue primero la guía de instalación de OpenClaw en VPS y vuelve aquí cuando esté corriendo.
2. Un número de WhatsApp activo en tu teléfono. Personal o Business, da igual. Necesitas tener acceso al teléfono para escanear el QR durante la configuración inicial.
3. El gateway de OpenClaw corriendo. Puedes verificarlo con openclaw gateway status. Si no está corriendo, openclaw gateway start.
Eso es todo. No necesitas instalar nada más, no necesitas claves de API externas, no necesitas abrir ninguna cuenta.
Paso 1 — Activar el channel de WhatsApp en OpenClaw
OpenClaw gestiona los canales de comunicación desde su configuración. WhatsApp es un canal que viene disponible pero que hay que activar explícitamente.
Abre tu archivo de configuración de OpenClaw (normalmente en ~/.openclaw/openclaw.json o el directorio que hayas configurado) y añade o verifica que el canal de WhatsApp esté en la lista de canales habilitados.
Desde la terminal del VPS, puedes hacer:
openclaw channel listEsto te muestra los canales disponibles y su estado. Si WhatsApp aparece como disabled, actívalo:
openclaw channel enable whatsappSi el comando no está disponible en tu versión, edita directamente openclaw.json y añade "whatsapp": true en la sección de channels, luego reinicia el gateway:
openclaw gateway restartUna vez reiniciado, OpenClaw iniciará el proceso de autenticación de WhatsApp y generará un código QR en el log del gateway.
Paso 2 — Escanear el codigo QR
Cuando OpenClaw inicia el canal de WhatsApp, genera un QR que aparece en el log del gateway. Para verlo en tiempo real:
openclaw gateway logs --followO si tienes el gateway corriendo como servicio del sistema:
journalctl -u openclaw -fVerás algo así en la terminal, un QR en ASCII que puedes escanear directamente desde la pantalla.
Cómo escanear desde el teléfono:
- Abre WhatsApp en tu teléfono
- Ve a Configuración (icono de tres puntos o tuerca)
- Toca Dispositivos vinculados
- Toca Vincular un dispositivo
- Apunta la cámara al QR que aparece en tu terminal
El QR expira en aproximadamente 60 segundos. Si expira antes de que puedas escanearlo, OpenClaw generará uno nuevo automáticamente en el siguiente ciclo del log.
Una vez escaneado, verás en la terminal el mensaje WhatsApp connected o similar, y en tu teléfono aparecerá OpenClaw (o el nombre del servidor) en la lista de dispositivos vinculados, igual que aparece “Chrome en Windows” cuando usas WhatsApp Web.
La sesión se mantiene activa de forma indefinida mientras el gateway esté corriendo. Si reinicias el servidor, OpenClaw restaura la sesión automáticamente sin necesidad de escanear el QR de nuevo. Solo necesitarás repetir el proceso si cierras manualmente la sesión desde tu teléfono.
Paso 3 — Configurar como responde tu agente
Una vez conectado, cada mensaje que recibas en ese número de WhatsApp llegará a OpenClaw. El agente procesará el mensaje y responderá usando el modelo de IA y el contexto que tengas configurado.
El comportamiento de respuesta depende de lo que hayas definido en tu configuración de OpenClaw, especialmente en los archivos de contexto del agente. Algunos puntos a personalizar para WhatsApp:
Prompt de sistema: OpenClaw usa el contexto del agente (SOUL.md en la configuración por defecto) para saber cómo comportarse. Puedes añadir instrucciones específicas para WhatsApp: “En WhatsApp, los mensajes deben ser más cortos y conversacionales. Sin listas largas. Respuestas de máximo 3-4 frases.”
Política de respuesta automática: Por defecto, OpenClaw puede responder a todos los mensajes entrantes. Si quieres que solo responda a ciertos contactos o grupos, puedes configurar filtros en la política de acceso del canal.
Memoria de conversación: OpenClaw mantiene el historial de cada conversación por contacto. Tu agente recuerda lo que hablasteis la última vez. Exactamente lo que explico en qué es un agente IA personal y por qué cambia todo.
Que puede hacer tu agente en WhatsApp
Una vez conectado, las posibilidades dependen de qué skills tengas configurados en OpenClaw. Algunas de las más comunes:
Responder preguntas sobre tu negocio: FAQs, precios, horarios, cómo contratar. El agente accede a tu base de conocimiento y responde como si fueras tú.
Gestionar citas y recordatorios: Si tienes integrado el calendario, el agente puede ver tu disponibilidad y proponer horas. Alguien escribe “quiero reservar una sesión” y el agente mira el calendario, propone horas libres y confirma.
Soporte inicial de clientes: Filtrar y resolver las consultas más simples antes de que lleguen a ti. El 70% de los mensajes de soporte suelen ser variaciones de las mismas 10 preguntas.
Notificaciones proactivas: OpenClaw puede enviarte mensajes de WhatsApp cuando ocurren eventos: una venta, una tarea completada, una alerta de monitorización.
Si quieres ver más casos de uso detallados, en automatizar WhatsApp con IA: guía completa tienes una visión más amplia de lo que es posible y cómo estructurarlo para un negocio.
Problemas comunes y como resolverlos
El QR no aparece en los logs: Verifica que el canal de WhatsApp esté habilitado en la configuración y que el gateway se haya reiniciado después del cambio. openclaw gateway restart y luego openclaw gateway logs --follow.
El QR expira antes de poder escanearlo: Es normal si el log tiene mucho output y el QR sube rápido. Filtra los logs: openclaw gateway logs --follow | grep -A 30 "QR" para ver solo la zona del QR.
La sesión se desconecta frecuentemente: Suele pasar si hay otro dispositivo intentando conectarse con el mismo número, o si el teléfono tiene mala conexión. Asegúrate de que no tienes WhatsApp Web abierto en el navegador al mismo tiempo. Si el problema persiste, limpia la sesión guardada y vuelve a escanear:
# La ruta exacta depende de tu instalación
rm -rf ~/.local/share/openclaw/whatsapp/
openclaw gateway restartEl agente responde tarde o con errores: Verifica que el modelo de IA configurado en OpenClaw responde bien. Puedes probarlo en Telegram o en el chat local para descartar que el problema sea WhatsApp en sí.
WhatsApp no muestra el dispositivo en “Dispositivos vinculados”: El escaneo funcionó pero el teléfono no lo registró. Vuelve a intentarlo; a veces WhatsApp tarda unos segundos en procesar la vinculación.
Siguiente nivel — Skills para WhatsApp
La conexión básica ya es útil. Pero OpenClaw tiene un sistema de skills que permite ampliar lo que tu agente puede hacer cuando responde por WhatsApp.
Algunos examples: skills de CRM que buscan el historial del cliente antes de responder, skills de calendario que muestran disponibilidad en tiempo real, skills de resumen que compactan conversaciones largas antes de pasártelas.
Lo interesante de OpenClaw es que los skills funcionan igual independientemente del canal. El mismo skill que hace algo en Telegram lo hace en WhatsApp. Configuras una vez, funciona en todos tus canales. Si quieres entender bien cómo funciona la arquitectura completa, la guía de OpenClaw en español te da el mapa completo.
Conclusion
Ya tienes una ruta para conectar WhatsApp a OpenClaw sin empezar por la API oficial de Meta. El valor real no está en responder todo automáticamente, sino en definir bien límites, contexto, permisos y revisión humana.
La clave no es automatizarlo todo, sino configurar bien límites, contexto y permisos. El siguiente paso es ajustar cómo responde tu agente y qué skills tiene acceso. Ahí es donde pasa lo interesante.
Preguntas frecuentes
¿Necesito una API de pago para conectar OpenClaw a WhatsApp?
No. OpenClaw usa whatsapp-web.js, que se conecta como un cliente normal de WhatsApp Web. Solo necesitas escanear un código QR con tu teléfono, igual que haces con WhatsApp Web en el navegador.
¿Mi número de WhatsApp puede quedar baneado?
Hay riesgo si automatizas mal, haces envíos masivos o incumples las normas de WhatsApp. Úsalo con límites claros, responde a conversaciones legítimas y evita mensajes no solicitados.
¿Puedo tener OpenClaw conectado a WhatsApp todo el día?
Sí. Al correr en un VPS, el gateway puede mantenerse corriendo en el servidor mientras el servicio esté activo. Tu teléfono puede estar apagado; la sesión de WhatsApp se mantiene activa en el servidor igual que WhatsApp Web.
¿Cuánto tarda en configurarse?
Depende de tu instalación, del VPS y de si ya tienes el gateway funcionando. Reserva tiempo para activar el canal, escanear el QR, probar respuestas y definir límites.
¿Funciona con WhatsApp Business?
Sí. OpenClaw funciona tanto con WhatsApp personal como con WhatsApp Business. El proceso de conexion por QR es identico en ambos casos.
¿Listo para tener tu propio agente IA?
Únete a TribuClaw →