> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grupy rozgłoszeniowe

<Note>
  **Status:** Eksperymentalne. Dodano w 2026.1.9.
</Note>

## Przegląd

Grupy rozgłaszania umożliwiają wielu agentom jednoczesne przetwarzanie tej samej wiadomości i odpowiadanie na nią. Pozwala to tworzyć wyspecjalizowane zespoły agentów, które współpracują w jednej grupie WhatsApp lub wiadomości prywatnej — wszystkie z użyciem jednego numeru telefonu.

Bieżący zakres: **tylko WhatsApp** (kanał web).

Grupy rozgłaszania są oceniane po listach dozwolonych kanałów i regułach aktywacji grup. W grupach WhatsApp oznacza to, że rozgłaszanie następuje wtedy, gdy OpenClaw normalnie by odpowiedział (na przykład: po wzmiance, zależnie od ustawień grupy).

Aktywna ścieżka QA WhatsApp obejmuje `whatsapp-broadcast-group-fanout`, która sprawdza, czy jedna wspomniana wiadomość grupowa może wygenerować odrębne widoczne odpowiedzi od dwóch skonfigurowanych agentów.

## Przypadki użycia

<AccordionGroup>
  <Accordion title="1. Wyspecjalizowane zespoły agentów">
    Wdrażaj wielu agentów z atomowymi, skoncentrowanymi odpowiedzialnościami:

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

    Każdy agent przetwarza tę samą wiadomość i przedstawia swoją wyspecjalizowaną perspektywę.
  </Accordion>

  <Accordion title="2. Obsługa wielu języków">
    ```
    Group: "International Support"
    Agents:
      - Agent_EN (responds in English)
      - Agent_DE (responds in German)
      - Agent_ES (responds in Spanish)
    ```
  </Accordion>

  <Accordion title="3. Przepływy zapewniania jakości">
    ```
    Group: "Customer Support"
    Agents:
      - SupportAgent (provides answer)
      - QAAgent (reviews quality, only responds if issues found)
    ```
  </Accordion>

  <Accordion title="4. Automatyzacja zadań">
    ```
    Group: "Project Management"
    Agents:
      - TaskTracker (updates task database)
      - TimeLogger (logs time spent)
      - ReportGenerator (creates summaries)
    ```
  </Accordion>
</AccordionGroup>

## Konfiguracja

### Podstawowa konfiguracja

Dodaj sekcję najwyższego poziomu `broadcast` (obok `bindings`). Klucze to identyfikatory peerów WhatsApp:

* czaty grupowe: JID grupy (np. `120363403215116621@g.us`)
* wiadomości prywatne: numer telefonu E.164 (np. `+15551234567`)

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

**Wynik:** Gdy OpenClaw odpowiadałby w tym czacie, uruchomi wszystkich trzech agentów.

### Strategia przetwarzania

Steruj tym, jak agenci przetwarzają wiadomości:

<Tabs>
  <Tab title="parallel (domyślnie)">
    Wszyscy agenci przetwarzają jednocześnie:

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

  <Tab title="sequential">
    Agenci przetwarzają po kolei (jeden czeka, aż poprzedni zakończy):

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

### Pełny przykład

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

## Jak to działa

### Przepływ wiadomości

<Steps>
  <Step title="Nadchodzi wiadomość przychodząca">
    Nadchodzi wiadomość z grupy WhatsApp lub wiadomość prywatna.
  </Step>

  <Step title="Trasowanie i dopuszczenie">
    OpenClaw stosuje listy dozwolonych kanałów, reguły aktywacji grup oraz skonfigurowaną własność powiązań ACP.
  </Step>

  <Step title="Sprawdzenie rozgłaszania">
    Jeśli żadne skonfigurowane powiązanie ACP nie jest właścicielem trasy, OpenClaw sprawdza, czy identyfikator peera znajduje się w `broadcast`.
  </Step>

  <Step title="Jeśli rozgłaszanie ma zastosowanie">
    * Wszyscy wymienieni agenci przetwarzają wiadomość.
    * Każdy agent ma własny klucz sesji i izolowany kontekst.
    * Agenci przetwarzają równolegle (domyślnie) lub sekwencyjnie.
  </Step>

  <Step title="Jeśli rozgłaszanie nie ma zastosowania">
    OpenClaw przekazuje zwykłą trasę albo skonfigurowaną trasę sesji ACP wybraną podczas trasowania.
  </Step>
</Steps>

<Note>
  Grupy rozgłaszania nie omijają list dozwolonych kanałów ani reguł aktywacji grup (wzmianki/polecenia/itd.). Zmieniają tylko *to, którzy agenci są uruchamiani*, gdy wiadomość kwalifikuje się do przetwarzania.
</Note>

### Izolacja sesji

Każdy agent w grupie rozgłaszania utrzymuje całkowicie oddzielne:

* **Klucze sesji** (`agent:alfred:whatsapp:group:120363...` vs `agent:baerbel:whatsapp:group:120363...`)
* **Historię rozmowy** (agent nie widzi wiadomości innych agentów)
* **Obszar roboczy** (oddzielne sandboxy, jeśli skonfigurowano)
* **Dostęp do narzędzi** (różne listy dozwolonych/zabronionych)
* **Pamięć/kontekst** (oddzielne IDENTITY.md, SOUL.md itd.)
* **Bufor kontekstu grupy** (ostatnie wiadomości grupowe używane jako kontekst) jest współdzielony na peera, więc wszyscy agenci rozgłaszania widzą ten sam kontekst po wyzwoleniu

Dzięki temu każdy agent może mieć:

* Różne osobowości
* Różny dostęp do narzędzi (np. tylko do odczytu vs. odczyt i zapis)
* Różne modele (np. opus vs. sonnet)
* Różne zainstalowane Skills

### Przykład: izolowane sesje

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

<Tabs>
  <Tab title="Kontekst Alfreda">
    ```
    Session: agent:alfred:whatsapp:group:120363403215116621@g.us
    History: [user message, alfred's previous responses]
    Workspace: /Users/user/openclaw-alfred/
    Tools: read, write, exec
    ```
  </Tab>

  <Tab title="Kontekst Bärbel">
    ```
    Session: agent:baerbel:whatsapp:group:120363403215116621@g.us
    History: [user message, baerbel's previous responses]
    Workspace: /Users/user/openclaw-baerbel/
    Tools: read only
    ```
  </Tab>
</Tabs>

## Najlepsze praktyki

<AccordionGroup>
  <Accordion title="1. Utrzymuj agentów w wąskim zakresie">
    Projektuj każdego agenta z jedną, jasno określoną odpowiedzialnością:

    ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      "broadcast": {
        "DEV_GROUP": ["formatter", "linter", "tester"]
      }
    }
    ```

    ✅ **Dobrze:** Każdy agent ma jedno zadanie. ❌ **Źle:** Jeden ogólny agent „dev-helper”.
  </Accordion>

  <Accordion title="2. Używaj opisowych nazw">
    Wyjaśnij, co robi każdy agent:

    ```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" }
      }
    }
    ```
  </Accordion>

  <Accordion title="3. Skonfiguruj różny dostęp do narzędzi">
    Przyznawaj agentom tylko te narzędzia, których potrzebują:

    ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      "agents": {
        "reviewer": {
          "tools": { "allow": ["read", "exec"] }
        },
        "fixer": {
          "tools": { "allow": ["read", "write", "edit", "exec"] }
        }
      }
    }
    ```

    `reviewer` ma tylko odczyt. `fixer` może czytać i pisać.
  </Accordion>

  <Accordion title="4. Monitoruj wydajność">
    Przy wielu agentach rozważ:

    * Użycie `"strategy": "parallel"` (domyślnie) dla szybkości
    * Ograniczenie grup rozgłaszania do 5-10 agentów
    * Użycie szybszych modeli dla prostszych agentów
  </Accordion>

  <Accordion title="5. Obsługuj awarie w sposób łagodny">
    Agenci zawodzą niezależnie. Błąd jednego agenta nie blokuje pozostałych:

    ```
    Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
    Result: Agent A and C respond, Agent B logs error
    ```
  </Accordion>
</AccordionGroup>

## Zgodność

### Dostawcy

Grupy rozgłaszania obecnie działają z:

* ✅ WhatsApp (zaimplementowano)
* 🚧 Telegram (planowane)
* 🚧 Discord (planowane)
* 🚧 Slack (planowane)

### Trasowanie

Grupy rozgłaszania działają razem z istniejącym trasowaniem:

```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`: Odpowiada tylko alfred (normalne trasowanie).
* `GROUP_B`: Odpowiadają agent1 ORAZ agent2 (rozgłaszanie).

<Note>
  **Pierwszeństwo:** `broadcast` ma pierwszeństwo przed zwykłymi powiązaniami tras. Skonfigurowane powiązania ACP (`bindings[].type="acp"`) są wyłączne: gdy jedno pasuje, OpenClaw przekazuje do skonfigurowanej sesji ACP zamiast rozgłaszania fan-out.
</Note>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Agenci nie odpowiadają">
    **Sprawdź:**

    1. Identyfikatory agentów istnieją w `agents.list`.
    2. Format identyfikatora peera jest poprawny (np. `120363403215116621@g.us`).
    3. Agentów nie ma na listach zabronionych.

    **Debugowanie:**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    tail -f ~/.openclaw/logs/gateway.log | grep broadcast
    ```
  </Accordion>

  <Accordion title="Odpowiada tylko jeden agent">
    **Przyczyna:** Identyfikator peera może znajdować się w zwykłych powiązaniach tras, ale nie w `broadcast`, albo może pasować do wyłącznego skonfigurowanego powiązania ACP.

    **Poprawka:** Dodaj peery powiązane ze zwykłymi trasami do konfiguracji rozgłaszania albo usuń/zmień skonfigurowane powiązanie ACP, jeśli oczekiwane jest rozgłaszanie fan-out.
  </Accordion>

  <Accordion title="Problemy z wydajnością">
    Jeśli działanie jest wolne przy wielu agentach:

    * Zmniejsz liczbę agentów na grupę.
    * Użyj lżejszych modeli (sonnet zamiast opus).
    * Sprawdź czas uruchamiania sandboxa.
  </Accordion>
</AccordionGroup>

## Przykłady

<AccordionGroup>
  <Accordion title="Przykład 1: Zespół przeglądu kodu">
    ```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"] } }
        ]
      }
    }
    ```

    **Użytkownik wysyła:** Fragment kodu.

    **Odpowiedzi:**

    * code-formatter: „Naprawiono wcięcia i dodano wskazówki typów”
    * security-scanner: „⚠️ Luka SQL injection w wierszu 12”
    * test-coverage: „Pokrycie wynosi 45%, brakuje testów dla przypadków błędów”
    * docs-checker: „Brak docstringa dla funkcji `process_data`”
  </Accordion>

  <Accordion title="Przykład 2: Obsługa wielu języków">
    ```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" }
        ]
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Dokumentacja API

### Schemat konfiguracji

```typescript theme={"theme":{"light":"min-light","dark":"min-dark"}}
interface OpenClawConfig {
  broadcast?: {
    strategy?: "parallel" | "sequential";
    [peerId: string]: string[];
  };
}
```

### Pola

<ParamField path="strategy" type="&#x22;parallel&#x22; | &#x22;sequential&#x22;" default="&#x22;parallel&#x22;">
  Sposób przetwarzania agentów. `parallel` uruchamia wszystkich agentów jednocześnie; `sequential` uruchamia ich w kolejności z tablicy.
</ParamField>

<ParamField path="[peerId]" type="string[]">
  JID grupy WhatsApp, numer E.164 lub inny identyfikator peera. Wartością jest tablica identyfikatorów agentów, którzy powinni przetwarzać wiadomości.
</ParamField>

## Ograniczenia

1. **Maksymalna liczba agentów:** Brak twardego limitu, ale 10+ agentów może działać wolno.
2. **Wspólny kontekst:** Agenci nie widzą swoich wzajemnych odpowiedzi (z założenia).
3. **Kolejność wiadomości:** Odpowiedzi równoległe mogą nadejść w dowolnej kolejności.
4. **Limity szybkości:** Wszyscy agenci wliczają się do limitów szybkości WhatsApp.

## Przyszłe ulepszenia

Planowane funkcje:

* [ ] Tryb wspólnego kontekstu (agenci widzą swoje wzajemne odpowiedzi)
* [ ] Koordynacja agentów (agenci mogą sygnalizować sobie nawzajem)
* [ ] Dynamiczny wybór agentów (wybieranie agentów na podstawie treści wiadomości)
* [ ] Priorytety agentów (niektórzy agenci odpowiadają przed innymi)

## Powiązane

* [Routing kanałów](/pl/channels/channel-routing)
* [Grupy](/pl/channels/groups)
* [Narzędzia piaskownicy wieloagentowej](/pl/tools/multi-agent-sandbox-tools)
* [Parowanie](/pl/channels/pairing)
* [Zarządzanie sesją](/pl/concepts/session)