Grupos de transmissão

Visão geral

Os grupos de transmissão executam vários agentes para a mesma mensagem recebida. Cada agente processa a mensagem em sua própria sessão isolada e publica sua própria resposta, permitindo que um número do WhatsApp hospede uma equipe de agentes especializados em um único chat em grupo ou mensagem direta.

Os grupos de transmissão são avaliados após as listas de permissões do canal e as regras de ativação de grupos. Nos grupos do WhatsApp, as transmissões ocorrem quando o OpenClaw normalmente responderia (por exemplo, ao ser mencionado, dependendo das configurações do grupo). Elas alteram apenas quais agentes são executados, nunca se uma mensagem está qualificada para processamento.

A rotina ativa de controle de qualidade do WhatsApp inclui whatsapp-broadcast-group-fanout, que verifica se uma mensagem de grupo com uma menção pode gerar respostas visíveis distintas de dois agentes configurados.

Configuração

Configuração básica

Adicione uma seção broadcast de nível superior (ao lado de bindings). As chaves são IDs de pares do WhatsApp e os valores são matrizes de IDs de agentes:

• chats em grupo: JID do grupo (por exemplo, 120363403215116621@g.us)
• mensagens diretas: número de telefone E.164 do remetente (por exemplo, +15551234567)

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

Resultado: quando o OpenClaw responderia neste chat, ele executa os três agentes.

Cada ID de agente listado deve existir em agents.list: a validação da configuração informa IDs desconhecidos, e o ambiente de execução os ignora com um aviso Broadcast agent <id> not found in agents.list; skipping.

Estratégia de processamento

broadcast.strategy define como os agentes processam a mensagem:

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

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

Como funciona

Fluxo de mensagens

Isolamento de sessões

Cada agente em um grupo de transmissão mantém totalmente separados:

• Chaves de sessão (agent:alfred:whatsapp:group:120363... em comparação com agent:baerbel:whatsapp:group:120363...)
• Histórico da conversa (um agente não vê as respostas dos outros agentes)
• Espaço de trabalho (sandboxes separados, se configurados)
• Acesso a ferramentas (listas distintas de permissões e bloqueios)
• Memória/contexto (IDENTITY.md, SOUL.md etc. separados)

Uma exceção é compartilhada intencionalmente: o buffer de contexto do grupo (mensagens recentes do grupo usadas como contexto) é compartilhado por par, portanto todos os agentes da transmissão veem o mesmo contexto quando são acionados. Ele é limpo uma vez após a conclusão da distribuição.

Isso permite que cada agente tenha diferentes personalidades, modelos, Skills e acessos a ferramentas (por exemplo, somente leitura em comparação com leitura e gravação).

Exemplo: sessões isoladas

No grupo 120363403215116621@g.us com os 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

• Equipes de agentes especializados: um grupo de desenvolvimento em que code-reviewer, security-auditor, test-generator e docs-checker respondem à mesma mensagem, cada um sob sua própria perspectiva.
• Suporte multilíngue: um único chat de suporte com support-en, support-de e support-es respondendo em seus respectivos idiomas.
• Controle de qualidade: support-agent responde enquanto qa-agent revisa e só responde quando encontra problemas.
• Automação de tarefas: task-tracker, time-logger e report-generator processam a mesma atualização de status.

Práticas 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"] } }    ]  }}

Compatibilidade

Provedores

Atualmente, os grupos de transmissão são implementados somente para o WhatsApp (canal web). Outros canais ignoram a configuração broadcast.

Roteamento

Os grupos de transmissão funcionam em conjunto com o roteamento existente:

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

• GROUP_A: somente alfred responde (roteamento normal).
• GROUP_B: agent1 E agent2 respondem (transmissão).

Solução de problemas

openclaw logs --follow | grep -i broadcast

Exemplos

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

Referência da API

Esquema de configuração

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

Campos

Limitações

1. Máximo de agentes: não há limite rígido, mas muitos agentes (10 ou mais) podem causar lentidão.
2. Contexto compartilhado: os agentes não veem as respostas uns dos outros (por definição).
3. Ordem das mensagens: as respostas em paralelo podem chegar em qualquer ordem.
4. Limites de taxa: todas as respostas vêm de uma única conta do WhatsApp, portanto a resposta de cada agente conta para os mesmos limites de taxa do WhatsApp.

Conteúdo relacionado

• Roteamento de canais
• Grupos
• Ferramentas de sandbox multiagente
• Pareamento
• Gerenciamento de sessões