Группы трансляции

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

Обзор

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

Текущая область применения: только WhatsApp (веб-канал).

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

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

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

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

Группа: "Команда разработки"
Агенты:
  - CodeReviewer (проверяет фрагменты кода)
  - DocumentationBot (генерирует документацию)
  - SecurityAuditor (проверяет уязвимости)
  - TestGenerator (предлагает тестовые кейсы)

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

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

Группа: "Международная поддержка"
Агенты:
  - Agent_EN (отвечает на английском)
  - Agent_DE (отвечает на немецком)
  - Agent_ES (отвечает на испанском)

3. Рабочие процессы контроля качества

Группа: "Поддержка клиентов"
Агенты:
  - SupportAgent (предоставляет ответ)
  - QAAgent (проверяет качество, отвечает только при обнаружении проблем)

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

Группа: "Управление проектами"
Агенты:
  - TaskTracker (обновляет базу задач)
  - TimeLogger (регистрирует затраченное время)
  - ReportGenerator (создает сводки)

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

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

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

  • групповые чаты: group JID (например, [email protected])
  • личные сообщения: номер телефона 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"]
  }
}

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

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

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

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

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

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

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

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

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

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

В группе [email protected] с агентами ["alfred", "baerbel"]:

Контекст Alfred:

Session: agent:alfred:whatsapp:group:[email protected]
History: [сообщение пользователя, предыдущие ответы alfred]
Workspace: /Users/pascal/openclaw-alfred/
Tools: read, write, exec

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

Session: agent:baerbel:whatsapp:group:[email protected]  
History: [сообщение пользователя, предыдущие ответы baerbel]
Workspace: /Users/pascal/openclaw-baerbel/
Tools: только чтение

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

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 ✗ ошибка, Agent C ✓]
Результат: Agent A и C отвечают, Agent B логирует ошибку

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

Провайдеры

Группы трансляции в настоящее время работают с:

  • ✅ 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. Формат peer ID корректен (например, [email protected])
  3. Агенты не в списках запрета

Отладка:

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

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

Причина: Peer ID может быть в bindings, но не в broadcast.

Решение: Добавьте в конфигурацию broadcast или удалите из bindings.

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

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

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

Примеры

Пример 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]: WhatsApp group JID, номер E.164 или другой peer ID

    • Значение: Массив ID агентов, которые должны обрабатывать сообщения

Ограничения

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

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

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

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

См. также

← Назад к документации