OpenClaw: мультиагентная оркестрация — гид по маршрутизации Gateway (2026)

Введение

Одного ИИ-ассистента хватает для быстрых вопросов. Продакшен — код, алерты ops, семейный чат, исследования — требует нескольких персон, которые не делят сессии, учётные данные и права на инструменты. Мультиагентная оркестрация OpenClaw решает это одной плоскостью управления Gateway и множеством изолированных agents, у каждого свой workspace, auth и хранилище сессий.

OpenClaw — local-first персональный ИИ-ассистент (375k+ звёзд на GitHub в 2026) вокруг Gateway, который связывает каналы (WhatsApp, Telegram, Discord, Slack и др.) с «мозгами» агентов. Официальная документация описывает multi-agent routing: входящие сообщения проходят таблицу bindings и попадают на нужный agentId без перекрёстного доступа.

В этом гиде:

1. Что такое один agent OpenClaw на диске
2. Как bindings маршрутизируют сообщения (peer, account, channel)
3. Пошаговый runbook добавления второго агента
4. Как оркестрация выходит за рамки маршрутизации (делегирование, workflow)
5. Когда достаточно Gateway, а когда нужны внешние orchestrator-проекты

Если вы уже используете плагины Claude Code — Obra Superpowers для dev-workflow или Understand Anything для карты репозитория — OpenClaw на другом уровне: always-on ассистент + маршрутизация каналов, а не только IDE. Обзор плагинов: лучшие плагины Claude Code 2026.

Раскрытие: ZecCloud предоставляет удалённые Mac-хосты. Это руководство независимо от проекта OpenClaw.

Что входит в один agent OpenClaw

Критично: никогда не используйте один agentDir для двух агентов — будут коллизии auth и сессий. У каждого агента свой каталог и workspace.

Источник: документация multi-agent OpenClaw.

agentId vs accountId vs binding

Маршрутизация детерминирована: побеждает наиболее специфичное правило; peer-правила выше channel-wide fallback.

Архитектура Gateway (control plane)

Входящее сообщение (WhatsApp / Slack / …)
        │
        ▼
   OpenClaw Gateway
        │
        ├─ Загрузка bindings (первое совпадение)
        ├─ Разрешение agentId
        └─ Dispatch в workspace + session агента
                │
                ▼
        LLM + tools + skills (allowlist на агента)

Gateway — не продукт, а маршрутизатор и менеджер сессий. У каждого агента своя политика инструментов (agents.list[].tools.allow/deny) и опциональный sandbox (sandbox.mode: "all" на агента).

Обмен между агентами по умолчанию выключен:

tools: {
  agentToAgent: {
    enabled: false,
    allow: ["home", "work"],
  },
}

Включайте только при явном делегировании между персонами. Паттерны allowlist: multi-agent docs.

Runbook: добавить второго агента

Шаг 1 — Установка или обновление OpenClaw

Официальный установщик: github.com/openclaw/openclaw. Проверка CLI:

openclaw --version

Шаг 2 — Новый изолированный agent

openclaw agents add coding

Создаёт файлы workspace и ~/.openclaw/agents/coding/. Повторите для других персон (social, alerts и т.д.).

Шаг 3 — Список агентов и bindings

openclaw agents list --bindings

Убедитесь, что у каждого agentId уникальны agentDir и путь workspace.

Шаг 4 — Подключение аккаунта канала (пример: WhatsApp)

openclaw channels login --channel whatsapp --account work

Привяжите каждый телефон/аккаунт до старта Gateway. Учётные данные по умолчанию: ~/.openclaw/credentials/whatsapp/<accountId>.

Шаг 5 — Редактирование bindings в openclaw.json

{
  agents: {
    list: [
      { id: "main", default: true, workspace: "~/.openclaw/workspace-main" },
      { id: "coding", workspace: "~/.openclaw/workspace-coding" },
    ],
  },
  bindings: [
    { agentId: "main", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "coding", match: { channel: "whatsapp", accountId: "work" } },
  ],
}

Порядок важен: peer-специфичные правила выше channel-wide fallback с accountId: "*".

Шаг 6 — Перезапуск Gateway и probe каналов

openclaw gateway restart
openclaw channels status --probe

Тестовое сообщение на каждый аккаунт; сессии изолированы (agent:coding:… vs agent:main:…).

Шаг 7 — Опционально: разные модели по каналу

bindings: [
  { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },
  { agentId: "opus", match: { channel: "telegram", accountId: "*" } },
]

У каждого агента свой model: "anthropic/claude-sonnet-4-6" (или ваш провайдер).

Паттерны мультиагентной оркестрации

Маршрутизация (встроена в Gateway): какой agent обрабатывает это сообщение?
Оркестрация: как несколько агентов сотрудничают над одной целью?

Паттерн A — Только нативная маршрутизация (рекомендуется сначала)

Лучше всего: разные люди, каналы, личности. Без лишнего ПО.

Паттерн B — Делегирование agent-to-agent

Включите tools.agentToAgent с явным allowlist. Один agent может породить или написать другому для подзадач — в рамках модели сессий OpenClaw.

Паттерн C — Внешние orchestrator-плагины

Они не заменяют Gateway bindings — координируют агентов после того, как маршрутизация доставила сессию.

Рекомендуемый путь:

• Нужны только разные WhatsApp/Discord-личности → паттерн A (только bindings).
• Один пользователь запускает многошаговые проекты со специалистами → B или C.
• Нужен IDE-центричный TDD-workflow → сочетайте с Obra Superpowers, не только OpenClaw.

Безопасность: sandbox и tools на агента

Недоверенные агенты (напр. семейный бот) — sandbox + deny-списки:

{
  id: "family",
  sandbox: { mode: "all", scope: "agent" },
  tools: {
    allow: ["read", "sessions_list", "sessions_history"],
    deny: ["write", "edit", "apply_patch", "browser", "exec"],
  },
}

tools.elevated глобален и зависит от отправителя — не per-agent. Жёсткие границы: deny exec на ограниченных агентах.

Где запускать Gateway

OpenClaw рассчитан на local-first: macOS, Linux или Windows через WSL2. Gateway должен быть онлайн для webhooks каналов и непрерывности сессий.

Иногда его оставляют на выделенном Mac, который работает 24/7, вместо ноутбука — как домашний сервер с SSH для админки. Базовая удалённая настройка: гид SSH Mac mini M4; выберите хост под вашу модель безопасности. Вопросы по хостингу: Помощь ZecCloud.

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

Неверный agent отвечает на сообщения

Симптом: рабочие сообщения попадают в личный agent.

Исправление:

1. openclaw agents list --bindings — порядок правил (peer первыми).
2. accountId в binding совпадает с ключами channels.whatsapp.accounts.
3. openclaw gateway restart.

Перетекание auth или сессий между агентами

Симптом: OAuth или чаты смешаны между персонами.

Исправление: уникальный agentDir на agentId. Не указывайте двум агентам ~/.openclaw/agents/main/agent. При ошибочном общем OAuth — повторный login:

openclaw channels login --channel whatsapp --account work

Gateway стартует, probe канала падает

Симптом: openclaw channels status --probe показывает disconnected.

Исправление: перепривязать credentials, firewall для webhook-портов, токены (Discord Message Content Intent, Telegram BotFather и т.д.) по гайдам каналов OpenClaw.

FAQ

Итог

Мультиагентная оркестрация OpenClaw в 2026 начинается с Gateway: один процесс, много изолированных агентов, детерминированные bindings от каналов к «мозгам». Используйте openclaw agents add, настройте agents.list + bindings, перезапустите и сделайте probe — затем добавляйте agent-to-agent или внешние orchestrator только когда одной маршрутизации недостаточно.

Официально: Multi-agent routing · Репозиторий: openclaw/openclaw. Связанные материалы: плагины Claude Code, Superpowers, Understand Anything, DeepSeek-R1 локально.