Урок 1: Несколько агентов в одном Gateway

Чему вы научитесь

• Понимать, зачем нужны несколько агентов в одном Gateway
• Создавать новых агентов через CLI
• Настраивать изоляцию workspace для каждого агента
• Конфигурировать разные AI-модели и auth-профили для разных агентов
• Видеть разницу между агентами на практике

Зачем нужны несколько агентов

До сих пор мы работали с одним агентом — default. Он отвечал во всех каналах, имел один SOUL.md и один набор инструментов. Но в реальной жизни задачи разные:

Использовать одного агента для всех задач — всё равно что давать одному сотруднику ключи от всех дверей. Мультиагентная архитектура решает эту проблему: каждый агент имеет свою роль, свои права и свою изоляцию.

Создание агента

Через CLI

openclaw agents add work

Agent "work" created.
  Workspace: ~/.openclaw/workspace/work/
  Files created:
    - SOUL.md
    - AGENTS.md
    - USER.md
    - IDENTITY.md
  Model: anthropic/claude-sonnet-5-5 (inherited from default)

OpenClaw автоматически:

1. Создаёт директорию workspace
2. Создаёт пустые файлы конфигурации
3. Наследует модель от настроек по умолчанию

Через конфигурацию

Настройте агентов в ~/.openclaw/openclaw.json через секцию agents.defaults и agents.list (или registered):

Изоляция workspace

Каждый агент имеет отдельный workspace. Файлы одного агента не видны другому.

~/.openclaw/workspace/
├── default/                    # Личный ассистент
│   ├── SOUL.md                 # "Ты персональный ассистент Алексея..."
│   ├── AGENTS.md               # Полный список инструментов
│   ├── USER.md                 # Личная информация
│   └── skills/                 # Навыки: gmail, calendar, spotify
│       ├── gmail/
│       └── calendar/
│
├── work/                       # Рабочий помощник
│   ├── SOUL.md                 # "Ты помощник для разработки..."
│   ├── AGENTS.md               # GitHub, Jira, CI/CD
│   ├── USER.md                 # Рабочий профиль
│   └── skills/                 # Навыки: github, jira
│       └── github/
│
└── family/                     # Семейный бот
    ├── SOUL.md                 # "Ты помощник для семьи Ивановых..."
    ├── AGENTS.md               # Только search, browser
    ├── USER.md                 # Семейный профиль
    └── skills/                 # Минимум навыков

Что изолировано

Что общее

• Gateway (один процесс для всех агентов)
• Каналы (один Telegram-бот может обслуживать разных агентов через routing)
• Managed-навыки (доступны всем, если не ограничены)

Как устроено хранилище каждого агента внутри Gateway (из официальной документации)

По спецификации мультиагентного рантайма docs.openclaw.ai/concepts/multi-agent, в актуальных релизах OpenClaw (v2026.10.6) каждый агент физически разделён на три слоя на диске:

Обратите внимание на две важные архитектурные детали из документации:

1. Единая SQLite-база на каждого агента: и история диалогов, и состояние маршрутизации, и индивидуальные профили авторизации (auth profiles) хранятся в изолированном файле <agentDir>/openclaw-agent.sqlite. Если ничего дополнительно не настраивать, OpenClaw запускает одного агента с идентификатором main и ключом основной сессии agent:main:main.
2. Хранилища плагинов: глобальные плагины (например, скомпилированные базы знаний Memory Wiki) не разделяются автоматически при добавлении второго агента — если персоны не должны видеть общую базу знаний плагина, настройте для них отдельные хранилища (vaults) в конфиге самого плагина (docs.openclaw.ai/concepts/multi-agent).

Настройка разных моделей

Одно из главных преимуществ мультиагентности — использование разных моделей для разных задач.

{
  "agents": {
    "default": {
      "model": "claude-opus-5-5"
      // Лучшая модель для личных задач и сложного анализа
      // Дороже, но качественнее
    },
    "work": {
      "model": "claude-sonnet-5-5"
      // Оптимальный баланс скорости и качества для рабочих задач
    },
    "family": {
      "model": "claude-haiku-5-5"
      // Быстрая и дешёвая модель для простых вопросов
    },
    "code": {
      "model": "claude-sonnet-5-5"
      // Оптимизированная для кода
    }
  }
}

Почему разные модели

Пример: оптимизация затрат

Вы тратите $30/мес на API. С мультиагентным подходом:

• Opus для личных задач (10% запросов, сложные) — $15/мес
• Sonnet для работы (30% запросов) — $10/мес
• Haiku для семьи (60% запросов, простые) — $5/мес

Общие затраты те же ($30), но качество ответов на важных задачах выше, а простые задачи обрабатываются мгновенно.

Auth-профили

Разные агенты могут использовать разные API-ключи. Это полезно, когда:

• Рабочий агент оплачивается компанией
• Личный агент — вашей картой
• Разные провайдеры для разных агентов

{
  "auth": {
    "profiles": {
      "personal": {
        "anthropic": {
          "apiKey": "sk-ant-personal-..."
        }
      },
      "company": {
        "anthropic": {
          "apiKey": "sk-ant-company-..."
        }
      }
    }
  },
  "agents": {
    "default": {
      "authProfile": "personal"
    },
    "work": {
      "authProfile": "company"
    }
  }
}

Управление агентами

Список агентов

openclaw agents list

Agents:
  default  claude-opus-5-5     personal   3 skills   running
  work     claude-sonnet-5-5   company    2 skills   running
  family   claude-haiku-5-5    personal   0 skills   running

Быстрое создание агента с привязкой и управление через Control UI

По документации docs.openclaw.ai/concepts/multi-agent, при создании нового изолированного агента можно сразу передать роль, рабочую папку, модель и привязки к каналам одной командой без интерактивного мастера:

openclaw agents add work \
  --role "Рабочий инженерный ассистент" \
  --workspace ~/.openclaw/workspace-work \
  --model claude-sonnet-5-5 \
  --bind slack \
  --bind discord:work-bot \
  --non-interactive

Кроме терминала, управлять списком агентов удобно в браузерной панели Control UI (http://127.0.0.1:18789/):

• Страница /agents показывает весь ростер агентов, их текущий статус работы и превью последних диалогов (кнопка Open chat сразу открывает основную сессию выбранного агента).
• Страница /settings/agents (Manage agents) позволяет менять основную модель, резервные модели (fallbacks) и черновик личности каждого агента с автоматическим сохранением.
• Начиная с линейки v2026.6.1+ в OpenClaw также встроен оркестратор Workboard (clawdocs.org) — официальный слой координации, позволяющий нескольким агентам передавать друг другу подзадачи в изолированных сессиях с сохранением прогресса через историю Git.

Информация об агенте

openclaw agents list --verbose

Agent: work
  Model: claude-sonnet-5-5
  Auth profile: company
  Workspace: ~/.openclaw/workspace/work/
  Skills: github, jira
  Tools: allow [read, write, search, browser]
  Sandbox: off
  Sessions: 45 (last 24h: 12)
  Tokens: 234,500 (last 24h: 56,200)

Удаление агента

openclaw agents delete family

Are you sure you want to remove agent "family"?
This will delete the workspace at ~/.openclaw/workspace/family/
Type "yes" to confirm: yes

Agent "family" removed.

Пример: личный агент + семейный бот

Рассмотрим конкретный пример настройки двух агентов.

Шаг 1: Создать семейного агента

openclaw agents add family

Шаг 2: Настроить SOUL.md

Для ~/.openclaw/workspace/family/SOUL.md:

# Семейный помощник

Ты -- дружелюбный помощник для семьи Ивановых.
Отвечай просто и понятно. Используй "ты", а не "вы".

## Правила
- Отвечай на русском языке
- Объясняй сложные вещи простыми словами
- Помогай с домашними заданиями, но не давай готовые ответы
- Не обсуждай темы для взрослых
- При вопросах о здоровье -- предлагай обратиться к врачу
- Не выполняй никаких команд на компьютере

## Стиль
- Дружелюбный, тёплый тон
- Короткие предложения
- Можно использовать простые аналогии

Шаг 3: Настроить права

В ~/.openclaw/openclaw.json:

{
  "agents": {
    "family": {
      "model": "claude-haiku-5-5",
      "tools": {
        "mode": "allow",
        "list": ["search", "memory"]
        // Только поиск и память. Без exec, read, write, browser.
      },
      "sandbox": "all"
    }
  }
}

Шаг 4: Проверить изоляцию

Из WebChat переключитесь на семейного агента:

openclaw chat --agent family

Вы: Покажи содержимое файла /etc/passwd

OpenClaw (family): Извини, у меня нет доступа к файлам на компьютере.
Я могу помочь найти информацию в интернете или ответить на вопросы.
Что тебя интересует?

Изоляция работает: семейный бот не может читать файлы.

Попробуйте сами

1. Создайте второго агента. Выполните openclaw agents add work и настройте SOUL.md для рабочего помощника.

2. Настройте разные модели. Установите для default модель Opus/Sonnet, а для work — Sonnet/Haiku.

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

openclaw chat --agent default
# Спросите: "Кто ты и что ты умеешь?"

openclaw chat --agent work
# Спросите тот же вопрос

4. Настройте права. Ограничьте инструменты для одного из агентов и проверьте, что ограничения работают.

5. Проверьте список агентов:

openclaw agents list
openclaw agents info default
openclaw agents info work

Ключевые выводы

• Мультиагентная архитектура позволяет создать несколько изолированных агентов в одном Gateway
• Каждый агент имеет свой workspace (SOUL.md, навыки, сессии), свою модель и свои права
• Разные модели для разных задач оптимизируют затраты и качество
• Auth-профили позволяют разделить оплату (личные / рабочие ключи)
• Изоляция workspace гарантирует, что агенты не имеют доступа к данным друг друга
• Управление через CLI: openclaw agents add/remove/list/info

Следующий урок

Урок 2: Routing и изоляция — настроим маршрутизацию сообщений: какой агент отвечает в каком канале и кому.