​

Groupes de diffusion

​

Présentation

​

Cas d’utilisation

​

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

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

​

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

• discussions de groupe : JID du groupe (par ex. [email protected])
• DM: numéro de téléphone E.164 (par exemple +15551234567)

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

​

Stratégie de traitement

​

Parallèle (par défaut)

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

​

Séquentiel

{
  "broadcast": {
    "strategy": "sequential",
    "[email protected]": ["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",
    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],
    "[email protected]": ["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)

​

Isolation des sessions

• 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

• 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

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

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

​

Bonnes pratiques

​

1. Garder les agents ciblés

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

​

2. Utiliser des noms descriptifs

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

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

​

4. Surveiller les performances

• 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

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

​

Compatibilité

​

Fournisseurs

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

​

Routage

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

​

Problemes courants

​

Les agents ne répondent pas

1. Les ID d’agent existent dans agents.list
2. Le format de l’ID de pair est correct (par ex. [email protected])
3. Les agents ne figurent pas dans des listes de refus

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

​

Un seul agent répond

​

Problèmes de performances

• 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

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

• 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

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

• 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

• 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
• Configuration du routage
• Gestion des sessions