Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Статус: Експериментально. Додано у 2026.1.9.

​
Огляд

Групи трансляції дають змогу кільком агентам обробляти одне й те саме повідомлення та відповідати на нього одночасно. Це дає змогу створювати спеціалізовані команди агентів, які працюють разом в одній групі WhatsApp або особистому чаті — і все це з використанням одного номера телефону. Поточна область застосування: лише WhatsApp (вебканал). Групи трансляції оцінюються після списків дозволених каналів і правил активації груп. У групах WhatsApp це означає, що трансляції відбуваються тоді, коли OpenClaw зазвичай відповідав би (наприклад, за згадкою, залежно від налаштувань вашої групи).

​
Сценарії використання

Розгорніть кількох агентів з атомарними, сфокусованими обов’язками:
Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)
Кожен агент обробляє одне й те саме повідомлення та надає свою спеціалізовану перспективу.
Group: "International Support"
Agents:
  - Agent_EN (responds in English)
  - Agent_DE (responds in German)
  - Agent_ES (responds in Spanish)

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

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

​
Конфігурація

​
Базове налаштування

Додайте розділ верхнього рівня broadcast (поруч із bindings). Ключі — це ідентифікатори peer WhatsApp:
  • групові чати: JID групи (наприклад, 120363403215116621@g.us)
  • особисті чати: номер телефону E.164 (наприклад, +15551234567)
{
  "broadcast": {
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
  }
}
Результат: Коли OpenClaw мав би відповісти в цьому чаті, він запустить усіх трьох агентів.

​
Стратегія обробки

Керуйте тим, як агенти обробляють повідомлення:
Усі агенти обробляють одночасно:
{
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"]
  }
}

​
Повний приклад

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

​
Як це працює

​
Потік повідомлень

1

Надходить вхідне повідомлення

Надходить повідомлення з групи WhatsApp або особистого чату.
2

Перевірка трансляції

Система перевіряє, чи є ідентифікатор peer у broadcast.
3

Якщо є у списку трансляції

  • Усі перелічені агенти обробляють повідомлення.
  • Кожен агент має власний ключ сесії та ізольований контекст.
  • Агенти обробляють паралельно (типово) або послідовно.
4

Якщо немає у списку трансляції

Застосовується звичайна маршрутизація (перше відповідне прив’язування).
Групи трансляції не обходять списки дозволених каналів або правила активації груп (згадки/команди тощо). Вони лише змінюють, які агенти запускаються, коли повідомлення придатне для обробки.

​
Ізоляція сесій

Кожен агент у групі трансляції підтримує повністю окремі:
  • Ключі сесій (agent:alfred:whatsapp:group:120363... проти agent:baerbel:whatsapp:group:120363...)
  • Історію розмови (агент не бачить повідомлень інших агентів)
  • Робочий простір (окремі пісочниці, якщо налаштовано)
  • Доступ до інструментів (різні списки дозволу/заборони)
  • Пам’ять/контекст (окремі IDENTITY.md, SOUL.md тощо)
  • Буфер групового контексту (нещодавні повідомлення групи, що використовуються як контекст) спільний для кожного peer, тому всі агенти трансляції бачать один і той самий контекст під час запуску
Це дає змогу кожному агенту мати:
  • Різні персоналії
  • Різний доступ до інструментів (наприклад, лише читання або читання-запис)
  • Різні моделі (наприклад, opus проти sonnet)
  • Різні встановлені Skills

​
Приклад: ізольовані сесії

У групі 120363403215116621@g.us з агентами ["alfred", "baerbel"]: 
Session: agent:alfred:whatsapp:group:120363403215116621@g.us
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

​
Найкращі практики

Проєктуйте кожного агента з однією чіткою відповідальністю:
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
✅ Добре: Кожен агент має одне завдання. ❌ Погано: Один загальний агент “dev-helper”.
Зробіть зрозумілим, що робить кожен агент:
{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}
Надавайте агентам лише потрібні їм інструменти:
{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}
reviewer має доступ лише для читання. fixer може читати й писати.
За великої кількості агентів врахуйте:
  • Використання "strategy": "parallel" (типово) для швидкості
  • Обмеження груп трансляції до 5-10 агентів
  • Використання швидших моделей для простіших агентів
Агенти зазнають збоїв незалежно. Помилка одного агента не блокує інших:
Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

​
Сумісність

​
Провайдери

Групи трансляції зараз працюють із:
  • ✅ WhatsApp (реалізовано)
  • 🚧 Telegram (заплановано)
  • 🚧 Discord (заплановано)
  • 🚧 Slack (заплановано)

​
Маршрутизація

Групи трансляції працюють разом з наявною маршрутизацією: 
{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}
  • GROUP_A: відповідає лише alfred (звичайна маршрутизація).
  • GROUP_B: відповідають agent1 І agent2 (трансляція).
Пріоритет: broadcast має пріоритет над bindings.

​
Усунення несправностей

Перевірте:
  1. Ідентифікатори агентів існують у agents.list.
  2. Формат ідентифікатора peer правильний (наприклад, 120363403215116621@g.us).
  3. Агентів немає у списках заборони.
Налагодження:
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
Причина: Ідентифікатор peer може бути в bindings, але не в broadcast.Виправлення: Додайте до конфігурації трансляції або видаліть із прив’язувань.
Якщо повільно з багатьма агентами:
  • Зменште кількість агентів у групі.
  • Використовуйте легші моделі (sonnet замість opus).
  • Перевірте час запуску пісочниці.

​
Приклади

{
  "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"] } }
    ]
  }
}
Користувач надсилає: Фрагмент коду.Відповіді:
  • code-formatter: “Fixed indentation and added type hints”
  • security-scanner: “⚠️ SQL injection vulnerability in line 12”
  • test-coverage: “Coverage is 45%, missing tests for error cases”
  • docs-checker: “Missing docstring for function process_data”
{
  "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

​
Схема конфігурації

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

​
Поля

​
strategy
"parallel" | "sequential"
за замовчуванням:"\"parallel\""
Як обробляти агентів. parallel запускає всіх агентів одночасно; sequential запускає їх у порядку масиву.
​
[peerId]
string[]
JID групи WhatsApp, номер E.164 або інший ідентифікатор peer. Значення — це масив ідентифікаторів агентів, які мають обробляти повідомлення.

​
Обмеження

  1. Максимум агентів: Жорсткого обмеження немає, але 10+ агентів можуть працювати повільно.
  2. Спільний контекст: Агенти не бачать відповіді один одного (за задумом).
  3. Порядок повідомлень: Паралельні відповіді можуть надходити в будь-якому порядку.
  4. Обмеження частоти: Усі агенти враховуються в обмеженнях частоти WhatsApp.

​
Майбутні покращення

Заплановані функції:
  • Режим спільного контексту (агенти бачать відповіді один одного)
  • Координація агентів (агенти можуть сигналізувати один одному)
  • Динамічний вибір агентів (вибір агентів на основі вмісту повідомлення)
  • Пріоритети агентів (деякі агенти відповідають раніше за інших)

​
Пов’язане