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

Запускайте кілька ізольованих агентів в одному процесі 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, а потім фільтруються за чинним списком дозволених навичок агента. Використовуйте agents.defaults.skills для спільної базової конфігурації та agents.list[].skills для заміни на рівні агента (явні записи замінюють типові, а не об’єднуються з ними). Див. Skills: для окремих агентів і спільні та Skills: списки дозволів агентів.

Сховище, яким володіє Plugin, відповідає конфігурації цього Plugin; додавання другого агента не розділяє автоматично кожне глобальне сховище Plugin. Наприклад, налаштуйте сховища 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 для кожного агента).
• Окремі автентифікація та сеанси; міжагентний доступ вмикається лише через явно визначені функції або конфігурацію Plugin.

Це дає змогу кільком людям спільно використовувати один 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 — запуск зовнішніх середовищ для програмування
• Маршрутизація каналів — як повідомлення спрямовуються до агентів
• Присутність — присутність і доступність агента
• Сеанс — ізоляція та маршрутизація сеансів
• Підагентів — запуск фонових виконань агентів