Uitzendgroepen

Overzicht

Broadcastgroepen voeren meerdere agents uit voor hetzelfde inkomende bericht. Elke agent verwerkt het bericht in een eigen geïsoleerde sessie en plaatst een eigen antwoord, zodat één WhatsApp-nummer in één groepschat of privébericht een team van gespecialiseerde agents kan huisvesten.

Broadcastgroepen worden geëvalueerd na de toestemmingslijsten van het kanaal en de activeringsregels voor groepen. In WhatsApp-groepen vinden broadcasts plaats wanneer OpenClaw normaal gesproken zou antwoorden (bijvoorbeeld bij een vermelding, afhankelijk van je groepsinstellingen). Ze veranderen alleen welke agents worden uitgevoerd, nooit of een bericht voor verwerking in aanmerking komt.

De live WhatsApp-QA-lane bevat whatsapp-broadcast-group-fanout, waarmee wordt gecontroleerd of één groepsbericht met een vermelding afzonderlijke zichtbare antwoorden van twee geconfigureerde agents kan opleveren.

Configuratie

Basisconfiguratie

Voeg een broadcast-sectie op het hoogste niveau toe (naast bindings). De sleutels zijn WhatsApp-peer-id's en de waarden zijn arrays met agent-id's:

• groepschats: groeps-JID (bijvoorbeeld 120363403215116621@g.us)
• privéberichten: E.164-telefoonnummer van de afzender (bijvoorbeeld +15551234567)

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

Resultaat: wanneer OpenClaw in deze chat zou antwoorden, worden alle drie de agents uitgevoerd.

Elke vermelde agent-id moet bestaan in agents.list: configuratievalidatie meldt onbekende id's en de runtime slaat deze over met de waarschuwing Broadcast agent <id> not found in agents.list; skipping.

Verwerkingsstrategie

broadcast.strategy bepaalt hoe agents het bericht verwerken:

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

Volledig voorbeeld

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

Werking

Berichtstroom

Sessie-isolatie

Elke agent in een broadcastgroep onderhoudt volledig afzonderlijke:

• Sessiesleutels (agent:alfred:whatsapp:group:120363... tegenover agent:baerbel:whatsapp:group:120363...)
• Gespreksgeschiedenis (een agent ziet de antwoorden van andere agents niet)
• Werkruimte (afzonderlijke sandboxes, indien geconfigureerd)
• Toegang tot tools (verschillende lijsten voor toestaan/weigeren)
• Geheugen/context (afzonderlijke IDENTITY.md, SOUL.md, enzovoort)

Eén uitzondering wordt bewust gedeeld: de groepscontextbuffer (recente groepsberichten die als context worden gebruikt) wordt per peer gedeeld, zodat alle broadcastagents bij activering dezelfde context zien. Deze buffer wordt eenmaal gewist nadat de fan-out is voltooid.

Hierdoor kan elke agent een andere persoonlijkheid, andere modellen, andere Skills en andere toegang tot tools hebben (bijvoorbeeld alleen-lezen tegenover lezen en schrijven).

Voorbeeld: geïsoleerde sessies

In groep 120363403215116621@g.us met agents ["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

Gebruiksscenario's

• Gespecialiseerde agentteams: een ontwikkelaarsgroep waarin code-reviewer, security-auditor, test-generator en docs-checker hetzelfde bericht elk vanuit hun eigen invalshoek beantwoorden.
• Meertalige ondersteuning: één ondersteuningschat waarin support-en, support-de en support-es in hun eigen taal antwoorden.
• Kwaliteitsborging: support-agent antwoordt terwijl qa-agent het antwoord beoordeelt en alleen reageert als er problemen worden gevonden.
• Taakautomatisering: task-tracker, time-logger en report-generator verwerken allemaal dezelfde statusupdate.

Aanbevolen werkwijzen

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

Compatibiliteit

Providers

Broadcastgroepen zijn momenteel alleen geïmplementeerd voor WhatsApp (webkanaal). Andere kanalen negeren de broadcast-configuratie.

Routering

Broadcastgroepen werken naast de bestaande routering:

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

• GROUP_A: alleen alfred antwoordt (normale routering).
• GROUP_B: agent1 EN agent2 antwoorden (broadcast).

Probleemoplossing

openclaw logs --follow | grep -i broadcast

Voorbeelden

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

API-referentie

Configuratieschema

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

Velden

Beperkingen

1. Maximumaantal agents: er is geen harde limiet, maar veel agents (10+) kunnen traag zijn.
2. Gedeelde context: agents zien elkaars antwoorden niet (bewust ontwerp).
3. Berichtvolgorde: parallelle antwoorden kunnen in elke volgorde aankomen.
4. Snelheidslimieten: alle antwoorden komen van één WhatsApp-account, dus het antwoord van elke agent telt mee voor dezelfde WhatsApp-snelheidslimieten.

Gerelateerd

• Kanaalroutering
• Groepen
• Sandboxhulpmiddelen voor meerdere agents
• Koppeling
• Sessiebeheer