Grupy rozgłoszeniowe

Przegląd

Grupy rozgłoszeniowe uruchamiają wiele agentów dla tej samej wiadomości przychodzącej. Każdy agent przetwarza wiadomość we własnej odizolowanej sesji i publikuje własną odpowiedź, dzięki czemu jeden numer WhatsApp może obsługiwać zespół wyspecjalizowanych agentów w pojedynczym czacie grupowym lub wiadomościach prywatnych.

Grupy rozgłoszeniowe są uwzględniane po zastosowaniu list dozwolonych kanału i reguł aktywacji grupy. W grupach WhatsApp rozgłaszanie następuje, gdy OpenClaw normalnie udzieliłby odpowiedzi (na przykład po wzmiance, zależnie od ustawień grupy). Zmienia ono wyłącznie to, którzy agenci są uruchamiani, a nigdy to, czy wiadomość kwalifikuje się do przetworzenia.

Aktywna ścieżka kontroli jakości WhatsApp obejmuje whatsapp-broadcast-group-fanout, który sprawdza, czy jedna wiadomość grupowa ze wzmianką może wygenerować odrębne, widoczne odpowiedzi od dwóch skonfigurowanych agentów.

Konfiguracja

Konfiguracja podstawowa

Dodaj sekcję najwyższego poziomu broadcast (obok bindings). Kluczami są identyfikatory rozmówców WhatsApp, a wartościami — tablice identyfikatorów agentów:

• czaty grupowe: JID grupy (np. 120363403215116621@g.us)
• wiadomości prywatne: numer telefonu nadawcy w formacie E.164 (np. +15551234567)

{  "broadcast": {    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]  }}

Wynik: gdy OpenClaw udzieliłby odpowiedzi na tym czacie, uruchamia wszystkich trzech agentów.

Każdy wymieniony identyfikator agenta musi istnieć w agents.list: walidacja konfiguracji zgłasza nieznane identyfikatory, a środowisko uruchomieniowe pomija je z ostrzeżeniem Broadcast agent <id> not found in agents.list; skipping.

Strategia przetwarzania

broadcast.strategy określa sposób przetwarzania wiadomości przez agentów:

{  "broadcast": {    "strategy": "sequential",    "120363403215116621@g.us": ["alfred", "baerbel"]  }}

Pełny przykład

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

Sposób działania

Przepływ wiadomości

Izolacja sesji

Każdy agent w grupie rozgłoszeniowej ma całkowicie odrębne:

• Klucze sesji (agent:alfred:whatsapp:group:120363... oraz agent:baerbel:whatsapp:group:120363...)
• Historię konwersacji (agent nie widzi odpowiedzi innych agentów)
• Obszar roboczy (oddzielne piaskownice, jeśli je skonfigurowano)
• Dostęp do narzędzi (różne listy dozwolonych i zabronionych narzędzi)
• Pamięć/kontekst (oddzielne pliki IDENTITY.md, SOUL.md itp.)

Jeden wyjątek jest celowo współdzielony: bufor kontekstu grupy (ostatnie wiadomości grupowe używane jako kontekst) jest współdzielony dla danego rozmówcy, dzięki czemu wszyscy agenci rozgłoszeniowi po wyzwoleniu widzą ten sam kontekst. Bufor jest czyszczony raz po zakończeniu rozesłania.

Pozwala to przypisać każdemu agentowi inną osobowość, modele, Skills i dostęp do narzędzi (na przykład tylko do odczytu albo do odczytu i zapisu).

Przykład: odizolowane sesje

W grupie 120363403215116621@g.us z agentami ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: ~/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: ~/openclaw-baerbel/Tools: read only

Przypadki użycia

• Zespoły wyspecjalizowanych agentów: grupa programistyczna, w której code-reviewer, security-auditor, test-generator i docs-checker odpowiadają na tę samą wiadomość, każdy ze swojej perspektywy.
• Obsługa wielu języków: jeden czat pomocy technicznej, na którym support-en, support-de i support-es odpowiadają w swoich językach.
• Zapewnianie jakości: support-agent odpowiada, a qa-agent sprawdza odpowiedź i reaguje tylko po wykryciu problemów.
• Automatyzacja zadań: task-tracker, time-logger i report-generator przetwarzają tę samą aktualizację stanu.

Najlepsze praktyki

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

{  "agents": {    "list": [      { "id": "reviewer", "tools": { "allow": ["read", "exec"] } },      { "id": "fixer", "tools": { "allow": ["read", "write", "edit", "exec"] } }    ]  }}

Zgodność

Dostawcy

Grupy rozgłoszeniowe są obecnie zaimplementowane wyłącznie dla WhatsApp (kanału internetowego). Inne kanały ignorują konfigurację broadcast.

Trasowanie

Grupy rozgłoszeniowe współdziałają z istniejącym trasowaniem:

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

• GROUP_A: odpowiada tylko alfred (zwykłe trasowanie).
• GROUP_B: odpowiadają agent1 ORAZ agent2 (rozgłaszanie).

Rozwiązywanie problemów

openclaw logs --follow | grep -i broadcast

Przykłady

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

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

Dokumentacja API

Schemat konfiguracji

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

Pola

Ograniczenia

1. Maksymalna liczba agentów: brak sztywnego limitu, ale duża liczba agentów (10+) może powodować spowolnienie.
2. Współdzielony kontekst: agenci nie widzą odpowiedzi innych agentów (zgodnie z założeniem).
3. Kolejność wiadomości: odpowiedzi przetwarzane równolegle mogą nadejść w dowolnej kolejności.
4. Limity częstotliwości: wszystkie odpowiedzi są wysyłane z jednego konta WhatsApp, dlatego odpowiedź każdego agenta wlicza się do tych samych limitów częstotliwości WhatsApp.

Powiązane

• Routing kanałów
• Grupy
• Narzędzia piaskownicy dla wielu agentów
• Parowanie
• Zarządzanie sesjami