OpenClaw con WhatsApp: Configura tu Asistente de IA Personal

OpenClaw usa Baileys para conectarse a WhatsApp — una librería JavaScript que implementa el protocolo de WhatsApp Web.

Implicaciones:

• Necesitas vincular un número de teléfono real
• WhatsApp puede detectar y banear números con comportamiento automatizado inusual
• Para uso personal y moderado, el riesgo es bajo. Para volúmenes altos, considera WhatsApp Business API oficial

Prerrequisito: OpenClaw instalado y Gateway corriendo. Si no, empieza aquí: Cómo Instalar OpenClaw

El primer paso es autenticar tu número:

openclaw channels login

Este comando muestra un código QR en la terminal. Escanéalo desde WhatsApp en tu teléfono: Ajustes → Dispositivos vinculados → Vincular un dispositivo.

Las credenciales se guardan cifradas en ~/.openclaw/credentials.

Luego edita ~/.openclaw/openclaw.json:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "channels": {
    "whatsapp": {
      "allowFrom": ["+34600000001", "+34600000002"],
      "dmPolicy": "pairing"
    }
  }
}

CampoDescripciónValor por defecto allowFromLista de números autorizados. Usa ["*"] para todos[] dmPolicy``"pairing" (requiere verificación) o "open"``"pairing" groupsLista de grupos autorizadosnull

El allowFrom es tu lista de números autorizados con formato internacional:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+34600123456", "+521234567890", "+50370000000"]
    }
  }
}

Advertencia de seguridad: Abrir el asistente a cualquier número con "*" significa que cualquiera que obtenga tu número puede interactuar con tu IA.

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+34600123456"],
      "groups": {
        "1234567890-1234567890@g.us": {
          "requireMention": true
        }
      }
    }
  }
}

requireMention: true significa que el asistente solo responde cuando alguien lo menciona en el grupo.

Respuesta automática fuera de horario: Configura el asistente para manejar mensajes cuando no estás disponible.

Resúmenes de grupos: Pídele resúmenes del historial de conversación.

Búsqueda en base de conocimiento: Combinado con skills de búsqueda, el asistente puede consultar documentos o bases de datos.

OpenClaw puede procesar:

• Imágenes: El modelo analiza la imagen si soporta visión (Claude Opus, GPT-4o)
• Audio: Transcripción via hooks configurables
• Video: Soporte limitado, depende del modelo
• Documentos (PDF, etc.): El modelo puede leer el contenido si está configurado

No llegan mensajes al Gateway: Verifica que el número está en allowFrom y que el Gateway está corriendo.

El QR code expiró: Corre openclaw channels login de nuevo.

WhatsApp desvinculó el dispositivo: Re-autentifica con openclaw channels login.

El asistente no responde en grupos: Verifica el ID del grupo en la configuración groups.