Configura mensajes grupales en WhatsApp con OpenClaw

¿Alguna vez has intentado meter un agente en un grupo de WhatsApp y ha terminado siendo un desastre? Es frustrante cuando los bots responden a cada mensaje sin sentido o mezclan el contexto de tus chats privados con la conversación grupal. Necesitas que el agente sepa exactamente cuándo intervenir y quién le está hablando sin romper el flujo del grupo.

La mejor forma de gestionar esto es mediante un sistema de activación por menciones y sesiones aisladas. Así, tu agente solo se despierta cuando lo necesitas y mantiene un hilo de conversación totalmente separado para cada grupo.

Requisitos previos

• Una cuenta de WhatsApp conectada a OpenClaw.
• Acceso al archivo de configuración ~/.openclaw/openclaw.json.
• Permisos para añadir la cuenta de OpenClaw a grupos de WhatsApp.

Inicio rápido

Sigue estos pasos para activar tu agente en un grupo en menos de 5 minutos:

1. Configura el archivo JSON

Añade un bloque groupChat y define los parámetros de whatsapp en tu archivo ~/.openclaw/openclaw.json. Esto permite que el agente reconozca menciones aunque WhatsApp no incluya el símbolo @ en el texto plano:

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          historyLimit: 50,
          mentionPatterns: ["@?openclaw", "\\+?15555550123"],
        },
      },
    ],
  },
}

2. Añade el agente al grupo

Agrega la cuenta de WhatsApp que corre OpenClaw al grupo que quieras gestionar. Por defecto, el groupPolicy está en allowlist, por lo que solo los remitentes autorizados podrán activar al agente a menos que cambies la política a open.

3. Activa al agente

Escribe @openclaw seguido de tu mensaje. El agente recibirá el contexto de los últimos mensajes (hasta 50 por defecto) para entender de qué va la charla antes de responder. Verás que cada mensaje incluye un marcador [from: Nombre (+E164)] para que el agente sepa quién es quién.

4. Cambia el modo de respuesta

Si eres el dueño de la cuenta, puedes enviar comandos directamente en el grupo para cambiar cómo reacciona el agente:

• /activation mention: Solo responde cuando lo mencionan (modo por defecto).
• /activation always: Lee todo y decide si aporta algo útil o se queda en silencio.

Solución de problemas

• El agente no responde en el grupo: Revisa channels.whatsapp.groupPolicy. Si está en allowlist, asegúrate de añadir los números permitidos en channels.whatsapp.groupAllowFrom.
• Las menciones no funcionan: Verifica que los regex en mentionPatterns coincidan con el nombre de usuario o el número E.164 del bot.
• Comandos ignorados: Los comandos como /activation, /verbose o /reset deben enviarse como mensajes independientes (sin texto adicional) para que el Gateway los procese correctamente.
• Dudas sobre el estado actual: Envía /status en el grupo para confirmar el modo de activación configurado.

Para resolver dudas específicas sobre tu configuración, consulta al AI Setup Assistant.

Próximos pasos

• Configuración avanzada de agentes
• Gestión de sesiones y memoria
• Uso de comandos CLI
• Filtros de contenido y seguridad