Canal WhatsApp de OpenClaw

OpenClaw se conecta a WhatsApp a través de la biblioteca Baileys — una implementación de código abierto mediante ingeniería inversa del protocolo multi-dispositivo de WhatsApp Web. A diferencia de la API oficial de WhatsApp Business (que requiere aprobación de Meta y cobra por conversación), Baileys se conecta directamente emulando un dispositivo vinculado. La arquitectura es sencilla: tu teléfono sigue siendo el dispositivo principal, y el Gateway actúa como un dispositivo compañero vinculado. Los mensajes fluyen a través de los servidores de WhatsApp como de costumbre — OpenClaw simplemente intercepta los mensajes entrantes, los procesa con tu IA y envía las respuestas de vuelta.

Se recomienda encarecidamente un número de teléfono dedicado. Aunque puedes usar tu número personal, mezclar conversaciones personales y del bot crea confusión en el enrutamiento y puede molestar a tus contactos. Necesitas un número de teléfono real que pueda recibir SMS o llamadas de voz para el registro inicial de WhatsApp. Una vez registrado, el número solo necesita permanecer activo en un teléfono con WhatsApp instalado.

{
  "channels": {
    "whatsapp": {
      "accounts": {
        "default": {
          "phone": "+15551234567"
        }
      }
    }
  }
}

Después de configurar tu canal, necesitas vincular tu teléfono con el Gateway. Ejecuta el comando de login y aparecerá un código QR en tu terminal. Escanéalo con WhatsApp en tu teléfono (Ajustes → Dispositivos vinculados → Vincular un dispositivo). Las credenciales se guardan automáticamente en ~/.openclaw/credentials/whatsapp/<accountId>/creds.json y persisten entre reinicios. Se crea automáticamente una copia de seguridad (creds.json.bak) para recuperación en caso de corrupción. Solo necesitas escanear el código QR una vez, a menos que la sesión expire o se revoque manualmente.

openclaw channels login whatsapp

Las políticas de DM (Mensajes Directos) controlan quién puede interactuar con tu asistente de IA. OpenClaw soporta cuatro políticas: • pairing (predeterminado) — Los nuevos contactos deben pasar por un flujo de emparejamiento. Envían un mensaje, reciben un código de emparejamiento, y tú apruebas o rechazas vía CLI. Una vez aprobados, pueden chatear libremente. • allowlist — Solo los números de teléfono listados explícitamente en allowFrom pueden enviar mensajes al bot. Todos los demás son ignorados silenciosamente. • open — Cualquier persona que envíe un mensaje al número recibe una respuesta. Usar con precaución en producción. • disabled — El manejo de DM está completamente desactivado. El bot no responderá a ningún mensaje directo.

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

OpenClaw puede participar en chats grupales de WhatsApp. Por defecto, el soporte de grupos está desactivado para evitar respuestas de IA no deseadas en conversaciones compartidas. Cuando está habilitado, el bot responde solo cuando es mencionado por nombre o activado por una palabra clave configurada. Puedes controlar qué grupos están activos y cómo se activa el bot.

{
  "channels": {
    "whatsapp": {
      "groupPolicy": "allowlist",
      "groupActivation": "mention",
      "groupAllowList": ["group-jid-1", "group-jid-2"]
    }
  }
}

Puedes configurar si OpenClaw envía confirmaciones de lectura (marcas azules) al procesar un mensaje. Por defecto, se envían confirmaciones de lectura para mantener una conversación natural. Desactivar las confirmaciones de lectura puede ser útil si quieres que el bot parezca menos "activo" o si procesas mensajes de forma asíncrona.

{
  "channels": {
    "whatsapp": {
      "sendReadReceipts": true
    }
  }
}

OpenClaw puede reaccionar a los mensajes entrantes con un emoji para confirmar la recepción antes de que la respuesta de IA esté lista. Esto es útil porque las respuestas de IA pueden tardar varios segundos, y la reacción informa al remitente que su mensaje fue recibido. Puedes configurar diferentes reacciones para mensajes directos y chats grupales, o desactivar la función por completo.

{
  "channels": {
    "whatsapp": {
      "ackReaction": {
        "emoji": "👀",
        "direct": true,
        "group": true
      }
    }
  }
}

OpenClaw soporta el envío de texto, imágenes, documentos, audio y video a través de WhatsApp. Los archivos multimedia se manejan automáticamente — el Gateway los sube a los servidores de WhatsApp y envía el tipo de mensaje apropiado. Para respuestas de IA largas, el texto se divide automáticamente en fragmentos para mantenerse dentro de los límites de tamaño de mensajes de WhatsApp. Puedes configurar el tamaño de los fragmentos y el comportamiento.

WhatsApp aplica límites de velocidad en dispositivos vinculados. Aunque no hay límites oficiales publicados para cuentas personales, enviar demasiados mensajes muy rápido puede provocar bloqueos temporales o restricciones de cuenta. OpenClaw incluye limitación de velocidad integrada para proteger tu cuenta. La configuración predeterminada es conservadora y adecuada para la mayoría de los casos de uso.

{
  "channels": {
    "whatsapp": {
      "textChunkLimit": 5,
      "mediaMaxMb": 50
    }
  }
}

Quizás te preguntes por qué OpenClaw usa Baileys en lugar de la API oficial de WhatsApp Business (a través de Twilio, MessageBird, etc.). Estas son las razones: • Costo — La API Business cobra por conversación (aproximadamente $0.005–$0.08 por mensaje según la región). Para uso personal o de equipos pequeños, esto se acumula rápidamente. Baileys es gratuito. • Aprobación — La API Business requiere verificación de Meta, una empresa registrada y aprobación de plantillas de mensajes. Baileys funciona con cualquier cuenta personal de WhatsApp. • Flexibilidad — La API Business tiene requisitos estrictos de plantillas para mensajes salientes y una ventana de conversación de 24 horas. Baileys no tiene tales restricciones. • Autoalojado — Con Baileys, todo se ejecuta en tu servidor. Ningún proveedor de API de terceros ve tus mensajes. El compromiso está en la confiabilidad: la API Business tiene soporte oficial, mientras que Baileys depende de ingeniería inversa y podría dejar de funcionar si WhatsApp cambia su protocolo. Para la mayoría de los casos de uso autoalojados, este compromiso vale la pena.