> ## 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.

# „Broadcast-Gruppen“

# 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. `120363403215116621@g.us`)
* Direktnachrichten: E.164-Telefonnummer (z. B. `+15551234567`)

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "broadcast": {
    "120363403215116621@g.us": ["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:

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

#### Sequenziell

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

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

### Vollständiges Beispiel

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

## Funktionsweise

### Nachrichtenfluss

1. **Eingehende Nachricht** trifft in einer WhatsApp-Gruppe ein
2. **Broadcast-Prüfung**: Das System prüft, ob die Peer-ID in `broadcast` enthalten ist
3. **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
4. **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 `120363403215116621@g.us` mit den Agenten `["alfred", "baerbel"]`:

**Alfreds Kontext:**

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

**Bärbels Kontext:**

```
Session: agent:baerbel:whatsapp:group:120363403215116621@g.us
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:

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

```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. Unterschiedlichen Werkzeugzugriff konfigurieren

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

```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. 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:

```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`: 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:**

1. Agenten-IDs existieren in `agents.list`
2. Peer-ID-Format ist korrekt (z. B. `120363403215116621@g.us`)
3. Agenten befinden sich nicht in Deny-Listen

**Debug:**

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

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

**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

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

## API-Referenz

### Konfigurationsschema

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

1. **Maximale Agenten:** Keine harte Grenze, aber 10+ Agenten können langsam sein
2. **Geteilter Kontext:** Agenten sehen die Antworten der anderen nicht (absichtlich)
3. **Nachrichtenreihenfolge:** Parallele Antworten können in beliebiger Reihenfolge eintreffen
4. **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)

## Siehe auch

* [Multi-Agent-Konfiguration](/tools/multi-agent-sandbox-tools)
* [Routing-Konfiguration](/channels/channel-routing)
* [Sitzungsverwaltung](/concepts/sessions)