Groupes de diffusion

# Vue d’ensemble

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ées qui travaillent ensemble dans un seul groupe ou message direct WhatsApp, 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 des canaux et les règles d’activation des groupes. Dans les groupes WhatsApp, cela signifie que les diffusions ont lieu lorsque OpenClaw répondrait normalement (par exemple : lors d’une mention, selon les paramètres de votre groupe).

# 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 exemple [email protected])
• messages directs : numéro de téléphone E.164 (par exemple +15551234567)

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

Résultat : Lorsque 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",
    "[email protected]": ["alfred", "baerbel"]
  }
}

{
  "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 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)
• Le tampon de contexte de groupe (messages de groupe récents utilisés comme contexte) est partagé par pair, ce qui permet à tous les agents de diffusion de voir 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 exemple, lecture seule vs lecture-écriture)
• Des modèles différents (par exemple, opus vs sonnet)
• Des Skills différents installés

# Exemple : sessions isolées

Dans le groupe [email protected] avec les agents ["alfred", "baerbel"] :

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

Session: agent:baerbel:whatsapp:group:[email protected]
History: [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",
    "[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"] } }
    ]
  }
}

{
  "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)
• [ ] Coordination des agents (les agents peuvent s’envoyer des signaux)
• [ ] Sélection dynamique des agents (choisir les agents selon le contenu du message)
• [ ] Priorités des agents (certains agents répondent avant les autres)

# Articles associés

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