Groupes de diffusion

Présentation

Les groupes de diffusion permettent à plusieurs agents de traiter le même message et d’y répondre simultanément. Cela vous permet de créer des équipes d’agents spécialisés qui travaillent ensemble dans un seul groupe WhatsApp ou message privé, le tout avec un seul numéro de téléphone.

Périmètre actuel : WhatsApp uniquement (canal web).

Les groupes de diffusion sont évalués après les listes d’autorisation de canal et les règles d’activation de groupe. Dans les groupes WhatsApp, cela signifie que les diffusions se produisent lorsque OpenClaw répondrait normalement (par exemple : lors d’une mention, selon vos paramètres de groupe).

La voie QA WhatsApp en direct inclut whatsapp-broadcast-group-fanout, qui vérifie qu’un message de groupe mentionné peut produire des réponses visibles distinctes de deux agents configurés.

Cas d’utilisation

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

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

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

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

Configuration

Configuration de base

Ajoutez une section broadcast de premier niveau (à côté de bindings). Les clés sont des identifiants de pairs WhatsApp :

• discussions de groupe : JID de groupe (par ex. 120363403215116621@g.us)
• messages privés : numéro de téléphone E.164 (par ex. +15551234567)

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

Résultat : Quand OpenClaw répondrait dans cette discussion, il exécutera les trois agents.

Stratégie de traitement

Contrôlez la façon dont les agents traitent les messages :

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

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

Exemple complet

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

Fonctionnement

Flux des messages

Isolation des sessions

Chaque agent d’un groupe de diffusion conserve des éléments complètement séparés :

• Clés de session (agent:alfred:whatsapp:group:120363... vs agent:baerbel:whatsapp:group:120363...)
• Historique de conversation (l’agent ne voit pas les messages des autres agents)
• Espace de travail (bacs à sable séparés si configurés)
• Accès aux outils (listes d’autorisation/refus différentes)
• Mémoire/contexte (IDENTITY.md, SOUL.md, etc. séparés)
• Tampon de contexte de groupe (messages récents du groupe utilisés comme contexte) partagé par pair, de sorte que tous les agents de diffusion voient le même contexte lorsqu’ils sont déclenchés

Cela permet à chaque agent d’avoir :

• Des personnalités différentes
• Des accès aux outils différents (par ex. lecture seule vs lecture-écriture)
• Des modèles différents (par ex. opus vs sonnet)
• Des Skills différents installés

Exemple : sessions isolées

Dans le groupe 120363403215116621@g.us avec les agents ["alfred", "baerbel"] :

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: /Users/user/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: /Users/user/openclaw-baerbel/Tools: read only

Bonnes pratiques

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

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

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

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

Compatibilité

Fournisseurs

Les groupes de diffusion fonctionnent actuellement avec :

• ✅ WhatsApp (implémenté)
• 🚧 Telegram (prévu)
• 🚧 Discord (prévu)
• 🚧 Slack (prévu)

Routage

Les groupes de diffusion fonctionnent avec le routage existant :

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

• GROUP_A : Seul alfred répond (routage normal).
• GROUP_B : agent1 ET agent2 répondent (diffusion).

Dépannage

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

Exemples

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

Référence API

Schéma de configuration

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

Champs

Limitations

1. Nombre maximal d’agents : Aucune limite stricte, mais 10 agents ou plus peuvent être lents.
2. Contexte partagé : Les agents ne voient pas les réponses des autres agents (par conception).
3. Ordre des messages : Les réponses parallèles peuvent arriver dans n’importe quel ordre.
4. Limites de débit : Tous les agents comptent dans les limites de débit de WhatsApp.

Améliorations futures

Fonctionnalités prévues :

• [ ] Mode de contexte partagé (les agents voient les réponses des autres agents)
• [ ] Coordination des agents (les agents peuvent se signaler entre eux)
• [ ] Sélection dynamique des agents (choisir les agents en fonction du contenu du message)
• [ ] Priorités des agents (certains agents répondent avant d’autres)

Articles liés

• Routage des canaux
• Groupes
• Outils de bac à sable multi-agent
• Appairage
• Gestion des sessions