Многоагентная система — это команда специализированных ИИ-агентов с изолированными workspace, общей памятью и инструментами межагентского общения. В OpenClaw это реализовано через встроенный Multi-Agent Routing (с февраля 2026) и инструменты sessions\\\_send / sessions\\\_spawn. Альтернативы типа CrewAI или AutoGen требуют отдельного стека зависимостей и обвязки; здесь всё работает в одном контуре.

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

Что это

Multi-Agent Routing в OpenClaw — это архитектура, при которой один Telegram-канал или API-точка входа распределяет задачи между несколькими изолированными субагентами. У каждого свой workspace, свои файлы памяти (SOUL.md, AGENTS.md, USER.md), свои auth-профили и наборы инструментов. Связь между агентами — через явные сообщения, а не через общий контекст.

Типичный набор ролей в production-команде: CEO (оркестратор, ставит задачи и собирает результат), Coder (пишет код), Analyst (исследования, разбор данных), Manager (таск-трекер, напоминания, отчётность). При необходимости добавляются Designer, Lawyer, Sales, Accountant.

Зачем нужно

  • Специализация: каждый агент — мастер в своей области, как в реальной команде, а не универсал с размытой экспертизой
  • Параллельная работа: Analyst изучает конкурентов, пока Coder поднимает репозиторий, время выполнения сокращается в разы
  • Изоляция памяти: контекст Coder не путается с маркетинговыми исследованиями Analyst, ошибки не утекают между доменами
  • Безопасность: каждому агенту можно выдать только нужные инструменты (только read, только конкретный API) и закрыть в отдельный sandbox
  • Масштабирование: новые роли добавляются без потери качества остальной команды, ядро не переписывается

Как устроено

Архитектура состоит из четырёх слоёв: маршрутизация входящих сообщений, изолированные workspace агентов, межагентская шина сообщений и единый gateway с правами доступа.

  • Gateway (~/.openclaw/gateway.json) — точка входа: Telegram, API, CLI, маршрутизация на агентов.
  • Agent workspace (~/.openclaw/workspace-<role>/) — изолированная папка с SOUL/AGENTS/USER и памятью.
  • A2A-шина (openclaw.json) — межагентские сообщения через sessions\_send и sessions\_spawn.
  • Auth-профили (~/.openclaw/agents/<role>/auth/) — раздельные ключи и токены на каждого агента.
  • Cron/Heartbeat (openclaw cron list) — фоновые задачи: ежедневные отчёты, проверки.

Когда использовать

Проект на одного человека, простые задачи:

не подходит. Избыточно: один агент справится, добавление 4 ролей замедлит работу.

Стартап-команда:

разработка, маркетинг, аналитика: базовый сетап. Четыре роли закрывают 80 процентов задач: CEO, Coder, Analyst, Manager.

Production-агенты под клиента с разделением доступов:

обязательно. Изоляция workspace и прав снижает риск утечки данных между доменами.

Исследовательский проект, быстрые эксперименты:

не на старте. Multi-agent добавляет latency и стоимость, для прототипа хватит одного агента.

Команда больше 8 агентов:

подходит, но с инфраструктурой. Один сервер не вытянет: нужен второй VPS или Docker-композиция, балансировка.

Пример: запуск четырёх ролей в OpenClaw

Минимальный сетап за 5-10 минут. Терминал и уже установленный OpenClaw.

# Создаём четырёх агентов
for role in ceo coder analyst manager; do
  openclaw agents add $role
done

# Проверяем, что все на месте
openclaw agents list

После выполнения команд каждый агент получил свою папку в ~/.openclaw/agents/ и собственный workspace. Дальше — редактируем SOUL.md в каждом workspace, чтобы прописать роль, границы, инструменты. CEO получает право делегировать, Coder — писать код и коммитить, Analyst — читать и искать, Manager — работать с таск-трекером и cron.

Включаем межагентское общение в openclaw.json:

{
  "a2a": {
    "enabled": true,
    "allowedPairs": [
      ["ceo", "coder"],
      ["ceo", "analyst"],
      ["ceo", "manager"]
    ]
  }
}

После перезапуска gateway агенты могут отправлять друг другу сообщения через sessions\\\_send и sessions\\\_spawn.

Реальный сценарий: CEO получает в Telegram задачу «запустить лендинг для фитнес-коуча, бюджет $1500». Дальше сам раздаёт: Analyst ищет конкурентов, Coder поднимает репозиторий с Next.js, Manager создаёт задачи в Linear и напоминает через 4 часа. Через 2-3 часа у пользователя — отчёт, репозиторий и план развития.

Ограничения

ОграничениеПояснение
Каждый агент потребляет контекст отдельно.Удвоение ролей не равно удвоению мощности — есть накладные расходы на межагентские сообщения.
Изоляция памяти — палка о двух концах.CEO не знает, что именно делает Coder, если Coder не отправил отчёт. Нужны явные чек-поинты и обновления статуса.
Стоимость растёт линейно от количества активных ролей. На production-нагрузке четыре агента = четыре подписки на модели, плюс VPS. Бюджет:$8-25 в месяц на локальные модели, $30-80 на облачные.
Сложность отладки.Если задача упала на этапе между агентами — нужно смотреть логи всех участников цепочки. Один stdout больше не поможет.
Не заменяет продуктовое мышление.Multi-agent — это инструмент, не стратегия. Если у пользователя нет чёткого ТЗ, четыре агента превратят его хаос в четыре разных хаоса.

Антипаттерны

АнтипаттернПочему опасно
Не делать:10 агентов с одинаковыми правами — нет специализации, нет безопасности, есть только задержки и шум в логах.
Не делать:давать Coder право на production-деплой без песочницы — одна ошибка в запросе, и Coder сломал прод всей команды.
Не делать:не писать SOUL.md для каждой роли — без явной инструкции агенты сливаются в одного усреднённого помощника. Каждый SOUL.md — это контракт на поведение.
Не делать:межагентские сообщения без allowedPairs — открытая шина превращается в бесконечный цикл «CEO спросил Analyst, Analyst спросил Coder, Coder спросил CEO».
Не делать:общий API-ключ на всех агентов — потерял в одном workspace, скомпрометированы все роли. У каждого свой auth-профиль.

Чеклист

ПроверкаЧто сделать
OpenClaw установленпроверить через openclaw --version.
Роли определены — документ с 3-6 ролями и границами каждой:кто что делает, чего не трогать.
SOUL.md написан для каждой ролипромпт личности, запреты, домен ответственности, формат ответов.
AGENTS.md написан для каждой роли — краткое описание для других агентов:кто я, чем могу помочь, как со мной общаться.
A2A-шина настроена с allowedPairs — в openclaw.json:кто с кем может общаться, по умолчанию только через CEO.
Auth-профили раздельныесвой API-ключ на каждого агента, не общий.
Sandbox настроен для рискованных ролейCoder и Manager в Docker, Analyst и CEO read-only по умолчанию.
Heartbeat/cron для проактивных задачежедневные отчёты, еженедельные обзоры, автопроверки.
Backup-стратегияopenclaw backup настроен на ежедневный или еженедельный ритм, отдельно от git.
Тестовый запуск прошёл — один реальный сценарий от CEO через цепочку:задача, делегирование, отчёт, проверка качества.

Ссылки

По теме