Groupes de diffusion

Vue d’ensemble

Les groupes de diffusion exécutent plusieurs agents sur le même message entrant. Chaque agent traite le message dans sa propre session isolée et publie sa propre réponse. Un même numéro WhatsApp peut ainsi héberger une équipe d’agents spécialisés dans une discussion de groupe ou un message privé.

Les groupes de diffusion sont évalués après les listes d’autorisation du canal et les règles d’activation des groupes. Dans les groupes WhatsApp, la diffusion a lieu lorsque OpenClaw répondrait normalement (par exemple, en cas de mention, selon les paramètres de votre groupe). Elle modifie uniquement les agents exécutés, jamais l’admissibilité d’un message au traitement.

Le parcours d’assurance qualité WhatsApp en conditions réelles comprend whatsapp-broadcast-group-fanout, qui vérifie qu’un message de groupe mentionnant OpenClaw peut produire des réponses visibles distinctes de deux agents configurés.

Configuration

Configuration de base

Ajoutez une section broadcast de premier niveau (à côté de bindings). Les clés sont des identifiants de correspondants WhatsApp et les valeurs sont des tableaux d’identifiants d’agents :

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

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

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

Chaque identifiant d’agent répertorié doit exister dans agents.list : la validation de la configuration signale les identifiants inconnus et l’environnement d’exécution les ignore avec l’avertissement Broadcast agent <id> not found in agents.list; skipping.

Stratégie de traitement

broadcast.strategy définit la manière dont les agents traitent le message :

{  "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 entièrement distincts :

• Clés de session (agent:alfred:whatsapp:group:120363... contre agent:baerbel:whatsapp:group:120363...)
• Historique de conversation (un agent ne voit pas les réponses des autres agents)
• Espace de travail (environnements isolés distincts s’ils sont configurés)
• Accès aux outils (listes d’autorisation et de refus différentes)
• Mémoire/contexte (IDENTITY.md, SOUL.md, etc. distincts)

Une exception est volontairement partagée : le tampon de contexte du groupe (messages récents du groupe utilisés comme contexte) est partagé par correspondant. Tous les agents de diffusion voient donc le même contexte lorsqu’ils sont déclenchés. Il est effacé une fois la distribution terminée.

Chaque agent peut ainsi disposer d’une personnalité, de modèles, de Skills et d’un accès aux outils différents (par exemple, lecture seule ou lecture-écriture).

Exemple : sessions isolées

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

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistorique : [message de l’utilisateur, réponses précédentes d’alfred]Espace de travail : ~/openclaw-alfred/Outils : lecture, écriture, exécution

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistorique : [message de l’utilisateur, réponses précédentes de baerbel]Espace de travail : ~/openclaw-baerbel/Outils : lecture seule

Cas d’utilisation

• Équipes d’agents spécialisés : un groupe de développement dans lequel code-reviewer, security-auditor, test-generator et docs-checker répondent chacun au même message selon leur propre domaine.
• Assistance multilingue : une discussion d’assistance dans laquelle support-en, support-de et support-es répondent dans leurs langues respectives.
• Assurance qualité : support-agent répond tandis que qa-agent effectue une vérification et ne répond que s’il détecte des problèmes.
• Automatisation des tâches : task-tracker, time-logger et report-generator traitent tous la même mise à jour d’état.

Bonnes pratiques

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

Compatibilité

Fournisseurs

Les groupes de diffusion ne sont actuellement mis en œuvre que pour WhatsApp (canal web). Les autres canaux ignorent la configuration broadcast.

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

openclaw logs --follow | grep -i 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 de l’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 un grand nombre d’agents (10 ou plus) peut ralentir le traitement.
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 : toutes les réponses proviennent d’un même compte WhatsApp ; la réponse de chaque agent est donc comptabilisée dans les mêmes limites de débit WhatsApp.

Contenu associé

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