Cómo permitir que varios números de WhatsApp usen tu bot en OpenClaw (whitelist / allowlist)

openclaw whatsapp

Si ya tenés OpenClaw funcionando con WhatsApp, probablemente estés en esta situación de tener un solo número conectado al gateway (el que escaneó el QR / hizo pairing), pero querés que varias personas (distintos números) puedan escribirle al bot y usarlo.

La clave es entender esto:

No necesitás conectar varios WhatsApp al bot.
OpenClaw normalmente trabaja con 1 cuenta WhatsApp conectada (la del bot) y luego vos definís qué números están autorizados a interactuar con él mediante políticas como pairing y allowlist (whitelist).

Concepto base: 1 “número bot” vs varios “números usuarios”

  • Número bot: es el WhatsApp que queda logueado en OpenClaw (por QR/pairing).
  • Números usuarios: son personas habilitadas a escribirle al bot (DM) y/o mencionarlo en grupos.

OpenClaw te deja controlar quién puede hablarle con dos ideas:

  • dmPolicy: controla mensajes privados (DM).
  • groupPolicy: controla mensajes en grupos.

Opción recomendada: Whitelist fija (allowlist)

Si tu objetivo es simple y seguro (solo X números pueden usarlo), lo mejor es usar allowlist.

Configuración típica

En tu openclaw.json, cambiá dmPolicy a «allowlist» y agregá la lista de números habilitados en allowFrom.

Si también querés permitir uso en grupos, mantené groupPolicy: «allowlist» y agregá groupAllowFrom.

"whatsapp": {
"enabled": true,

"dmPolicy": "allowlist",
"allowFrom": [
"+5493811111111",
"+5493812222222",
"+5493813333333"
],

"selfChatMode": false,

"groupPolicy": "allowlist",
"groupAllowFrom": [
"+5493811111111",
"+5493812222222",
"+5493813333333"
],

"debounceMs": 0,
"mediaMaxMb": 50
}

Con esto:

  • En DM, solo esos números pueden hablarle.
  • En grupos, solo esos números pueden interactuar con el bot (según cómo esté implementado el routing de grupos en tu versión).

Opción “flexible”: mantener pairing y además una whitelist

Si querés seguir usando dmPolicy: «pairing» (para aprobar contactos nuevos a demanda), pero también querés “preautorizar” algunos números, podés combinarlo:

"whatsapp": {
  "enabled": true,

  "dmPolicy": "pairing",
  "allowFrom": [
    "+5493811111111",
    "+5493812222222"
  ],

  "selfChatMode": false,

  "groupPolicy": "allowlist",
  "groupAllowFrom": [
    "+5493811111111",
    "+5493812222222"
  ],

  "debounceMs": 0,
  "mediaMaxMb": 50
}

Ventaja: tenés control mixto.

  • Los que están en whitelist entran directo.
  • Los nuevos pueden pasar por “pairing/approval” (según tu flujo).

Detalles que suelen romper la configuración (y cómo evitarlos)

1. Formato del número

Usá formato internacional con + y código de país:

  • Argentina: +54 + código de área + número
  • Ejemplo Tucumán: +549381xxxxxxx

Tip: si no coincide el formato exacto con el que reporta WhatsApp, la allowlist no matchea y el bot “parece muerto”.

2. Reiniciar el servicio

Después de editar openclaw.json, necesitás reiniciar OpenClaw/gateway para que lea la config.

openclaw gateway restart

3. Grupos: ojo con la política

Si no usás grupos, directamente dejalo simple:

  • groupPolicy en «ignore» (si existe en tu versión) o deshabilitado.
  • O mantenelo, pero sabiendo que es un punto donde a veces hay cambios/bugs entre releases.
Comentarios
advertise width me