Grupos de difusión

Descripción general

Los grupos de difusión ejecutan varios agentes con el mismo mensaje entrante. Cada agente procesa el mensaje en su propia sesión aislada y publica su propia respuesta, por lo que un número de WhatsApp puede alojar un equipo de agentes especializados en un único chat grupal o mensaje directo.

Los grupos de difusión se evalúan después de las listas de permitidos del canal y las reglas de activación del grupo. En los grupos de WhatsApp, las difusiones se producen cuando OpenClaw respondería normalmente (por ejemplo, al recibir una mención, según la configuración del grupo). Solo cambian qué agentes se ejecutan, nunca si un mensaje cumple los requisitos para procesarse.

La vía activa de control de calidad de WhatsApp incluye whatsapp-broadcast-group-fanout, que verifica que un mensaje grupal con una mención pueda generar respuestas visibles distintas de dos agentes configurados.

Configuración

Configuración básica

Añada una sección broadcast de nivel superior (junto a bindings). Las claves son identificadores de pares de WhatsApp y los valores son matrices de identificadores de agentes:

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

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

Resultado: cuando OpenClaw respondería en este chat, ejecuta los tres agentes.

Cada identificador de agente enumerado debe existir en agents.list: la validación de la configuración informa de los identificadores desconocidos y el entorno de ejecución los omite con una advertencia Broadcast agent <id> not found in agents.list; skipping.

Estrategia de procesamiento

broadcast.strategy establece cómo procesan los agentes el mensaje:

{  "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 sesiones

Cada agente de 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 conversaciones (un agente no ve las respuestas de los demás agentes)
• Espacio de trabajo (entornos aislados separados, si se configuran)
• Acceso a herramientas (listas de permitidos y denegados distintas)
• Memoria/contexto (IDENTITY.md, SOUL.md, etc., separados)

Hay una excepción compartida de forma intencionada: el 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. Se borra una vez finalizada la distribución.

Esto permite que cada agente tenga diferentes personalidades, modelos, Skills y acceso a herramientas (por ejemplo, solo lectura frente a lectura y escritura).

Ejemplo: sesiones aisladas

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

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

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

Casos de uso

• Equipos de agentes especializados: un grupo de desarrollo donde code-reviewer, security-auditor, test-generator y docs-checker responden al mismo mensaje, cada uno desde su propia perspectiva.
• Asistencia multilingüe: un único chat de asistencia con support-en, support-de y support-es respondiendo en sus respectivos idiomas.
• Control de calidad: support-agent responde mientras qa-agent revisa y solo responde cuando encuentra problemas.
• Automatización de tareas: task-tracker, time-logger y report-generator consumen la misma actualización de estado.

Prácticas recomendadas

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

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

Compatibilidad

Proveedores

Actualmente, los grupos de difusión solo están implementados para WhatsApp (canal web). Los demás canales ignoran la configuración broadcast.

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

openclaw logs --follow | grep -i 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 la API

Esquema de configuración

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

Campos

Limitaciones

1. Número máximo de agentes: no hay un límite estricto, pero una gran cantidad de agentes (10 o más) puede ralentizar el procesamiento.
2. Contexto compartido: los agentes no ven las respuestas de los demás (por diseño).
3. Orden de los mensajes: las respuestas en paralelo pueden llegar en cualquier orden.
4. Límites de frecuencia: todas las respuestas proceden de una única cuenta de WhatsApp, por lo que la respuesta de cada agente cuenta para los mismos límites de frecuencia de WhatsApp.

Contenido relacionado

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