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

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

Обзор

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

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

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

Развёртывайте нескольких агентов с атомарными, сфокусированными обязанностями:

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

Каждый агент обрабатывает одно и то же сообщение и предоставляет свою специализированную точку зрения.

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

Group: "International Support"
Agents:
  - Agent_EN (responds in English)
  - Agent_DE (responds in German)
  - Agent_ES (responds in Spanish)

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

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

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

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

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

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

Добавьте верхнеуровневый раздел broadcast (рядом с bindings). Ключи — это peer id WhatsApp:

групповые чаты: JID группы (например, [email protected])
DMs: E.164 номер телефона (например, +15551234567)

{
  "broadcast": {
    "[email protected]": ["alfred", "baerbel", "assistant3"]
  }
}

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

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

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

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

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

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": ["alfred", "baerbel"]
  }
}

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

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

{
  "broadcast": {
    "strategy": "sequential",
    "[email protected]": ["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",
    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],
    "[email protected]": ["support-en", "support-de"],
    "+15555550123": ["assistant", "logger"]
  }
}

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

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

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

Примечание: группы рассылки не обходят списки разрешённых каналов или правила активации групп (упоминания/команды и т. п.). Они лишь меняют какие агенты запускаются, когда сообщение допускается к обработке.

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

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

Ключи сеансов (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:

Session: agent:alfred:whatsapp:group:[email protected]
History: [user message, alfred's previous responses]
Workspace: /Users/pascal/openclaw-alfred/
Tools: read, write, exec

Контекст Bärbel:

Session: agent:baerbel:whatsapp:group:[email protected]
History: [user message, baerbel's previous responses]
Workspace: /Users/pascal/openclaw-baerbel/
Tools: read only

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

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

Проектируйте каждого агента с одной, чёткой ответственностью:

{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}

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

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

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

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

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

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

{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] } // Read-only
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] } // Read-write
    }
  }
}

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

При большом числе агентов учитывайте:

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

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

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

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.

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

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

Проверьте:

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

Отладка:

tail -f ~/.openclaw/logs/gateway.log | grep broadcast

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

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

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

Если медленно при большом числе агентов:

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

Примеры

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

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": [
      "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: «Исправил отступы и добавил аннотации типов»
security-scanner: «⚠️ Уязвимость SQL-инъекции в строке 12»
test-coverage: «Покрытие 45%, отсутствуют тесты для сценариев ошибок»
docs-checker: «Отсутствует docstring для функции process_data»

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

{
  "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": агенты обрабатывают в порядке массива
[peerId]: JID группы WhatsApp, номер E.164 или другой peer ID
- Значение: массив идентификаторов агентов, которые должны обрабатывать сообщения

Ограничения

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

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

Запланированные функции:

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

Обзор

Платформы обмена сообщениями

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

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

​Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

​Провайдеры

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

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

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

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

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

​Примеры

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

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

​Справочник API

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

​Поля

​Ограничения

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

​См. также

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

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Провайдеры

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

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

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

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

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

Примеры

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

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

Справочник API

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

Поля

Ограничения

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

См. также