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

Broadcast Groups

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

Обзор

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

Примеры использования

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

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

Group: "Development Team"
Agents:
  - CodeReviewer (рецензирует фрагменты кода)
  - DocumentationBot (генерирует документацию)
  - SecurityAuditor (проверяет на уязвимости)
  - TestGenerator (предлагает тестовые сценарии)

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

2. Поддержка нескольких языков

Group: "International Support"
Agents:
  - Agent_EN (отвечает на английском)
  - Agent_DE (отвечает на немецком)
  - Agent_ES (отвечает на испанском)

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

Group: "Customer Support"
Agents:
  - SupportAgent (предоставляет ответ)
  - QAAgent (проверяет качество, отвечает только при обнаружении проблем)

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

Group: "Project Management"
Agents:
  - TaskTracker (обновляет базу данных задач)
  - TimeLogger (логирует затраченное время)
  - ReportGenerator (создает сводки)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Изоляция сессий

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

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

Это позволяет каждому агенту иметь:

• Разные личности
• Разный доступ к инструментам (например, только чтение vs чтение-запись)
• Разные модели (например, opus vs sonnet)
• Разные установленные навыки

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

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

Session: agent:alfred:whatsapp:group:120363403215116621@g.us
History: [user message, alfred's previous responses]
Workspace: /Users/pascal/openclaw-alfred/
Tools: read, write, exec

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

Session: agent:baerbel:whatsapp:group:120363403215116621@g.us
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"] } // Только чтение
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] } // Чтение-запись
    }
  }
}

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.

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

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

Проверьте:

1. ID агентов существуют в agents.list
2. Формат ID пира корректен (например, 120363403215116621@g.us)
3. Агенты не находятся в списках запрета

Отладка:

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

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

Причина: ID пира может быть в bindings, но не в broadcast. Решение: Добавьте в конфигурацию рассылки или удалите из привязок.

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

Если медленно с многими агентами:

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

Примеры

Пример 1: Команда рецензирования кода

{
  "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: “Исправил отступы и добавил подсказки типов”
• security-scanner: “⚠️ Уязвимость SQL-инъекции в строке 12”
• test-coverage: “Покрытие составляет 45%, отсутствуют тесты для случаев ошибок”
• docs-checker: “Отсутствует строка документации для функции 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 или другой ID пира
  • Значение: Массив ID агентов, которые должны обрабатывать сообщения

Ограничения

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

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

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

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

Смотрите также

• Конфигурация Multi-Agent
• Конфигурация маршрутизации
• Управление сессиями

ГруппыМаршрутизация каналов