> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Groupes de diffusion

# Groupes de diffusion

**Statut :** Expérimental\
**Version :** Ajouté dans 2026.1.9

## Présentation

Les groupes de diffusion permettent à plusieurs agents de traiter et de répondre simultanément au même message. Cela vous permet de créer des équipes d’agents spécialisés qui travaillent ensemble dans un même groupe WhatsApp ou message privé — le tout en utilisant 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 ont lieu lorsque OpenClaw répondrait normalement (par exemple : sur mention, selon les paramètres de votre groupe).

## Cas d’utilisation

### 1. Équipes d’agents spécialisées

Déployez plusieurs agents avec des responsabilités atomiques et ciblées :

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

Chaque agent traite le même message et fournit son point de vue spécialisé.

### 2. Support multilingue

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

### 3. Flux de travail d’assurance qualité

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

### 4. Automatisation des tâches

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

## Configuration

### Configuration de base

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

* discussions de groupe : JID du groupe (par ex. `120363403215116621@g.us`)
* DM: numéro de téléphone E.164 (par exemple `+15551234567`)

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "broadcast": {
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
  }
}
```

**Résultat :** Lorsque OpenClaw répondrait dans ce chat, il exécutera les trois agents.

### Stratégie de traitement

Contrôlez la manière dont les agents traitent les messages :

#### Parallèle (par défaut)

Tous les agents traitent simultanément :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"]
  }
}
```

#### Séquentiel

Les agents traitent dans l’ordre (l’un attend que le précédent ait terminé) :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "broadcast": {
    "strategy": "sequential",
    "120363403215116621@g.us": ["alfred", "baerbel"]
  }
}
```

### Exemple complet

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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 de messages

1. **Message entrant** arrive dans un groupe WhatsApp
2. **Vérification de diffusion** : le système vérifie si l’ID de pair figure dans `broadcast`
3. **S’il est dans la liste de diffusion** :
   * Tous les agents listés traitent le message
   * Chaque agent dispose de sa propre clé de session et d’un contexte isolé
   * Les agents traitent en parallèle (par défaut) ou de manière séquentielle
4. **S’il n’est pas dans la liste de diffusion** :
   * Le routage normal s’applique (première liaison correspondante)

Remarque : les groupes de diffusion ne contournent pas les listes d’autorisation de canal ni les règles d’activation de groupe (mentions/commandes/etc.). Ils modifient uniquement *quels agents s’exécutent* lorsqu’un message est éligible au traitement.

### Isolation des sessions

Chaque agent dans un groupe de diffusion maintient 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** (sandboxes 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 pour le contexte) est 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"]` :

**Contexte d’Alfred :**

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

**Contexte de Bärbel :**

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

## Bonnes pratiques

### 1. Garder les agents ciblés

Concevez chaque agent avec une responsabilité unique et claire :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
```

✅ **Bon :** Chaque agent a une seule tâche\
❌ **Mauvais :** Un agent générique « dev-helper »

### 2. Utiliser des noms descriptifs

Rendez clair ce que fait chaque agent :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}
```

### 3. Configurer des accès aux outils différents

Donnez aux agents uniquement les outils dont ils ont besoin :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] } // Read-only
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] } // Read-write
    }
  }
}
```

### 4. Surveiller les performances

Avec de nombreux agents, envisagez :

* L’utilisation de `"strategy": "parallel"` (par défaut) pour la vitesse
* La limitation des groupes de diffusion à 5–10 agents
* L’utilisation de modèles plus rapides pour les agents simples

### 5. Gérer les échecs avec élégance

Les agents échouent indépendamment. L’erreur d’un agent ne bloque pas les autres :

```
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 aux côtés du routage existant :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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)

**Priorité :** `broadcast` a la priorité sur `bindings`.

## Problemes courants

### Les agents ne répondent pas

**Vérifier :**

1. Les ID d’agent existent dans `agents.list`
2. Le format de l’ID de pair est correct (par ex. `120363403215116621@g.us`)
3. Les agents ne figurent pas dans des listes de refus

**Débogage :**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
```

### Un seul agent répond

**Cause :** L’ID de pair peut figurer dans `bindings` mais pas dans `broadcast`.

**Correctif :** Ajoutez-le à la configuration de diffusion ou supprimez-le des liaisons.

### Problèmes de performances

**Si c’est lent avec de nombreux agents :**

* Réduisez le nombre d’agents par groupe
* Utilisez des modèles plus légers (sonnet plutôt qu’opus)
* Vérifiez le temps de démarrage du sandbox

## Exemples

### Exemple 1 : Équipe de revue de code

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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"] } }
    ]
  }
}
```

**L’utilisateur envoie :** Extrait de code\
**Réponses :**

* code-formatter : « Correction de l’indentation et ajout d’annotations de type »
* security-scanner : « ⚠️ Vulnérabilité d’injection SQL à la ligne 12 »
* test-coverage : « La couverture est de 45 %, des tests manquent pour les cas d’erreur »
* docs-checker : « Docstring manquante pour la fonction `process_data` »

### Exemple 2 : Support multilingue

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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

```typescript theme={"theme":{"light":"min-light","dark":"min-dark"}}
interface OpenClawConfig {
  broadcast?: {
    strategy?: "parallel" | "sequential";
    [peerId: string]: string[];
  };
}
```

### Champs

* `strategy` (facultatif) : Comment traiter les agents
  * `"parallel"` (par défaut) : Tous les agents traitent simultanément
  * `"sequential"` : Les agents traitent selon l’ordre du tableau
* `[peerId]` : JID de groupe WhatsApp, numéro E.164 ou autre ID de pair
  * Valeur : Tableau des ID d’agents qui doivent traiter les messages

## Limitations

1. **Nombre maximal d’agents :** Pas de limite stricte, mais 10+ agents peuvent être lents
2. **Contexte partagé :** Les agents ne voient pas les réponses des autres (par conception)
3. **Ordonnancement 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 WhatsApp

## Améliorations futures

Fonctionnalités prévues :

* [ ] Mode de contexte partagé (les agents voient les réponses des autres)
* [ ] 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)

## Voir aussi

* [Configuration multi-agents](/tools/multi-agent-sandbox-tools)
* [Configuration du routage](/channels/channel-routing)
* [Gestion des sessions](/concepts/sessions)