Группы рассылки

Обзор

Группы рассылки запускают несколько агентов для одного входящего сообщения. Каждый агент обрабатывает сообщение в собственном изолированном сеансе и публикует свой ответ, поэтому один номер WhatsApp может обслуживать команду специализированных агентов в одном групповом чате или личной переписке.

Группы рассылки проверяются после списков разрешённых каналов и правил активации групп. В группах WhatsApp рассылка выполняется, когда OpenClaw обычно должен ответить (например, при упоминании — в зависимости от настроек группы). Она изменяет только то, какие агенты запускаются, но не определяет, допускается ли сообщение к обработке.

Активный контур контроля качества WhatsApp включает whatsapp-broadcast-group-fanout, который проверяет, что одно сообщение с упоминанием в группе может привести к появлению разных видимых ответов от двух настроенных агентов.

Конфигурация

Базовая настройка

Добавьте раздел верхнего уровня broadcast (рядом с bindings). Ключи — идентификаторы собеседников WhatsApp, значения — массивы идентификаторов агентов:

• групповые чаты: JID группы (например, 120363403215116621@g.us)
• личные сообщения: номер телефона отправителя в формате E.164 (например, +15551234567)

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

Результат: когда OpenClaw должен ответить в этом чате, запускаются все три агента.

Каждый указанный идентификатор агента должен существовать в agents.list: проверка конфигурации сообщает о неизвестных идентификаторах, а среда выполнения пропускает их с предупреждением Broadcast agent <id> not found in agents.list; skipping.

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

broadcast.strategy определяет, как агенты обрабатывают сообщение:

{  "broadcast": {    "strategy": "sequential",    "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"]  }}

Принцип работы

Поток сообщений

Изоляция сеансов

Для каждого агента в группе рассылки полностью разделены:

• Ключи сеансов (agent:alfred:whatsapp:group:120363... и agent:baerbel:whatsapp:group:120363...)
• История переписки (агент не видит ответы других агентов)
• Рабочее пространство (отдельные песочницы, если они настроены)
• Доступ к инструментам (разные списки разрешений и запретов)
• Память и контекст (отдельные IDENTITY.md, SOUL.md и т. д.)

Одно исключение намеренно является общим: буфер контекста группы (последние сообщения группы, используемые для контекста) совместно используется для каждого собеседника, поэтому при запуске все агенты рассылки видят одинаковый контекст. Он очищается один раз после завершения разветвления.

Благодаря этому агенты могут иметь разные характеры, модели, навыки и права доступа к инструментам (например, только чтение или чтение и запись).

Пример: изолированные сеансы

В группе 120363403215116621@g.us с агентами ["alfred", "baerbel"]:

Сеанс: agent:alfred:whatsapp:group:120363403215116621@g.usИстория: [сообщение пользователя, предыдущие ответы alfred]Рабочее пространство: ~/openclaw-alfred/Инструменты: чтение, запись, выполнение

Сеанс: agent:baerbel:whatsapp:group:120363403215116621@g.usИстория: [сообщение пользователя, предыдущие ответы baerbel]Рабочее пространство: ~/openclaw-baerbel/Инструменты: только чтение

Сценарии использования

• Команды специализированных агентов: группа разработчиков, в которой code-reviewer, security-auditor, test-generator и docs-checker отвечают на одно сообщение каждый со своей точки зрения.
• Многоязычная поддержка: один чат поддержки, в котором support-en, support-de и support-es отвечают на своих языках.
• Контроль качества: support-agent отвечает, а qa-agent проверяет ответ и отвечает только при обнаружении проблем.
• Автоматизация задач: task-tracker, time-logger и report-generator получают одно и то же обновление состояния.

Рекомендации

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

Совместимость

Провайдеры

В настоящее время группы рассылки реализованы только для WhatsApp (веб-канал). Другие каналы игнорируют конфигурацию broadcast.

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

Группы рассылки работают вместе с существующей маршрутизацией:

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

• GROUP_A: отвечает только alfred (обычная маршрутизация).
• GROUP_B: отвечают agent1 И agent2 (рассылка).

Устранение неполадок

openclaw logs --follow | grep -i broadcast

Примеры

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

Справочник API

Схема конфигурации

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

Поля

Ограничения

1. Максимальное количество агентов: жёсткого ограничения нет, но большое количество агентов (10+) может замедлить работу.
2. Общий контекст: агенты не видят ответы друг друга (это предусмотрено архитектурой).
3. Порядок сообщений: параллельные ответы могут поступать в любом порядке.
4. Ограничения частоты запросов: все ответы отправляются из одной учётной записи WhatsApp, поэтому ответ каждого агента учитывается в общих ограничениях частоты запросов WhatsApp.

Связанные материалы

• Маршрутизация каналов
• Группы
• Инструменты песочницы для нескольких агентов
• Сопряжение
• Управление сеансами