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 DM een team van gespecialiseerde agents kan huisvesten.

Broadcastgroepen worden geëvalueerd na kanaaltoelatingslijsten en groepsactiveringsregels. 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). Sleutels zijn WhatsApp-peer-id's, waarden zijn arrays met agent-id's:

• groepschats: groeps-JID (bijv. 120363403215116621@g.us)
• DM's: E.164-telefoonnummer van de afzender (bijv. +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.entries: configuratievalidatie meldt onbekende id's en de runtime slaat deze over met een Broadcast agent <id> not found in agents.entries; skipping-waarschuwing.

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

Hoe het werkt

Berichtenstroom

Sessie-isolatie

Elke agent in een broadcastgroep houdt het volgende volledig gescheiden:

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

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 wordt eenmaal gewist nadat de fan-out is voltooid.

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

Voorbeeld: geïsoleerde sessies

In groep 120363403215116621@g.us met agents ["alfred", "baerbel"]:

Sessie: agent:alfred:whatsapp:group:120363403215116621@g.usGeschiedenis: [gebruikersbericht, eerdere antwoorden van alfred]Werkruimte: ~/openclaw-alfred/Tools: lezen, schrijven, uitvoeren

Sessie: agent:baerbel:whatsapp:group:120363403215116621@g.usGeschiedenis: [gebruikersbericht, eerdere antwoorden van baerbel]Werkruimte: ~/openclaw-baerbel/Tools: alleen-lezen

Gebruiksscenario's

• Gespecialiseerde agentteams: een ontwikkelgroep waarin code-reviewer, security-auditor, test-generator en docs-checker elk vanuit hun eigen invalshoek op hetzelfde bericht antwoorden.
• Meertalige ondersteuning: één supportchat waarin support-en, support-de en support-es in hun eigen taal antwoorden.
• Kwaliteitsborging: support-agent antwoordt terwijl qa-agent controleert en alleen reageert wanneer 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: geen harde limiet, maar veel agents (10+) kunnen traag zijn.
2. Gedeelde context: agents zien elkaars antwoorden niet (bewust zo ontworpen).
3. Berichtvolgorde: parallelle antwoorden kunnen in elke volgorde binnenkomen.
4. Frequentielimieten: alle antwoorden komen van één WhatsApp-account, dus het antwoord van elke agent telt mee voor dezelfde WhatsApp-frequentielimieten.

Gerelateerd

• Kanaalroutering
• Groepen
• Sandboxtools voor meerdere agents
• Koppelen
• Sessiebeheer