​

WhatsApp (canal web)

​

Instalación (bajo demanda)

• La incorporación (openclaw onboard) y openclaw channels add --channel whatsapp solicitan instalar el plugin de WhatsApp la primera vez que lo seleccionas.
• openclaw channels login --channel whatsapp también ofrece el flujo de instalación cuando el plugin aún no está presente.
• Canal de desarrollo + checkout de git: usa de forma predeterminada la ruta local del plugin.
• Stable/Beta: usa de forma predeterminada el paquete npm @openclaw/whatsapp.

openclaw plugins install @openclaw/whatsapp

​

Configuración rápida

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login --channel whatsapp

openclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

Patrones de implementación

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

​

Modelo de tiempo de ejecución

• Gateway posee el socket de WhatsApp y el bucle de reconexión.
• Los envíos salientes requieren un listener activo de WhatsApp para la cuenta de destino.
• Los chats de estado y difusión se ignoran (@status, @broadcast).
• Los chats directos usan reglas de sesión de mensajes directos (session.dmScope; el valor predeterminado main colapsa los mensajes directos en la sesión principal del agente).
• Las sesiones de grupo están aisladas (agent:<agentId>:whatsapp:group:<jid>).
• El transporte de WhatsApp Web respeta las variables de entorno de proxy estándar en el host de Gateway (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / variantes en minúsculas). Prefiere la configuración de proxy a nivel de host en lugar de ajustes de proxy de WhatsApp específicos del canal.

​

Control de acceso y activación

​

Comportamiento de número personal y chat propio

• omitir confirmaciones de lectura para turnos de chat propio
• ignorar el comportamiento de activación automática por mention-JID que de otro modo te mencionaría a ti mismo
• si messages.responsePrefix no está definido, las respuestas de chat propio usan de forma predeterminada [{identity.name}] o [openclaw]

​

Normalización de mensajes y contexto

[Respondiendo a <sender> id:<stanzaId>]
<cuerpo citado o marcador de posición de multimedia>
[/Respondiendo]

{
  channels: {
    whatsapp: {
      sendReadReceipts: false,
    },
  },
}

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

​

Entrega, fragmentación y multimedia

​

Nivel de reacciones

{
  channels: {
    whatsapp: {
      reactionLevel: "ack",
    },
  },
}

​

Reacciones de acuse

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

• se envían inmediatamente después de que se acepta la entrada (antes de la respuesta)
• los fallos se registran, pero no bloquean la entrega normal de respuestas
• el modo de grupo mentions reacciona en turnos activados por mención; la activación de grupo always actúa como omisión de esta comprobación
• WhatsApp usa channels.whatsapp.ackReaction (aquí no se usa el heredado messages.ackReaction)

​

Varias cuentas y credenciales

​

Herramientas, acciones y escrituras de configuración

• La compatibilidad de herramientas del agente incluye la acción de reacción de WhatsApp (react).
• Restricciones de acciones:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Las escrituras de configuración iniciadas por el canal están habilitadas de forma predeterminada (desactívalas mediante channels.whatsapp.configWrites=false).

​

Solución de problemas

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

Punteros de referencia de configuración

• Referencia de configuración - WhatsApp

• acceso: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• entrega: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• varias cuentas: accounts.<id>.enabled, accounts.<id>.authDir, anulaciones a nivel de cuenta
• operaciones: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*
• comportamiento de sesión: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

Relacionado

• Vinculación
• Grupos
• Seguridad
• Enrutamiento de canales
• Enrutamiento de varios agentes
• Solución de problemas