Guía de integración de OpenClaw con WhatsApp (Wacli): configuración, mensajería y privacidad

WhatsApp tiene más de dos mil millones de usuarios activos en todo el mundo, lo que lo convierte en la mayor plataforma de mensajería del planeta. La integración de OpenClaw con WhatsApp, impulsada por la herramienta CLI Wacli, permite a tu agente de IA aprovechar esta enorme base de usuarios: enviar mensajes, buscar en el historial de conversaciones y automatizar flujos de trabajo de comunicación directamente a través de WhatsApp.

A diferencia de la integración con Telegram, que usa una bot API oficial, la integración con WhatsApp funciona mediante Wacli, una herramienta CLI de terceros que conecta WhatsApp Web con tu agente. Este enfoque tiene implicaciones importantes para la configuración, la fiabilidad y la privacidad que cubriremos en detalle.

Qué hace la skill de WhatsApp

La skill de WhatsApp basada en Wacli proporciona a tu agente de OpenClaw estas capacidades:

• Enviar mensajes --- Mensajes de texto a contactos individuales o grupos
• Buscar en conversaciones --- Consultar el historial de mensajes en todos los chats
• Leer mensajes --- Acceder a mensajes recientes en conversaciones específicas
• Listar contactos --- Ver los contactos y grupos disponibles
• Enviar contenido multimedia --- Compartir imágenes y documentos por WhatsApp
• Monitorizar entrantes --- Reaccionar a nuevos mensajes en tiempo real

La skill cierra la brecha entre la plataforma de WhatsApp, orientada al consumidor, y las capacidades de automatización de OpenClaw, habilitando flujos de trabajo que de otro modo requerirían interacción manual con el teléfono.

Cómo instalarla

Paso 1: instalar Wacli

Wacli es la herramienta CLI subyacente que proporciona la conectividad con WhatsApp. Instálala primero:

# macOS
brew install wacli

# Linux
curl -sSL https://get.wacli.dev | sh

# Or via npm
npm install -g wacli

Paso 2: instalar la skill de OpenClaw

openclaw skill install whatsapp

Paso 3: autenticarse con WhatsApp

wacli auth

Esto muestra un código QR en tu terminal. Escanéalo con WhatsApp en tu teléfono (Ajustes > Dispositivos vinculados > Vincular un dispositivo). Una vez escaneado, Wacli mantiene una sesión persistente.

Configuración y ajustes

Configuración básica

{
  "whatsapp": {
    "wacli_path": "/usr/local/bin/wacli",
    "session_persistence": true,
    "message_handling": {
      "auto_read": false,
      "typing_indicator": true,
      "max_message_length": 4096
    },
    "privacy": {
      "log_messages": false,
      "allowed_contacts": [],
      "blocked_contacts": []
    }
  }
}

Gestión de sesiones

Las sesiones de Wacli persisten entre reinicios, pero WhatsApp requiere ocasionalmente una nueva autenticación (normalmente cada 14 días o tras reiniciar el teléfono). Cuando la sesión caduca, la skill notificará a tu agente y tendrás que volver a escanear el código QR.

Para comprobar el estado de la sesión:

wacli status

Lista de contactos permitidos

Para uso en producción, restringe siempre a qué contactos puede enviar mensajes tu agente:

{
  "privacy": {
    "allowed_contacts": ["+1234567890", "+0987654321"],
    "allowed_groups": ["Group Name 1", "Group Name 2"]
  }
}

Cuando allowed_contacts está vacío, el agente puede enviar mensajes a cualquiera de tu lista de contactos, lo cual rara vez es lo que quieres.

Recorrido por las funciones clave

1. Envío de mensajes

La función más directa. Tu agente puede componer y enviar mensajes a cualquier contacto o grupo:

Agent: I'll send that update to the client now.
[Tool call: whatsapp_send_message]
  to: "+1234567890"
  message: "Hi Sarah, the project report is ready. I've attached it to the email I just sent."

Los mensajes admiten el formato estándar de WhatsApp: negrita, cursiva, tachado y monospace.

2. Búsqueda en conversaciones

Aquí es donde Wacli realmente se diferencia. Tu agente puede buscar en todo tu historial de WhatsApp:

Agent: Let me find what they said about the deadline.
[Tool call: whatsapp_search]
  query: "deadline extension"
  contact: "+1234567890"
  limit: 10

La búsqueda devuelve mensajes con marca de tiempo e información del remitente, lo que permite a tu agente hacer referencia a conversaciones anteriores y mantener el contexto.

3. Lectura de mensajes recientes

Extrae los últimos mensajes de una conversación específica:

Agent: Let me check the latest messages in the team group.
[Tool call: whatsapp_read_messages]
  chat: "Engineering Team"
  count: 20

Esto es útil para ponerse al día con conversaciones, resumir discusiones de grupo o comprobar si alguien ha respondido a un mensaje anterior.

4. Compartir contenido multimedia

Envía imágenes y documentos junto con mensajes de texto. Esto combina bien con otras skills; por ejemplo, generar un gráfico con una herramienta de visualización de datos y enviarlo por WhatsApp.

5. Indicadores de escritura

Cuando typing_indicator está activado, la skill simula el estado de "escribiendo..." antes de enviar un mensaje. Esto hace que las respuestas automatizadas parezcan más naturales para los destinatarios que no saben que están chateando con un agente de IA.

Consideraciones de privacidad

La integración con WhatsApp conlleva implicaciones de privacidad significativas que debes considerar cuidadosamente.

Acceso a datos

Cuando autenticas Wacli, este obtiene acceso a toda tu cuenta de WhatsApp: todas las conversaciones, contactos y contenido multimedia. Esto es fundamentalmente diferente de los bots de Telegram, que solo ven los mensajes que se les envían explícitamente.

Recomendaciones

1. Usa un número de teléfono dedicado --- No conectes tu cuenta personal de WhatsApp. Consigue un número aparte para tu agente.
2. Desactiva el registro de mensajes --- Configura log_messages: false salvo que necesites específicamente registros de conversaciones.
3. Restringe los contactos --- Usa siempre allowed_contacts para limitar a quién puede enviar mensajes el agente.
4. Revisa los términos de servicio de WhatsApp --- La mensajería automatizada puede infringir los Términos de Servicio de WhatsApp. La Business API es la vía oficialmente soportada para la automatización.
5. Informa a los destinatarios --- Haz saber a las personas que pueden estar interactuando con un agente de IA.

Alternativa de la WhatsApp Business API

Para un uso empresarial legítimo, considera la WhatsApp Business API oficial en lugar de Wacli. Es más fiable, está oficialmente soportada y está diseñada para la mensajería automatizada. Sin embargo, requiere verificación de la empresa y tiene costes por mensaje.

Para la comunicación basada en correo electrónico que evita por completo estas preocupaciones de privacidad, Inbounter ofrece una API limpia para enviar correos transaccionales y de marketing sin las complejidades de las plataformas de mensajería para consumidores.

Casos de uso reales

Recordatorios de citas

Una pequeña clínica usa la skill de WhatsApp para enviar recordatorios de citas a los pacientes. El agente revisa la agenda del día siguiente, compone mensajes personalizados y los envía en un momento apropiado. Para los pacientes que prefieren el correo, el mismo agente usa Inbounter para enviar recordatorios por correo electrónico.

Notificaciones de pedidos

Un vendedor de comercio electrónico envía confirmaciones de pedidos y actualizaciones de envío por WhatsApp. Cuando cambia el estado de un pedido, el agente compone un mensaje con los detalles de seguimiento y lo envía al número de WhatsApp del cliente.

Coordinación de equipo

Un jefe de proyecto usa la skill para enviar resúmenes diarios de standup a un grupo de WhatsApp. El agente compila las actualizaciones de estado de varias herramientas y publica cada mañana un resumen con formato.

Seguimiento de clientes

Un profesional de ventas usa la skill para buscar en conversaciones pasadas de WhatsApp con clientes potenciales, identificar oportunidades de seguimiento y enviar mensajes personalizados que hacen referencia a discusiones anteriores.

Ventajas y desventajas

Ventajas

• Alcance masivo --- Acceso a la base de más de 2.000 millones de usuarios de WhatsApp
• Búsqueda en conversaciones --- Potente búsqueda en el historial de todos los chats
• Interacción natural --- Los mensajes aparecen como mensajes normales de WhatsApp
• Soporte multimedia --- Envía imágenes, documentos y texto con formato
• Sin configuración previa del destinatario --- A diferencia de los bots de Telegram, los destinatarios no necesitan iniciar primero una conversación

Desventajas

• Riesgos de privacidad --- Acceso completo a tu cuenta de WhatsApp
• Fragilidad de la sesión --- Las sesiones pueden caducar, requiriendo volver a escanear el QR
• Preocupaciones sobre los términos de servicio --- La mensajería automatizada puede infringir los Términos de Servicio de WhatsApp
• Sin API oficial --- Wacli es una herramienta de terceros, no soportada oficialmente por Meta
• Una sola cuenta --- Vinculada a un único número de teléfono a la vez
• Límites de tasa --- WhatsApp limita agresivamente los mensajes con apariencia automatizada y puede bloquear números

Veredicto y valoración

Valoración: 3,5 / 5

La integración de OpenClaw con WhatsApp mediante Wacli es una herramienta capaz pero arriesgada. La capacidad de enviar mensajes a través de WhatsApp y buscar en el historial de conversaciones es genuinamente útil, y el proceso de instalación es sencillo. Sin embargo, las implicaciones de privacidad, las preocupaciones sobre los Términos de Servicio y la fragilidad de la sesión la hacen menos fiable que la integración con Telegram para uso en producción.

Para automatización personal o uso a pequeña escala con un número de teléfono dedicado, funciona bien. Para comunicaciones empresariales a escala, te conviene más la WhatsApp Business API oficial o canales alternativos como la API de correo y SMS de Inbounter, que ofrece comunicación fiable y oficialmente soportada sin los riesgos asociados a los apaños sobre plataformas de mensajería para consumidores.

Alternativas

• WhatsApp Business API --- Oficial y soportada, pero requiere verificación de la empresa y tiene costes por mensaje
• Inbounter Email & SMS API --- Para comunicación profesional por correo o SMS sin las restricciones de WhatsApp
• Integración de OpenClaw con Telegram --- Infraestructura de bots más fiable con soporte de API oficial
• Twilio WhatsApp --- Proveedor de la WhatsApp Business API en alianza oficial

Preguntas frecuentes

P: ¿Usar Wacli hará que bloqueen mi número de WhatsApp? R: Existe un riesgo. WhatsApp detecta y bloquea activamente los números que envían mensajes automatizados a escala. Usar un número dedicado, limitar el volumen de mensajes y añadir retardos entre mensajes reduce este riesgo, pero no lo elimina.

P: ¿Puedo usar esto con WhatsApp Business? R: Wacli funciona tanto con la app de WhatsApp normal como con la de WhatsApp Business. Sin embargo, para una verdadera automatización empresarial, la WhatsApp Business API oficial es la vía recomendada.

P: ¿Qué fiabilidad tiene la sesión de Wacli? R: Las sesiones suelen durar entre 7 y 14 días antes de requerir una nueva autenticación. Los reinicios del teléfono, las actualizaciones de WhatsApp o la conexión desde un nuevo dispositivo también pueden invalidar la sesión.

P: ¿Puede el agente recibir y responder mensajes automáticamente? R: Sí, cuando se configura en modo de monitorización. El agente puede vigilar los mensajes entrantes y responder según las reglas que hayas configurado. Sin embargo, sé cauteloso con las respuestas automáticas para no parecer spam.

P: ¿Hay una opción mejor para la mensajería transaccional? R: Para mensajes transaccionales como confirmaciones de pedidos, restablecimientos de contraseña o recordatorios de citas, Inbounter ofrece una solución más fiable y oficialmente soportada mediante correo electrónico y SMS, sin los riesgos de la automatización sobre plataformas de mensajería para consumidores.

Lee más reseñas de skills de OpenClaw: Integración con Telegram, Google Workspace (gogcli) y Discord Bot.