Многоагентная система — это команда специализированных ИИ-агентов с изолированными 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 через цепочку:

задача, делегирование, отчёт, проверка качества.

Ссылки

Ссылки

По теме

По теме