Broadcast-grupper

Status: Experimentell
Version: Tillagd i 2026.1.9

Översikt

Sändningsgrupper gör det möjligt för flera agenter att bearbeta och svara på samma meddelande samtidigt. Detta gör att du kan skapa specialiserade agentgrupper som arbetar tillsammans i en enda WhatsApp grupp eller DM — alla med ett telefonnummer. Nuvarande omfattning: endast WhatsApp (webbkanal). Sändningsgrupper utvärderas efter kanaltillåtna listor och gruppaktiveringsregler. I WhatsApp-grupper innebär detta att sändningar sker när OpenClaw normalt skulle svara (till exempel: omnämnande, beroende på dina gruppinställningar).

Användningsfall

1. Specialiserade agentteam

Driftsätt flera agenter med atomära, fokuserade ansvarsområden:

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

Varje agent bearbetar samma meddelande och bidrar med sitt specialiserade perspektiv.

2. Stöd för flera språk

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

3. Arbetsflöden för kvalitetssäkring

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

4. Automatiserad Uppgift

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

Konfiguration

Grundläggande konfigurering

Lägg till en toppnivå broadcast-sektion (bredvid bindings). Nycklar är WhatsApp kamrat-ids:

grupp chattar: grupp JID (t.ex. [email protected])
DMs: E.164 telefonnummer (t.ex. +15551234567)

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

Resultat: När OpenClaw skulle svara i denna chatt körs alla tre agenterna.

Bearbetningsstrategi

Styr hur agenter bearbetar meddelanden:

Parallellt (standard)

Alla agenter bearbetar samtidigt:

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

Sekventiellt

Agenter bearbetar i ordning (en väntar tills föregående är klar):

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

Fullständigt exempel

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

Hur det fungerar

Meddelandeflöde

Inkommande meddelande anländer i en WhatsApp-grupp
Broadcast-kontroll: Systemet kontrollerar om peer-ID finns i broadcast
Om i broadcast-listan:
- Alla listade agenter bearbetar meddelandet
- Varje agent har sin egen sessionsnyckel och isolerad kontext
- Agenter bearbetar parallellt (standard) eller sekventiellt
Om inte i broadcast-listan:
- Normal routning gäller (första matchande bindning)

Obs: sändningsgrupper förbigår inte kanaltillåtna listor eller gruppaktiveringsregler (omnämnande/kommandon/etc). De ändrar bara _vilka agenter som kör _ när ett meddelande är berättigat till behandling.

Sessionsisolering

Varje agent i en broadcast-grupp upprätthåller helt separata:

Sessionsnycklar (agent:alfred:whatsapp:group:120363... vs agent:baerbel:whatsapp:group:120363...)
Konversationshistorik (agenten ser inte andra agenters meddelanden)
Arbetsyta (separata sandboxar om konfigurerat)
Verktygsåtkomst (olika tillåt-/nekalistor)
Minne/kontext (separata IDENTITY.md, SOUL.md, etc.)
Gruppkontextbuffert (senaste gruppmeddelanden som används som kontext) delas per peer, så alla broadcast-agenter ser samma kontext när de triggas

Detta gör att varje agent kan ha:

Olika personligheter
Olika verktygsåtkomst (t.ex. skrivskyddad vs. läs–skriv)
Olika modeller (t.ex. opus vs. sonnet)
Olika Skills installerade

Exempel: Isolerade sessioner

I grupp [email protected] med agenterna ["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

Bästa praxis

1. Håll agenter fokuserade

Designa varje agent med ett enda, tydligt ansvar:

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

✅ Bra: Varje agent har ett jobb
❌ Dåligt: En generisk ”dev-helper”-agent

2. Använd beskrivande namn

Gör det tydligt vad varje agent gör:

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

3. Konfigurera olika verktyg tillgång

Ge agenter bara de verktyg de behöver:

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

4. Övervaka prestanda

Med många agenter, överväg:

Att använda "strategy": "parallel" (standard) för hastighet
Att begränsa broadcast-grupper till 5–10 agenter
Att använda snabbare modeller för enklare agenter

5. Hantera misslyckanden Gracfully

Agenter misslyckas självständigt. Ett agentfel blockerar inte andra:

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

Kompatibilitet

Leverantörer

Broadcast-grupper fungerar för närvarande med:

✅ WhatsApp (implementerat)
🚧 Telegram (planerat)
🚧 Discord (planerat)
🚧 Slack (planerat)

Routning

Broadcast-grupper fungerar sida vid sida med befintlig routning:

{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}

GROUP_A: Endast alfred svarar (normal routning)
GROUP_B: agent1 OCH agent2 svarar (broadcast)

Företräde: broadcast har prioritet över bindings.

Felsökning

Agenter svarar inte

Kontrollera:

Agent-ID:n finns i agents.list
Det andra ID-formatet är korrekt (t.ex., ‘[email protected]’)
Agenterna finns inte i nekalistor

Debugga:

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

Endast en agent svarar

Orsak: Peer-ID kan finnas i bindings men inte i broadcast. Åtgärd: Lägg till i broadcast-konfigen eller ta bort från bindningar.

Prestandaproblem

Om det är långsamt med många agenter:

Minska antalet agenter per grupp
Använd lättare modeller (sonnet i stället för opus)
Kontrollera starttiden för sandbox

Exempel

Exempel 1: Team för kodgranskning

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

Användaren skickar: Kodsnutt
Svar:

code-formatter: ”Fixade indrag och lade till typanvisningar”
security-scanner: ”⚠️ SQL-injektionssårbarhet på rad 12”
test-coverage: ”Täckningen är 45 %, saknar tester för felhanteringsfall”
docs-checker: ”Saknar docstring för funktionen process_data”

Exempel 2: Flerspråksstöd

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

Konfigschema

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

Fält

strategy (valfritt): Hur agenter ska bearbetas
- "parallel" (standard): Alla agenter bearbetar samtidigt
- "sequential": Agenter bearbetar i array-ordning
[peerId]: WhatsApp-grupp-JID, E.164-nummer eller annat peer-ID
- Värde: Array av agent-ID:n som ska bearbeta meddelanden

Begränsningar

Max antal agenter: Ingen hård gräns, men 10+ agenter kan vara långsamt
Delad kontext: Agenter ser inte varandras svar (avsiktligt)
Meddelandeordning: Parallella svar kan komma i valfri ordning
Hastighetsbegränsningar: Alla agenter räknas mot WhatsApps rate limits

Framtida förbättringar

Planerade funktioner:

Delat kontextläge (agenter ser varandras svar)
Agentkoordination (agenter kan signalera till varandra)
Dynamiskt agentval (välj agenter baserat på meddelandets innehåll)
Agentprioriteter (vissa agenter svarar före andra)

​Broadcast-grupper

​Översikt

​Användningsfall

​1. Specialiserade agentteam

​2. Stöd för flera språk

​3. Arbetsflöden för kvalitetssäkring

​4. Automatiserad Uppgift

​Konfiguration

​Grundläggande konfigurering

​Bearbetningsstrategi

​Parallellt (standard)

​Sekventiellt

​Fullständigt exempel

​Hur det fungerar

​Meddelandeflöde

​Sessionsisolering

​Exempel: Isolerade sessioner

​Bästa praxis

​1. Håll agenter fokuserade

​2. Använd beskrivande namn

​3. Konfigurera olika verktyg tillgång

​4. Övervaka prestanda

​5. Hantera misslyckanden Gracfully

​Kompatibilitet

​Leverantörer

​Routning

​Felsökning

​Agenter svarar inte

​Endast en agent svarar

​Prestandaproblem

​Exempel

​Exempel 1: Team för kodgranskning

​Exempel 2: Flerspråksstöd

​API-referens

​Konfigschema

​Fält

​Begränsningar

​Framtida förbättringar

​Se även