'Broadcast Groups: Cómo coordinar múltiples agentes en WhatsApp'

¿Alguna vez has intentado que un solo agente haga demasiadas cosas y termine confundido? Mantener un prompt gigante para que un bot sea experto en seguridad, código y documentación al mismo tiempo es difícil de gestionar. La complejidad crece y el rendimiento baja cuando un solo agente intenta abarcarlo todo.

La mejor solución es dividir el trabajo. Con Broadcast Groups, puedes hacer que varios agentes especializados procesen y respondan al mismo mensaje de forma simultánea. Esto te permite crear equipos de agentes que trabajan juntos en un solo grupo de WhatsApp o DM, utilizando un único número de teléfono.

Requisitos previos

• OpenClaw versión 2026.1.9 o superior.
• Una cuenta de WhatsApp configurada (canal web).
• Agentes ya definidos en tu agents.list.

Inicio rápido

Configurar un grupo de broadcast te tomará menos de 5 minutos. Solo necesitas añadir una sección broadcast en tu archivo de configuración, al mismo nivel que bindings.

Usa el JID del grupo (ej. 120363403215116621@g.us) o el número de teléfono en formato E.164 para DMs como clave:

{
  "broadcast": {
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
  }
}

Resultado: Cuando OpenClaw deba responder en ese chat, ejecutará los tres agentes al mismo tiempo.

Estrategias de procesamiento

Puedes controlar cómo los agentes manejan los mensajes mediante la propiedad strategy:

Parallel (Por defecto)

Todos los agentes procesan el mensaje simultáneamente para ahorrar tiempo.

{
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"]
  }
}

Sequential

Los agentes procesan en orden; cada uno espera a que el anterior termine.

{
  "broadcast": {
    "strategy": "sequential",
    "120363403215116621@g.us": ["alfred", "baerbel"]
  }
}

Ejemplo completo de configuración

Aquí tienes cómo se ve una configuración con varios agentes y diferentes grupos:

{
  "agents": {
    "list": [
      {
        "id": "code-reviewer",
        "name": "Code Reviewer",
        "workspace": "/path/to/code-reviewer",
        "sandbox": { "mode": "all" }
      },
      {
        "id": "security-auditor",
        "name": "Security Auditor",
        "workspace": "/path/to/security-auditor",
        "sandbox": { "mode": "all" }
      },
      {
        "id": "docs-generator",
        "name": "Documentation Generator",
        "workspace": "/path/to/docs-generator",
        "sandbox": { "mode": "all" }
      }
    ]
  },
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": ["code-reviewer", "security-auditor", "docs-generator"],
    "120363424282127706@g.us": ["support-en", "support-de"],
    "+15555550123": ["assistant", "logger"]
  }
}

Aislamiento de Sesiones

Es importante entender que cada agente en un Broadcast Group mantiene su independencia total. Esto garantiza que no haya conflictos entre sus tareas:

1. Session keys: Cada agente tiene su propia clave de sesión (ej. agent:alfred:whatsapp...).
2. Historial de conversación: Un agente no ve los mensajes de los otros agentes.
3. Workspace: Tienen sandboxes separados si así los configuraste.
4. Tool access: Puedes asignar diferentes permisos de herramientas a cada uno.

Best Practices

Para sacar el máximo provecho a tus equipos de agentes, te recomiendo seguir estas pautas:

• Mantén agentes enfocados: Diseña cada agente con una sola responsabilidad clara. Es mejor tener cuatro agentes pequeños que uno genérico.
• Usa nombres descriptivos: Asegúrate de que el name del agente explique qué hace (ej. “Security Scanner”).
• Configura diferentes niveles de acceso: Dale a cada agente solo las herramientas que necesita. Por ejemplo, un revisor solo necesita acceso de lectura, mientras que un “fixer” necesita escritura.
• Monitorea el rendimiento: Si usas muchos agentes, prefiere la estrategia parallel y usa modelos más rápidos para tareas simples.

Solución de problemas

Los agentes no responden

• Verifica que los IDs de los agentes existan en agents.list.
• Revisa que el formato del Peer ID sea correcto (ej. 120363403215116621@g.us).
• Asegúrate de que los agentes no estén en ninguna “deny list”.
• Ejecuta este comando para ver los logs en tiempo real:

  tail -f ~/.openclaw/logs/gateway.log | grep broadcast

Solo responde un agente

• Causa: Es posible que el Peer ID esté en bindings pero no en broadcast.
• Solución: Añade el ID a la configuración de broadcast o quítalo de bindings.

¿Necesitas ayuda para configurar tus agentes? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Multi-Agent Configuration
• Routing Configuration
• Session Management