Broadcast-Gruppen

Status: Experimentell Version: Hinzugefügt in 2026.1.9

Überblick

Broadcast-Gruppen ermöglichen es mehreren Agents, dieselbe Nachricht gleichzeitig zu verarbeiten und darauf zu antworten. So kannst du spezialisierte Agent-Teams erstellen, die zusammen in einer WhatsApp-Gruppe oder einem DM arbeiten — alles über eine einzige Telefonnummer.

Aktueller Umfang: Nur WhatsApp (Web-Channel).

Broadcast-Gruppen werden nach Channel-Allowlists und Gruppen-Aktivierungsregeln ausgewertet. In WhatsApp-Gruppen bedeutet das: Broadcasts erfolgen, wenn OpenClaw normalerweise antworten würde (z. B. bei Erwähnung, abhängig von deinen Gruppeneinstellungen).

Anwendungsfälle

1. Spezialisierte Agent-Teams

Setze mehrere Agents mit klar abgegrenzten Aufgaben ein:

Gruppe: "Development Team"
Agents:
  - CodeReviewer (prüft Code-Snippets)
  - DocumentationBot (erstellt Dokumentation)
  - SecurityAuditor (prüft auf Sicherheitslücken)
  - TestGenerator (schlägt Testfälle vor)

Jeder Agent verarbeitet dieselbe Nachricht und liefert seine spezialisierte Perspektive.

2. Mehrsprachiger Support

Gruppe: "International Support"
Agents:
  - Agent_EN (antwortet auf Englisch)
  - Agent_DE (antwortet auf Deutsch)
  - Agent_ES (antwortet auf Spanisch)

3. Qualitätssicherungs-Workflows

Gruppe: "Customer Support"
Agents:
  - SupportAgent (liefert Antwort)
  - QAAgent (prüft Qualität, antwortet nur bei Problemen)

4. Task-Automatisierung

Gruppe: "Project Management"
Agents:
  - TaskTracker (aktualisiert Task-Datenbank)
  - TimeLogger (protokolliert Zeitaufwand)
  - ReportGenerator (erstellt Zusammenfassungen)

Konfiguration

Basis-Setup

Füge einen Top-Level-Abschnitt broadcast hinzu (neben bindings). Die Keys sind WhatsApp-Peer-IDs:

  • Gruppenchats: Gruppen-JID (z. B. [email protected])
  • DMs: E.164-Telefonnummer (z. B. +15551234567)
{
  "broadcast": {
    "[email protected]": ["alfred", "baerbel", "assistant3"]
  }
}

Ergebnis: Wenn OpenClaw in diesem Chat antworten würde, werden alle drei Agents ausgeführt.

Verarbeitungsstrategie

Steuere, wie Agents Nachrichten verarbeiten:

Parallel (Standard)

Alle Agents verarbeiten gleichzeitig:

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

Sequential

Agents verarbeiten nacheinander (einer wartet auf den vorherigen):

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

Vollständiges Beispiel

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

So funktioniert’s

Nachrichtenfluss

  1. Eingehende Nachricht kommt in einer WhatsApp-Gruppe an
  2. Broadcast-Check: System prüft, ob die Peer-ID in broadcast enthalten ist
  3. Falls in Broadcast-Liste:
    • Alle aufgelisteten Agents verarbeiten die Nachricht
    • Jeder Agent hat seinen eigenen Session-Key und isolierten Context
    • Agents verarbeiten parallel (Standard) oder sequenziell
  4. Falls nicht in Broadcast-Liste:
    • Normales Routing greift (erstes passendes Binding)

Hinweis: Broadcast-Gruppen umgehen nicht die Channel-Allowlists oder Gruppen-Aktivierungsregeln (Erwähnungen/Befehle/etc.). Sie ändern nur, welche Agents ausgeführt werden, wenn eine Nachricht zur Verarbeitung berechtigt ist.

Session-Isolation

Jeder Agent in einer Broadcast-Gruppe hat vollständig getrennte:

  • Session-Keys (agent:alfred:whatsapp:group:120363... vs. agent:baerbel:whatsapp:group:120363...)
  • Gesprächsverlauf (Agent sieht nicht die Nachrichten anderer Agents)
  • Workspace (separate Sandboxes, falls konfiguriert)
  • Tool-Zugriff (unterschiedliche Allow/Deny-Listen)
  • Memory/Context (separate IDENTITY.md, SOUL.md, etc.)
  • Gruppen-Context-Buffer (aktuelle Gruppennachrichten für Context) wird pro Peer geteilt, sodass alle Broadcast-Agents denselben Context sehen, wenn sie ausgelöst werden

Das ermöglicht jedem Agent:

  • Unterschiedliche Persönlichkeiten
  • Unterschiedlichen Tool-Zugriff (z. B. read-only vs. read-write)
  • Unterschiedliche Modelle (z. B. opus vs. sonnet)
  • Unterschiedliche installierte Skills

Beispiel: Isolierte Sessions

In Gruppe [email protected] mit Agents ["alfred", "baerbel"]:

Alfreds Context:

Session: agent:alfred:whatsapp:group:[email protected]
History: [User-Nachricht, Alfreds vorherige Antworten]
Workspace: /Users/pascal/openclaw-alfred/
Tools: read, write, exec

Bärbels Context:

Session: agent:baerbel:whatsapp:group:[email protected]
History: [User-Nachricht, Bärbels vorherige Antworten]
Workspace: /Users/pascal/openclaw-baerbel/
Tools: read only

Best Practices

1. Halte Agents fokussiert

Gib jedem Agent eine einzelne, klare Aufgabe:

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

✅ Gut: Jeder Agent hat einen Job ❌ Schlecht: Ein generischer “dev-helper”-Agent

2. Verwende aussagekräftige Namen

Mach klar, was jeder Agent tut:

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

3. Konfiguriere unterschiedlichen Tool-Zugriff

Gib Agents nur die Tools, die sie brauchen:

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

4. Überwache die Performance

Bei vielen Agents solltest du beachten:

  • Verwende "strategy": "parallel" (Standard) für Geschwindigkeit
  • Begrenze Broadcast-Gruppen auf 5-10 Agents
  • Nutze schnellere Modelle für einfachere Agents

5. Behandle Fehler elegant

Agents scheitern unabhängig voneinander. Der Fehler eines Agents blockiert nicht die anderen:

Nachricht → [Agent A ✓, Agent B ✗ Fehler, Agent C ✓]
Ergebnis: Agent A und C antworten, Agent B loggt Fehler

Kompatibilität

Provider

Broadcast-Gruppen funktionieren aktuell mit:

  • ✅ WhatsApp (implementiert)
  • 🚧 Telegram (geplant)
  • 🚧 Discord (geplant)
  • 🚧 Slack (geplant)

Routing

Broadcast-Gruppen funktionieren neben bestehendem Routing:

{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}
  • GROUP_A: Nur Alfred antwortet (normales Routing)
  • GROUP_B: agent1 UND agent2 antworten (Broadcast)

Priorität: broadcast hat Vorrang vor bindings.

Troubleshooting

Agents antworten nicht

Prüfe:

  1. Agent-IDs existieren in agents.list
  2. Peer-ID-Format ist korrekt (z. B. [email protected])
  3. Agents sind nicht in Deny-Listen

Debug:

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

Nur ein Agent antwortet

Ursache: Peer-ID könnte in bindings, aber nicht in broadcast sein.

Lösung: Zur Broadcast-Config hinzufügen oder aus Bindings entfernen.

Performance-Probleme

Bei Langsamkeit mit vielen Agents:

  • Reduziere die Anzahl der Agents pro Gruppe
  • Nutze leichtere Modelle (sonnet statt opus)
  • Prüfe Sandbox-Startzeit

Beispiele

Beispiel 1: Code-Review-Team

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

User sendet: Code-Snippet Antworten:

  • code-formatter: “Einrückung korrigiert und Type-Hints hinzugefügt”
  • security-scanner: “⚠️ SQL-Injection-Schwachstelle in Zeile 12”
  • test-coverage: “Coverage liegt bei 45 %, Tests für Fehlerfälle fehlen”
  • docs-checker: “Docstring für Funktion process_data fehlt”

Beispiel 2: Mehrsprachiger Support

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

API-Referenz

Config-Schema

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

Felder

  • strategy (optional): Wie Agents verarbeitet werden
    • "parallel" (Standard): Alle Agents verarbeiten gleichzeitig
    • "sequential": Agents verarbeiten in Array-Reihenfolge
  • [peerId]: WhatsApp-Gruppen-JID, E.164-Nummer oder andere Peer-ID
    • Wert: Array von Agent-IDs, die Nachrichten verarbeiten sollen

Einschränkungen

  1. Max. Agents: Keine harte Grenze, aber 10+ Agents können langsam sein
  2. Geteilter Context: Agents sehen nicht die Antworten der anderen (by design)
  3. Nachrichtenreihenfolge: Parallele Antworten können in beliebiger Reihenfolge ankommen
  4. Rate Limits: Alle Agents zählen zu den WhatsApp-Rate-Limits

Zukünftige Erweiterungen

Geplante Features:

  • Shared-Context-Modus (Agents sehen Antworten der anderen)
  • Agent-Koordination (Agents können sich gegenseitig signalisieren)
  • Dynamische Agent-Auswahl (Agents basierend auf Nachrichteninhalt wählen)
  • Agent-Prioritäten (manche Agents antworten vor anderen)

Siehe auch