Broadcastgroepen
Status: ExperimenteelVersie: Toegevoegd in 2026.1.9
Overzicht
Broadcastgroepen stellen meerdere agents in staat om hetzelfde bericht gelijktijdig te verwerken en te beantwoorden. Hiermee 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 regels voor groepsactivatie. In WhatsApp-groepen betekent dit dat broadcasts plaatsvinden wanneer OpenClaw normaal gesproken zou antwoorden (bijvoorbeeld: bij een vermelding, afhankelijk van je groepsinstellingen).Use cases
1. Gespecialiseerde agentteams
Zet meerdere agents in met afgebakende, gerichte verantwoordelijkheden:2. Meertalige ondersteuning
3. Kwaliteitsborgingsworkflows
4. Taakautomatisering
Configuratie
Basisinstallatie
Voeg een top-levelbroadcast-sectie toe (naast bindings). Sleutels zijn WhatsApp peer-id’s:
- groepschats: groeps-JID (bijv.
[email protected]) - DM’s: E.164-telefoonnummer (bijv.
+15551234567)
Verwerkingsstrategie
Bepaal hoe agents berichten verwerken:Parallel (standaard)
Alle agents verwerken gelijktijdig:Sequentiële
Agents verwerken op volgorde (de volgende wacht tot de vorige klaar is):Volledig voorbeeld
Hoe het werkt
Flow bericht
- Binnenkomend bericht komt aan in een WhatsApp-groep
- Broadcastcontrole: het systeem controleert of de peer-id in
broadcaststaat - Indien in de broadcastlijst:
- Alle vermelde agents verwerken het bericht
- Elke agent heeft zijn eigen sessiesleutel en geïsoleerde context
- Agents verwerken parallel (standaard) of sequentieel
- Indien niet in de broadcastlijst:
- Normale routering is van toepassing (eerste overeenkomende binding)
Sessiescheiding
Elke agent in een broadcastgroep behoudt volledig gescheiden:- Sessiesleutels (
agent:alfred:whatsapp:group:120363...vsagent:baerbel:whatsapp:group:120363...) - Gespreksgeschiedenis (agent ziet geen berichten van andere agents)
- Werkruimte (aparte sandboxes indien geconfigureerd)
- Tooltoegang (verschillende allow/deny-lijsten)
- Geheugen/context (aparte IDENTITY.md, SOUL.md, enz.)
- Groepscontextbuffer (recente groepsberichten die voor context worden gebruikt) wordt gedeeld per peer, zodat alle broadcast-agents bij activering dezelfde context zien
- Verschillende persoonlijkheden
- Verschillende tooltoegang (bijv. alleen-lezen vs. lezen-schrijven)
- Verschillende modellen (bijv. opus vs. sonnet)
- Verschillende geïnstalleerde Skills
Voorbeeld: geïsoleerde sessies
In groep[email protected] met agents ["alfred", "baerbel"]:
Context van Alfred:
Best practices
1. Houd agents gefocust
Ontwerp elke agent met één duidelijke verantwoordelijkheid:❌ Slecht: Eén generieke “dev-helper”-agent
2. Gebruik beschrijvende namen
Maak duidelijk wat elke agent doet:3. Configureer verschillende tooltoegang
Geef agents alleen de tools die ze nodig hebben:4. Monitor prestaties
Met veel agents, overweeg:- Gebruik van
"strategy": "parallel"(standaard) voor snelheid - Beperk broadcastgroepen tot 5–10 agents
- Gebruik snellere modellen voor eenvoudigere agents
5. Ga netjes om met fouten
Agents falen onafhankelijk. Een fout bij één agent blokkeert de anderen niet:Compatibiliteit
Aanbieders
Broadcastgroepen werken momenteel met:- ✅ WhatsApp (geïmplementeerd)
- 🚧 Telegram (gepland)
- 🚧 Discord (gepland)
- 🚧 Slack (gepland)
Routering
Broadcastgroepen werken naast bestaande routering:GROUP_A: Alleen alfred antwoordt (normale routering)GROUP_B: agent1 EN agent2 antwoorden (broadcast)
broadcast heeft voorrang op bindings.
Problemen oplossen
Agents reageren niet
Controleer:- Agent-id’s bestaan in
agents.list - Peer-id-indeling is correct (bijv.
[email protected]) - Agents staan niet in deny-lijsten
Slechts één agent reageert
Oorzaak: Peer-id staat mogelijk inbindings 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 sandbox-opstarttijd
Voorbeelden
Voorbeeld 1: Code review-team
Antwoorden:
- code-formatter: “Inspringing hersteld en type hints toegevoegd”
- security-scanner: “⚠️ SQL-injectie-kwetsbaarheid in regel 12”
- test-coverage: “Dekking is 45%, ontbrekende tests voor foutgevallen”
- docs-checker: “Ontbrekende docstring voor functie
process_data”
Voorbeeld 2: Meertalige ondersteuning
API-referentie
Configuratieschema
Velden
strategy(optioneel): Hoe agents worden verwerkt"parallel"(standaard): Alle agents verwerken gelijktijdig"sequential": Agents verwerken in arrayvolgorde
[peerId]: WhatsApp-groeps-JID, E.164-nummer of andere peer-id- Waarde: 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 antwoorden niet (bewust ontwerp)
- Berichtvolgorde: Parallelle antwoorden kunnen in willekeurige volgorde aankomen
- Rate limits: Alle agents tellen mee voor WhatsApp-rate limits
Toekomstige uitbreidingen
Geplande functies:- Gedeelde contextmodus (agents zien elkaars antwoorden)
- Agentcoördinatie (agents kunnen elkaar signaleren)
- Dynamische agentselectie (agents kiezen op basis van berichtinhoud)
- Agentprioriteiten (sommige agents antwoorden eerder dan andere)