Grupos de difusión

Descripción general

Los Grupos de difusión permiten que varios agentes procesen y respondan al mismo mensaje simultáneamente. Esto te permite crear equipos de agentes especializados que trabajan juntos en un único grupo o DM de WhatsApp, todo usando un solo número de teléfono.

Alcance actual: solo WhatsApp (canal web).

Los grupos de difusión se evalúan después de las listas de permitidos del canal y las reglas de activación de grupos. En grupos de WhatsApp, esto significa que las difusiones ocurren cuando OpenClaw normalmente respondería (por ejemplo: al mencionarlo, según la configuración de tu grupo).

La vía de QA en vivo de WhatsApp incluye whatsapp-broadcast-group-fanout, que verifica que un mensaje de grupo con mención pueda producir respuestas visibles distintas de dos agentes configurados.

Casos de uso

Group: "Development Team"Agents:  - CodeReviewer (reviews code snippets)  - DocumentationBot (generates docs)  - SecurityAuditor (checks for vulnerabilities)  - TestGenerator (suggests test cases)

Group: "International Support"Agents:  - Agent_EN (responds in English)  - Agent_DE (responds in German)  - Agent_ES (responds in Spanish)

Group: "Customer Support"Agents:  - SupportAgent (provides answer)  - QAAgent (reviews quality, only responds if issues found)

Group: "Project Management"Agents:  - TaskTracker (updates task database)  - TimeLogger (logs time spent)  - ReportGenerator (creates summaries)

Configuración

Configuración básica

Añade una sección broadcast de nivel superior (junto a bindings). Las claves son ids de pares de WhatsApp:

• chats de grupo: JID de grupo (por ejemplo, 120363403215116621@g.us)
• DM: número de teléfono E.164 (por ejemplo, +15551234567)

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

Resultado: Cuando OpenClaw respondería en este chat, ejecutará los tres agentes.

Estrategia de procesamiento

Controla cómo los agentes procesan los mensajes:

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

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

Ejemplo completo

{  "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"]  }}

Cómo funciona

Flujo de mensajes

Aislamiento de sesión

Cada agente en un grupo de difusión mantiene completamente separados:

• Claves de sesión (agent:alfred:whatsapp:group:120363... frente a agent:baerbel:whatsapp:group:120363...)
• Historial de conversación (el agente no ve los mensajes de otros agentes)
• Workspace (sandboxes separados si están configurados)
• Acceso a herramientas (listas de permitir/denegar diferentes)
• Memoria/contexto (IDENTITY.md, SOUL.md, etc. separados)
• Búfer de contexto del grupo (mensajes recientes del grupo usados como contexto) se comparte por par, por lo que todos los agentes de difusión ven el mismo contexto cuando se activan

Esto permite que cada agente tenga:

• Personalidades diferentes
• Acceso a herramientas diferente (por ejemplo, solo lectura frente a lectura-escritura)
• Modelos diferentes (por ejemplo, opus frente a sonnet)
• Skills diferentes instaladas

Ejemplo: sesiones aisladas

En el grupo 120363403215116621@g.us con agentes ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: /Users/user/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: /Users/user/openclaw-baerbel/Tools: read only

Mejores prácticas

{  "broadcast": {    "DEV_GROUP": ["formatter", "linter", "tester"]  }}

{  "agents": {    "security-scanner": { "name": "Security Scanner" },    "code-formatter": { "name": "Code Formatter" },    "test-generator": { "name": "Test Generator" }  }}

{  "agents": {    "reviewer": {      "tools": { "allow": ["read", "exec"] }    },    "fixer": {      "tools": { "allow": ["read", "write", "edit", "exec"] }    }  }}

Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]Result: Agent A and C respond, Agent B logs error

Compatibilidad

Proveedores

Actualmente los grupos de difusión funcionan con:

• ✅ WhatsApp (implementado)
• 🚧 Telegram (planificado)
• 🚧 Discord (planificado)
• 🚧 Slack (planificado)

Enrutamiento

Los grupos de difusión funcionan junto con el enrutamiento existente:

{  "bindings": [    {      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },      "agentId": "alfred"    }  ],  "broadcast": {    "GROUP_B": ["agent1", "agent2"]  }}

• GROUP_A: Solo responde alfred (enrutamiento normal).
• GROUP_B: responden agent1 Y agent2 (difusión).

Solución de problemas

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

Ejemplos

{  "broadcast": {    "strategy": "parallel",    "120363403215116621@g.us": [      "code-formatter",      "security-scanner",      "test-coverage",      "docs-checker"    ]  },  "agents": {    "list": [      {        "id": "code-formatter",        "workspace": "~/agents/formatter",        "tools": { "allow": ["read", "write"] }      },      {        "id": "security-scanner",        "workspace": "~/agents/security",        "tools": { "allow": ["read", "exec"] }      },      {        "id": "test-coverage",        "workspace": "~/agents/testing",        "tools": { "allow": ["read", "exec"] }      },      { "id": "docs-checker", "workspace": "~/agents/docs", "tools": { "allow": ["read"] } }    ]  }}

{  "broadcast": {    "strategy": "sequential",    "+15555550123": ["detect-language", "translator-en", "translator-de"]  },  "agents": {    "list": [      { "id": "detect-language", "workspace": "~/agents/lang-detect" },      { "id": "translator-en", "workspace": "~/agents/translate-en" },      { "id": "translator-de", "workspace": "~/agents/translate-de" }    ]  }}

Referencia de API

Esquema de configuración

interface OpenClawConfig {  broadcast?: {    strategy?: "parallel" | "sequential";    [peerId: string]: string[];  };}

Campos

Limitaciones

1. Máximo de agentes: No hay un límite estricto, pero 10+ agentes pueden ser lentos.
2. Contexto compartido: Los agentes no ven las respuestas de los demás (por diseño).
3. Orden de mensajes: Las respuestas paralelas pueden llegar en cualquier orden.
4. Límites de tasa: Todos los agentes cuentan para los límites de tasa de WhatsApp.

Mejoras futuras

Funcionalidades planificadas:

• [ ] Modo de contexto compartido (los agentes ven las respuestas de los demás)
• [ ] Coordinación de agentes (los agentes pueden enviarse señales entre sí)
• [ ] Selección dinámica de agentes (elegir agentes según el contenido del mensaje)
• [ ] Prioridades de agentes (algunos agentes responden antes que otros)

Relacionado

• Enrutamiento de canales
• Grupos
• Herramientas de sandbox multiagente
• Emparejamiento
• Gestión de sesiones