Маршрутизация между несколькими агентами

Запускайте несколько изолированных агентов в одном процессе Gateway, каждый со своей рабочей областью, каталогом состояния (agentDir) и хранящейся в SQLite историей сеансов, а также несколькими учётными записями каналов (например, двумя номерами WhatsApp). Входящие сообщения направляются нужному агенту посредством привязок.

Агент — это полная область отдельной персоны: файлы рабочей области, профили аутентификации, реестр моделей и хранилище сеансов. Привязка сопоставляет учётную запись канала (рабочую область Slack, номер WhatsApp и т. д.) с одним из этих агентов.

Что представляет собой один агент

У каждого агента есть собственные:

• Рабочая область: файлы, AGENTS.md/SOUL.md/USER.md, локальные заметки, правила персоны.
• Каталог состояния (agentDir): профили аутентификации, реестр моделей, конфигурация отдельного агента.
• Хранилище сеансов: история чатов и состояние маршрутизации в ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite.

Профили аутентификации относятся к отдельным агентам и считываются из:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Skills загружаются из рабочей области каждого агента и общих корневых каталогов, таких как ~/.openclaw/skills, после чего фильтруются по действующему списку разрешённых Skills агента. Используйте agents.defaults.skills для общей базовой конфигурации и agents.list[].skills для замены на уровне отдельного агента (явно заданные элементы заменяют значения по умолчанию, а не объединяются с ними). См. Skills: для отдельных агентов и общие и Skills: списки разрешений агентов.

Хранилище, принадлежащее плагину, подчиняется конфигурации этого плагина; добавление второго агента не приводит к автоматическому разделению всех глобальных хранилищ плагинов. Например, настройте хранилища Memory Wiki для отдельных агентов, если персоны не должны совместно использовать скомпилированные знания вики.

Пути

Режим одного агента (по умолчанию)

Если ничего не настраивать, OpenClaw запускает одного агента:

• agentId по умолчанию имеет значение main.
• Ключи сеансов имеют вид agent:main:<mainKey> (значение mainKey по умолчанию — main).
• Рабочая область по умолчанию — ~/.openclaw/workspace (или workspace-<profile>, если OPENCLAW_PROFILE имеет значение, отличное от default).
• Каталог состояния по умолчанию — ~/.openclaw/agents/main/agent.

Вспомогательная команда для агентов

Добавьте нового изолированного агента:

openclaw agents add work

Флаги: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (можно указывать несколько раз), --non-interactive (требует --workspace).

Добавьте bindings для маршрутизации входящих сообщений (мастер предложит сделать это за вас), затем проверьте:

openclaw agents list --bindings

Быстрый старт

openclaw agents add codingopenclaw agents add social

openclaw channels login --channel whatsapp --account work

openclaw gateway restartopenclaw agents list --bindingsopenclaw channels status --probe

Несколько агентов, несколько персон

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

• Разные учётные записи для каждого канала (по accountId).
• Разные личности (задаются для каждого агента в AGENTS.md/SOUL.md).
• Раздельные данные аутентификации и сеансы; межагентный доступ включается только посредством явно заданных функций или конфигурации плагина.

Это позволяет нескольким людям совместно использовать один Gateway, сохраняя основное состояние агентов раздельным.

Хранилища Memory Wiki для отдельных агентов

По умолчанию Memory Wiki использует одно глобальное хранилище. Чтобы отделить скомпилированные знания агента поддержки от знаний маркетингового агента, задайте для plugins.entries.memory-wiki.config.vault.scope значение agent:

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },        },      },    },  },}

Настроенный путь является родительским каталогом. OpenClaw добавляет к нему нормализованный идентификатор агента, формируя пути наподобие ~/.openclaw/wiki/support и ~/.openclaw/wiki/marketing. При наличии нескольких настроенных агентов операции CLI и Gateway, относящиеся к отдельному агенту, требуют явно указать агента. Подробности о фильтрации мостов, миграции и границах доверия см. в разделе Хранилища Memory Wiki для отдельных агентов.

Межагентный поиск в памяти QMD

Чтобы один агент мог искать по стенограммам сеансов QMD другого агента, добавьте дополнительные коллекции в agents.list[].memorySearch.qmd.extraCollections. Используйте agents.defaults.memorySearch.qmd.extraCollections, если все агенты должны совместно использовать одинаковые коллекции.

{  agents: {    defaults: {      workspace: "~/workspaces/main",      memorySearch: {        qmd: {          extraCollections: [{ path: "~/agents/family/sessions", name: "family-sessions" }],        },      },    },    list: [      {        id: "main",        workspace: "~/workspaces/main",        memorySearch: {          qmd: {            extraCollections: [{ path: "notes" }], // разрешается внутри рабочей области -> коллекция с именем "notes-main"          },        },      },      { id: "family", workspace: "~/workspaces/family" },    ],  },  memory: {    backend: "qmd",    qmd: { includeDefaultMemory: false },  },}

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

Один номер WhatsApp, несколько людей (разделение личных сообщений)

Направляйте личные сообщения WhatsApp от разных отправителей разным агентам в рамках одной учётной записи WhatsApp, сопоставляя номер отправителя в формате E.164 (+15551234567) с peer.kind: "direct". Ответы по-прежнему отправляются с одного и того же номера WhatsApp — отдельного идентификатора отправителя для каждого агента нет.

{  agents: {    list: [      { id: "alex", workspace: "~/.openclaw/workspace-alex" },      { id: "mia", workspace: "~/.openclaw/workspace-mia" },    ],  },  bindings: [    {      agentId: "alex",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } },    },    {      agentId: "mia",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } },    },  ],  channels: {    whatsapp: {      dmPolicy: "allowlist",      allowFrom: ["+15551230001", "+15551230002"],    },  },}

Управление доступом к личным сообщениям (сопряжение/список разрешений) действует глобально для всей учётной записи WhatsApp, а не отдельно для каждого агента. Для общих групп привяжите группу к одному агенту или используйте Группы широковещательной рассылки.

Правила маршрутизации

Привязки детерминированы: побеждает наиболее конкретная. Полный порядок уровней (точный собеседник, родительский собеседник, шаблон собеседника, сервер+роли, сервер, команда, учётная запись, канал, агент по умолчанию) приведён в разделе Маршрутизация каналов. Здесь стоит отдельно отметить несколько правил:

• Если на одном уровне совпадают несколько привязок, побеждает первая в порядке конфигурации.
• Если в привязке задано несколько полей сопоставления (например, peer + guildId), должны совпасть все указанные поля (семантика AND).
• Привязка без accountId соответствует только учётной записи по умолчанию, а не всем учётным записям. Используйте accountId: "*" как резервное правило для всего канала или accountId: "<name>" для одной учётной записи. Повторное добавление той же привязки с явным идентификатором учётной записи обновляет существующую привязку только к каналу, а не создаёт её дубликат.

Несколько учётных записей / телефонных номеров

Каналы, поддерживающие несколько учётных записей (например, WhatsApp), используют accountId для идентификации каждого входа. Каждый accountId направляется своему агенту, поэтому один сервер может обслуживать несколько телефонных номеров без смешивания сеансов.

Задайте channels.<channel>.defaultAccount, чтобы выбрать учётную запись, используемую, когда accountId не указано. Если значение не задано, OpenClaw использует default, если оно присутствует, а иначе — идентификатор первой настроенной учётной записи (после сортировки).

Каналы с поддержкой нескольких учётных записей: discord, feishu, googlechat, imessage, irc, line, mattermost, matrix, nextcloud-talk, nostr, signal, slack, telegram, whatsapp, zalo, zalouser.

Основные понятия

• agentId: один «мозг» (рабочее пространство, отдельная аутентификация и отдельное хранилище сеансов для каждого агента).
• accountId: один экземпляр учётной записи канала (например, учётная запись WhatsApp personal и biz).
• binding: направляет входящие сообщения агенту agentId по (channel, accountId, peer) и, при необходимости, по идентификаторам сервера или команды.
• Личные чаты объединяются в agent:<agentId>:<mainKey> (основной сеанс агента; см. session.mainKey).

Примеры для платформ

{  agents: {    list: [      { id: "main", workspace: "~/.openclaw/workspace-main" },      { id: "coding", workspace: "~/.openclaw/workspace-coding" },    ],  },  bindings: [    { agentId: "main", match: { channel: "discord", accountId: "default" } },    { agentId: "coding", match: { channel: "discord", accountId: "coding" } },  ],  channels: {    discord: {      groupPolicy: "allowlist",      accounts: {        default: {          token: "DISCORD_BOT_TOKEN_MAIN",          guilds: {            "123456789012345678": {              channels: {                "222222222222222222": { allow: true, requireMention: false },              },            },          },        },        coding: {          token: "DISCORD_BOT_TOKEN_CODING",          guilds: {            "123456789012345678": {              channels: {                "333333333333333333": { allow: true, requireMention: false },              },            },          },        },      },    },  },}

{  agents: {    list: [      { id: "main", workspace: "~/.openclaw/workspace-main" },      { id: "alerts", workspace: "~/.openclaw/workspace-alerts" },    ],  },  bindings: [    { agentId: "main", match: { channel: "telegram", accountId: "default" } },    { agentId: "alerts", match: { channel: "telegram", accountId: "alerts" } },  ],  channels: {    telegram: {      accounts: {        default: {          botToken: "123456:ABC...",          dmPolicy: "pairing",        },        alerts: {          botToken: "987654:XYZ...",          dmPolicy: "allowlist",          allowFrom: ["tg:123456789"],        },      },    },  },}

openclaw channels login --channel whatsapp --account personalopenclaw channels login --channel whatsapp --account biz

{  agents: {    list: [      {        id: "home",        default: true,        name: "Home",        workspace: "~/.openclaw/workspace-home",        agentDir: "~/.openclaw/agents/home/agent",      },      {        id: "work",        name: "Work",        workspace: "~/.openclaw/workspace-work",        agentDir: "~/.openclaw/agents/work/agent",      },    ],  },   // Детерминированная маршрутизация: используется первое совпадение (сначала наиболее точное).  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },     // Необязательное переопределение для отдельного собеседника (пример: направить определённую группу рабочему агенту).    {      agentId: "work",      match: {        channel: "whatsapp",        accountId: "personal",        peer: { kind: "group", id: "1203630...@g.us" },      },    },  ],   // По умолчанию отключено: обмен сообщениями между агентами необходимо явно включить и разрешить списком.  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },   channels: {    whatsapp: {      accounts: {        personal: {          // Необязательное переопределение. По умолчанию: ~/.openclaw/credentials/whatsapp/personal          // authDir: "~/.openclaw/credentials/whatsapp/personal",        },        biz: {          // Необязательное переопределение. По умолчанию: ~/.openclaw/credentials/whatsapp/biz          // authDir: "~/.openclaw/credentials/whatsapp/biz",        },      },    },  },}

Распространённые схемы

{  agents: {    list: [      {        id: "chat",        name: "Everyday",        workspace: "~/.openclaw/workspace-chat",        model: "anthropic/claude-sonnet-4-6",      },      {        id: "opus",        name: "Deep Work",        workspace: "~/.openclaw/workspace-opus",        model: "anthropic/claude-opus-4-6",      },    ],  },  bindings: [    { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },    { agentId: "opus", match: { channel: "telegram", accountId: "*" } },  ],}

{  agents: {    list: [      {        id: "chat",        name: "Everyday",        workspace: "~/.openclaw/workspace-chat",        model: "anthropic/claude-sonnet-4-6",      },      {        id: "opus",        name: "Deep Work",        workspace: "~/.openclaw/workspace-opus",        model: "anthropic/claude-opus-4-6",      },    ],  },  bindings: [    {      agentId: "opus",      match: { channel: "whatsapp", accountId: "*", peer: { kind: "direct", id: "+15551234567" } },    },    { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },  ],}

{  agents: {    list: [      {        id: "family",        name: "Family",        workspace: "~/.openclaw/workspace-family",        identity: { name: "Family Bot" },        groupChat: {          mentionPatterns: ["@family", "@familybot", "@Family Bot"],        },        sandbox: {          mode: "all",          scope: "agent",        },        tools: {          allow: [            "exec",            "read",            "sessions_list",            "sessions_history",            "sessions_send",            "sessions_spawn",            "session_status",          ],          deny: ["write", "edit", "apply_patch", "browser", "canvas", "nodes", "cron"],        },      },    ],  },  bindings: [    {      agentId: "family",      match: {        channel: "whatsapp",        peer: { kind: "group", id: "120363999999999999@g.us" },      },    },  ],}

Настройка песочницы и инструментов для каждого агента

Для каждого агента можно задать собственные ограничения песочницы и инструментов:

{  agents: {    list: [      {        id: "personal",        workspace: "~/.openclaw/workspace-personal",        sandbox: {          mode: "off",  // Для личного агента песочница не используется        },        // Ограничения инструментов отсутствуют — доступны все инструменты      },      {        id: "family",        workspace: "~/.openclaw/workspace-family",        sandbox: {          mode: "all",     // Всегда выполняется в песочнице          scope: "agent",  // Один контейнер на агента          docker: {            // Необязательная однократная настройка после создания контейнера            setupCommand: "apt-get update && apt-get install -y git curl",          },        },        tools: {          allow: ["read"],                    // Только инструмент чтения          deny: ["exec", "write", "edit", "apply_patch"],    // Запретить остальные        },      },    ],  },}

Это обеспечивает:

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

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

Связанные материалы

• Агенты ACP — запуск внешних сред выполнения для программирования
• Маршрутизация каналов — как сообщения направляются агентам
• Присутствие — присутствие и доступность агента
• Сеанс — изоляция и маршрутизация сеансов
• Субагенты — запуск фоновых выполнений агентов