Configuration

Broadcastgroepen

Status: experimental

Overzicht

Broadcastgroepen laten meerdere agents hetzelfde bericht gelijktijdig verwerken en beantwoorden. Zo kun je gespecialiseerde agentteams maken die samenwerken in één WhatsApp-groep of DM, allemaal met één telefoonnummer.

Huidige scope: alleen WhatsApp (webkanaal).

Broadcastgroepen worden geëvalueerd na kanaal-allowlists en groepsactiveringsregels. In WhatsApp-groepen betekent dit dat broadcasts plaatsvinden wanneer OpenClaw normaal gesproken zou antwoorden (bijvoorbeeld: bij een vermelding, afhankelijk van je groepsinstellingen).

Gebruiksscenario's

1. Gespecialiseerde agentteams

Implementeer meerdere agents met afgebakende, gerichte verantwoordelijkheden:

Code

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

Elke agent verwerkt hetzelfde bericht en geeft zijn gespecialiseerde perspectief.

2. Meertalige ondersteuning

Code

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

3. Workflows voor kwaliteitsborging

Code

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

4. Taakautomatisering

Code

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

Configuratie

Basisconfiguratie

Voeg een broadcast-sectie op het hoogste niveau toe (naast bindings). Sleutels zijn WhatsApp-peer-id's:

groepschats: groeps-JID (bijv. [email protected])
DM's: E.164-telefoonnummer (bijv. +15551234567)

json

{  "broadcast": {    "[email protected]": ["alfred", "baerbel", "assistant3"]  }}

Resultaat: Wanneer OpenClaw in deze chat zou antwoorden, voert het alle drie de agents uit.

Verwerkingsstrategie

Bepaal hoe agents berichten verwerken:

parallel (standaard)

Alle agents verwerken gelijktijdig:

json

{  "broadcast": {    "strategy": "parallel",    "[email protected]": ["alfred", "baerbel"]  }}

sequentieel

Agents verwerken op volgorde (de ene wacht tot de vorige klaar is):

json

{  "broadcast": {    "strategy": "sequential",    "[email protected]": ["alfred", "baerbel"]  }}

Volledig voorbeeld

json

{  "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",    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],    "[email protected]": ["support-en", "support-de"],    "+15555550123": ["assistant", "logger"]  }}

Hoe het werkt

Berichtstroom

Binnenkomend bericht komt aan

Een WhatsApp-groeps- of DM-bericht komt aan.

Broadcastcontrole

Het systeem controleert of de peer-id in broadcast staat.

Als deze in de broadcastlijst staat

Alle vermelde agents verwerken het bericht.
Elke agent heeft zijn eigen sessiesleutel en geïsoleerde context.
Agents verwerken parallel (standaard) of sequentieel.

Als deze niet in de broadcastlijst staat

Normale routing is van toepassing (eerste overeenkomende binding).

Sessiesisolatie

Elke agent in een broadcastgroep behoudt volledig afzonderlijke:

Sessiesleutels (agent:alfred:whatsapp:group:120363... versus agent:baerbel:whatsapp:group:120363...)
Gespreksgeschiedenis (agent ziet de berichten van andere agents niet)
Workspace (afzonderlijke sandboxes indien geconfigureerd)
Tooltoegang (verschillende toestaan/weigeren-lijsten)
Geheugen/context (afzonderlijke IDENTITY.md, SOUL.md, enz.)
Groepscontextbuffer (recente groepsberichten die voor context worden gebruikt) wordt per peer gedeeld, zodat alle broadcastagents dezelfde context zien wanneer ze worden geactiveerd

Hierdoor kan elke agent beschikken over:

Verschillende persoonlijkheden
Verschillende tooltoegang (bijv. alleen-lezen versus lezen-schrijven)
Verschillende modellen (bijv. opus versus sonnet)
Verschillende geïnstalleerde Skills

Voorbeeld: geïsoleerde sessies

In groep [email protected] met agents ["alfred", "baerbel"]:

Alfreds context

Code

Session: agent:alfred:whatsapp:group:[email protected]History: [user message, alfred's previous responses]Workspace: /Users/user/openclaw-alfred/Tools: read, write, exec

Bärbels context

Code

Session: agent:baerbel:whatsapp:group:[email protected]History: [user message, baerbel's previous responses]Workspace: /Users/user/openclaw-baerbel/Tools: read only

Best practices

1. Houd agents gefocust

Ontwerp elke agent met één duidelijke verantwoordelijkheid:

json

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

✅ Goed: Elke agent heeft één taak. ❌ Slecht: Eén generieke "dev-helper"-agent.

2. Gebruik beschrijvende namen

Maak duidelijk wat elke agent doet:

json

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

3. Configureer verschillende tooltoegang

Geef agents alleen de tools die ze nodig hebben:

json

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

reviewer is alleen-lezen. fixer kan lezen en schrijven.

4. Bewaak prestaties

Overweeg bij veel agents:

"strategy": "parallel" (standaard) gebruiken voor snelheid
Broadcastgroepen beperken tot 5-10 agents
Snellere modellen gebruiken voor eenvoudigere agents

5. Handel fouten netjes af

Agents falen onafhankelijk. Een fout van één agent blokkeert de andere niet:

Code

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

Compatibiliteit

Providers

Broadcastgroepen werken momenteel met:

✅ WhatsApp (geïmplementeerd)
🚧 Telegram (gepland)
🚧 Discord (gepland)
🚧 Slack (gepland)

Routing

Broadcastgroepen werken naast bestaande routing:

json

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

GROUP_A: Alleen alfred antwoordt (normale routing).
GROUP_B: agent1 EN agent2 antwoorden (broadcast).

Probleemoplossing

Agents reageren niet

Controleer:

Agent-id's bestaan in agents.list.
Peer-id-indeling is correct (bijv. [email protected]).
Agents staan niet in weigerlijsten.

Debuggen:

bash

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

Slechts één agent reageert

Oorzaak: Peer-id staat mogelijk in bindings maar niet in broadcast.

Oplossing: Voeg toe aan de broadcastconfiguratie of verwijder uit bindings.

Prestatieproblemen

Als het traag is met veel agents:

Verminder het aantal agents per groep.
Gebruik lichtere modellen (sonnet in plaats van opus).
Controleer de opstarttijd van de sandbox.

Voorbeelden

Voorbeeld 1: Codereviewteam

json

{  "broadcast": {    "strategy": "parallel",    "[email protected]": [      "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"] } }    ]  }}

Gebruiker stuurt: Codefragment.

Reacties:

code-formatter: "Fixed indentation and added type hints"
security-scanner: "⚠️ SQL injection vulnerability in line 12"
test-coverage: "Coverage is 45%, missing tests for error cases"
docs-checker: "Missing docstring for function process_data"

Voorbeeld 2: Meertalige ondersteuning

json

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

typescript

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

Velden

strategy"parallel" | "sequential"default: "parallel"

Hoe agents moeten worden verwerkt. parallel voert alle agents gelijktijdig uit; sequential voert ze uit in arrayvolgorde.

[peerId]string[]

WhatsApp-groeps-JID, E.164-nummer of andere peer-id. Waarde is de array met agent-id's die berichten moeten verwerken.

Beperkingen

Max. agents: Geen harde limiet, maar 10+ agents kunnen traag zijn.
Gedeelde context: Agents zien elkaars reacties niet (volgens ontwerp).
Berichtvolgorde: Parallelle reacties kunnen in willekeurige volgorde aankomen.
Snelheidslimieten: Alle agents tellen mee voor WhatsApp-snelheidslimieten.

Toekomstige verbeteringen

Geplande functies:

[ ] Modus voor gedeelde context (agents zien elkaars reacties)
[ ] Agentcoördinatie (agents kunnen elkaar signaleren)
[ ] Dynamische agentselectie (agents kiezen op basis van berichtinhoud)
[ ] Agentprioriteiten (sommige agents reageren vóór andere)

Gerelateerd

Was this useful?