Skip to main content

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

Статус: Экспериментально
Версия: Добавлено в 2026.1.9

Обзор

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

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

1. Специализированные команды агентов

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

2. Многоязычная поддержка

3. Процессы контроля качества

4. Автоматизация задач

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

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

Добавьте верхнеуровневый раздел broadcast (рядом с bindings). Ключи — это peer id WhatsApp:
  • групповые чаты: JID группы (например, [email protected])
  • DMs: E.164 номер телефона (например, +15551234567)
Результат: Когда OpenClaw должен ответить в этом чате, он запустит всех трёх агентов.

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

Управляйте тем, как агенты обрабатывают сообщения:

Параллельно (по умолчанию)

Все агенты обрабатывают одновременно:

Последовательно

Агенты обрабатывают по порядку (каждый ждёт завершения предыдущего):

Полный пример

Как это работает

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

  1. Входящее сообщение поступает в группу WhatsApp
  2. Проверка рассылки: система проверяет, есть ли peer ID в broadcast
  3. Если в списке рассылки:
    • Все перечисленные агенты обрабатывают сообщение
    • У каждого агента свой ключ сеанса и изолированный контекст
    • Агенты обрабатывают параллельно (по умолчанию) или последовательно
  4. Если не в списке рассылки:
    • Применяется обычная маршрутизация (первое совпадающее связывание)
Примечание: группы рассылки не обходят списки разрешённых каналов или правила активации групп (упоминания/команды и т. п.). Они лишь меняют какие агенты запускаются, когда сообщение допускается к обработке.

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

Каждый агент в группе рассылки поддерживает полностью отдельные:
  • Ключи сеансов (agent:alfred:whatsapp:group:120363... vs agent:baerbel:whatsapp:group:120363...)
  • Историю диалога (агент не видит сообщения других агентов)
  • Рабочее пространство (отдельные sandbox при настройке)
  • Доступ к инструментам (разные списки разрешений/запретов)
  • Память/контекст (отдельные IDENTITY.md, SOUL.md и т. д.)
  • Буфер контекста группы (последние сообщения группы, используемые для контекста) — общий для peer, поэтому все агенты рассылки видят один и тот же контекст при срабатывании
Это позволяет каждому агенту иметь:
  • Разные личности
  • Разный доступ к инструментам (например, только чтение vs. чтение-запись)
  • Разные модели (например, opus vs. sonnet)
  • Разные установленные навыки

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

В группе [email protected] с агентами ["alfred", "baerbel"]: Контекст Alfred:
Контекст Bärbel:

Лучшие практики

1. Сохраняйте фокус агентов

Проектируйте каждого агента с одной, чёткой ответственностью:
Хорошо: у каждого агента одна задача
Плохо: один универсальный агент «dev-helper»

2. Используйте описательные имена

Делайте понятным, что делает каждый агент:

3. Настраивайте разный доступ к инструментам

Давайте агентам только те инструменты, которые им нужны:

4. Следите за производительностью

При большом числе агентов учитывайте:
  • Использование "strategy": "parallel" (по умолчанию) для скорости
  • Ограничение групп рассылки 5–10 агентами
  • Применение более быстрых моделей для простых агентов

5. Корректно обрабатывайте сбои

Агенты падают независимо. Ошибка одного агента не блокирует других:

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

Провайдеры

Группы рассылки в настоящее время работают с:
  • ✅ WhatsApp (реализовано)
  • 🚧 Telegram (планируется)
  • 🚧 Discord (планируется)
  • 🚧 Slack (планируется)

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

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

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

Агенты не отвечают

Проверьте:
  1. Идентификаторы агентов существуют в agents.list
  2. Формат peer ID корректен (например, [email protected])
  3. Агенты не находятся в списках запрета
Отладка:

Отвечает только один агент

Причина: peer ID может находиться в bindings, но отсутствовать в broadcast. Исправление: добавьте в конфиг рассылки или удалите из привязок.

Проблемы с производительностью

Если медленно при большом числе агентов:
  • Уменьшите число агентов на группу
  • Используйте более лёгкие модели (sonnet вместо opus)
  • Проверьте время запуска sandbox

Примеры

Пример 1: Команда код-ревью

Пользователь отправляет: фрагмент кода
Ответы:
  • code-formatter: «Исправил отступы и добавил аннотации типов»
  • security-scanner: «⚠️ Уязвимость SQL-инъекции в строке 12»
  • test-coverage: «Покрытие 45%, отсутствуют тесты для сценариев ошибок»
  • docs-checker: «Отсутствует docstring для функции process_data»

Пример 2: Многоязычная поддержка

Справочник API

Схема конфига

Поля

  • strategy (необязательно): способ обработки агентов
    • "parallel" (по умолчанию): все агенты обрабатывают одновременно
    • "sequential": агенты обрабатывают в порядке массива
  • [peerId]: JID группы WhatsApp, номер E.164 или другой peer ID
    • Значение: массив идентификаторов агентов, которые должны обрабатывать сообщения

Ограничения

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

Будущие улучшения

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

См. также