Broadcast-Gruppen

Status: Experimentell
Version: Hinzugefügt in 2026.1.9

Überblick

Broadcast-Gruppen ermöglichen es mehreren Agenten, dieselbe Nachricht gleichzeitig zu verarbeiten und darauf zu antworten. So können Sie spezialisierte Agenten-Teams erstellen, die gemeinsam in einer einzelnen WhatsApp-Gruppe oder Direktnachricht arbeiten — alles mit einer einzigen Telefonnummer. Aktueller Umfang: nur WhatsApp (Web-Kanal). Broadcast-Gruppen werden nach Kanal-Allowlists und Gruppen-Aktivierungsregeln ausgewertet. In WhatsApp-Gruppen bedeutet dies, dass Broadcasts dann stattfinden, wenn OpenClaw normalerweise antworten würde (zum Beispiel bei Erwähnung, abhängig von Ihren Gruppeneinstellungen).

Verwende Fälle

1. Spezialisierte Agenten-Teams

Stellen Sie mehrere Agenten mit atomaren, klar abgegrenzten Verantwortlichkeiten bereit:

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

Jeder Agent verarbeitet dieselbe Nachricht und liefert seine spezialisierte Perspektive.

2. Mehrsprachige Unterstützung

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

3. Qualitätssicherungs-Workflows

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

4. Aufgabenautomatisierung

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

Konfiguration

Grundlegende Einrichtung

Fügen Sie einen Top-Level-Abschnitt broadcast hinzu (neben bindings). Schlüssel sind WhatsApp-Peer-IDs:

Gruppenchats: Gruppen-JID (z. B. [email protected])
Direktnachrichten: E.164-Telefonnummer (z. B. +15551234567)

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

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

Verarbeitungsstrategie

Steuern Sie, wie Agenten Nachrichten verarbeiten:

Parallel (Standard)

Alle Agenten verarbeiten gleichzeitig:

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

Sequenziell

Agenten verarbeiten der Reihe nach (einer wartet, bis der vorherige abgeschlossen ist):

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

Funktionsweise

Nachrichtenfluss

Eingehende Nachricht trifft in einer WhatsApp-Gruppe ein
Broadcast-Prüfung: Das System prüft, ob die Peer-ID in broadcast enthalten ist
Wenn in der Broadcast-Liste:
- Alle aufgeführten Agenten verarbeiten die Nachricht
- Jeder Agent hat seinen eigenen Sitzungsschlüssel und isolierten Kontext
- Agenten verarbeiten parallel (Standard) oder sequenziell
Wenn nicht in der Broadcast-Liste:
- Normales Routing wird angewendet (erste passende Bindung)

Hinweis: Broadcast-Gruppen umgehen weder Kanal-Allowlists noch Gruppen-Aktivierungsregeln (Erwähnungen/Befehle/etc.). Sie ändern lediglich welche Agenten ausgeführt werden, wenn eine Nachricht zur Verarbeitung berechtigt ist.

Sitzungsisolierung

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

Sitzungsschlüssel (agent:alfred:whatsapp:group:120363... vs. agent:baerbel:whatsapp:group:120363...)
Gesprächsverlauf (Agenten sehen keine Nachrichten anderer Agenten)
Arbeitsbereich (separate sandboxes, falls konfiguriert)
Werkzeugzugriff (unterschiedliche Allow-/Deny-Listen)
Speicher/Kontext (separate IDENTITY.md, SOUL.md usw.)
Gruppenkontext-Puffer (aktuelle Gruppennachrichten für den Kontext) wird pro Peer geteilt, sodass alle Broadcast-Agenten beim Auslösen denselben Kontext sehen

Dies ermöglicht es jedem Agenten:

Unterschiedliche Persönlichkeiten zu haben
Unterschiedlichen Werkzeugzugriff zu besitzen (z. B. nur Lesen vs. Lesen/Schreiben)
Unterschiedliche Modelle zu nutzen (z. B. opus vs. sonnet)
Unterschiedliche Skills installiert zu haben

Beispiel: Isolierte Sitzungen

In der Gruppe [email protected] mit den Agenten ["alfred", "baerbel"]: Alfreds Kontext:

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

Bärbels Kontext:

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

Bewährte Praktiken

1. Agenten fokussiert halten

Gestalten Sie jeden Agenten mit einer einzigen, klaren Verantwortung:

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

✅ Gut: Jeder Agent hat genau eine Aufgabe
❌ Schlecht: Ein generischer „dev-helper“-Agent

2. Beschreibende Namen verwenden

Machen Sie klar, was jeder Agent tut:

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

3. Unterschiedlichen Werkzeugzugriff konfigurieren

Geben Sie Agenten nur die Werkzeuge, die sie benötigen:

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

4. Performance überwachen

Bei vielen Agenten sollten Sie Folgendes berücksichtigen:

Verwendung von "strategy": "parallel" (Standard) für Geschwindigkeit
Beschränkung von Broadcast-Gruppen auf 5–10 Agenten
Verwendung schnellerer Modelle für einfachere Agenten

5. Fehler robust behandeln

Agenten schlagen unabhängig voneinander fehl. Der Fehler eines Agenten blockiert andere nicht:

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

Kompatibilität

Anbieter

Broadcast-Gruppen funktionieren derzeit 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.

Fehlerbehebung

Agenten antworten nicht

Prüfen Sie:

Agenten-IDs existieren in agents.list
Peer-ID-Format ist korrekt (z. B. [email protected])
Agenten befinden sich nicht in Deny-Listen

Debug:

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

Nur ein Agent antwortet

Ursache: Die Peer-ID ist möglicherweise in bindings, aber nicht in broadcast. Lösung: Zur Broadcast-Konfiguration hinzufügen oder aus Bindings entfernen.

Performance-Probleme

Wenn es mit vielen Agenten langsam ist:

Anzahl der Agenten pro Gruppe reduzieren
Leichtere Modelle verwenden (sonnet statt opus)
Sandbox-Startzeit prüfen

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

Benutzer sendet: Code-Snippet
Antworten:

code-formatter: „Einrückung korrigiert und Typhinweise hinzugefügt“
security-scanner: „⚠️ SQL-Injection-Sicherheitslücke in Zeile 12“
test-coverage: „Abdeckung beträgt 45 %, fehlende Tests für Fehlerfälle“
docs-checker: „Fehlender Docstring für Funktion process_data“

Beispiel 2: Mehrsprachige Unterstützung

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

Konfigurationsschema

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

Felder

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

Einschränkungen

Maximale Agenten: Keine harte Grenze, aber 10+ Agenten können langsam sein
Geteilter Kontext: Agenten sehen die Antworten der anderen nicht (absichtlich)
Nachrichtenreihenfolge: Parallele Antworten können in beliebiger Reihenfolge eintreffen
Rate-Limits: Alle Agenten zählen zu den WhatsApp-Rate-Limits

Zukünftige Erweiterungen

Geplante Funktionen:

Gemeinsamer Kontextmodus (Agenten sehen die Antworten der anderen)
Agentenkoordination (Agenten können sich gegenseitig signalisieren)
Dynamische Agentenauswahl (Auswahl basierend auf Nachrichteninhalt)
Agentenprioritäten (einige Agenten antworten vor anderen)

Überblick

Messaging-Plattformen

Konfiguration

​Broadcast-Gruppen

​Überblick

​Verwende Fälle

​1. Spezialisierte Agenten-Teams

​2. Mehrsprachige Unterstützung

​3. Qualitätssicherungs-Workflows

​4. Aufgabenautomatisierung

​Konfiguration

​Grundlegende Einrichtung

​Verarbeitungsstrategie

​Parallel (Standard)

​Sequenziell

​Vollständiges Beispiel

​Funktionsweise

​Nachrichtenfluss

​Sitzungsisolierung

​Beispiel: Isolierte Sitzungen

​Bewährte Praktiken

​1. Agenten fokussiert halten

​2. Beschreibende Namen verwenden

​3. Unterschiedlichen Werkzeugzugriff konfigurieren

​4. Performance überwachen

​5. Fehler robust behandeln

​Kompatibilität

​Anbieter

​Routing

​Fehlerbehebung

​Agenten antworten nicht

​Nur ein Agent antwortet

​Performance-Probleme

​Beispiele

​Beispiel 1: Code-Review-Team

​Beispiel 2: Mehrsprachige Unterstützung

​API-Referenz

​Konfigurationsschema

​Felder

​Einschränkungen

​Zukünftige Erweiterungen

​Siehe auch

Broadcast-Gruppen

Überblick

Verwende Fälle

1. Spezialisierte Agenten-Teams

2. Mehrsprachige Unterstützung

3. Qualitätssicherungs-Workflows

4. Aufgabenautomatisierung

Konfiguration

Grundlegende Einrichtung

Verarbeitungsstrategie

Parallel (Standard)

Sequenziell

Vollständiges Beispiel

Funktionsweise

Nachrichtenfluss

Sitzungsisolierung

Beispiel: Isolierte Sitzungen

Bewährte Praktiken

1. Agenten fokussiert halten

2. Beschreibende Namen verwenden

3. Unterschiedlichen Werkzeugzugriff konfigurieren

4. Performance überwachen

5. Fehler robust behandeln

Kompatibilität

Anbieter

Routing

Fehlerbehebung

Agenten antworten nicht

Nur ein Agent antwortet

Performance-Probleme

Beispiele

Beispiel 1: Code-Review-Team

Beispiel 2: Mehrsprachige Unterstützung

API-Referenz

Konfigurationsschema

Felder

Einschränkungen

Zukünftige Erweiterungen

Siehe auch