> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 多代理路由

在一個閘道程序中執行多個彼此\_隔離\_的代理程式，每個代理程式都有自己的工作區、狀態目錄（`agentDir`）及由 SQLite 支援的工作階段歷程，並可搭配多個頻道帳號（例如兩個 WhatsApp 號碼）。傳入訊息會透過**繫結**路由至正確的代理程式。

**代理程式**是每個角色的完整範圍：工作區檔案、驗證設定檔、模型登錄與工作階段儲存區。**繫結**會將頻道帳號（Slack 工作區、WhatsApp 號碼等）對應至其中一個代理程式。

## 什麼是一個代理程式

每個代理程式都有自己的：

* **工作區**：檔案、`AGENTS.md`/`SOUL.md`/`USER.md`、本機筆記、角色規則。
* **狀態目錄**（`agentDir`）：驗證設定檔、模型登錄、個別代理程式的設定。
* **工作階段儲存區**：`~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite` 中的聊天記錄與路由狀態。

驗證設定檔以代理程式為單位，讀取自：

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
```

<Note>
  `sessions_history` 是更安全的跨工作階段回憶路徑：它會傳回有範圍限制且經過遮蔽的檢視，而不是原始逐字稿傾印。它會移除思考區塊簽章、工具結果承載資料的詳細資訊、`<relevant-memories>` 輔助結構、工具呼叫 XML 標籤（`<tool_call>`、`<function_call>` 及其複數／降級形式）與 MiniMax 工具呼叫 XML，接著截斷內容並依位元組大小限制輸出。
</Note>

<Warning>
  切勿在代理程式之間重複使用 `agentDir`，否則會造成驗證／工作階段狀態衝突。當次要代理程式的本機 OAuth 認證資訊已過期或重新整理失敗時，OpenClaw 會讀取預設／主要代理程式中具有相同設定檔 ID 的認證資訊，並採用較新的權杖，而不會將重新整理權杖複製到次要代理程式的儲存區。若要使用完全獨立的 OAuth 帳號，請從該代理程式登入。若要手動複製認證資訊，請僅複製可攜式靜態 `api_key` 或 `token` 設定檔；OAuth 重新整理資料預設不可攜（`copyToAgents` 可明確選擇讓設定檔採用此行為）。
</Warning>

Skills 會從每個代理程式工作區及 `~/.openclaw/skills` 等共用根目錄載入，再依代理程式的有效 Skill 允許清單篩選。使用 `agents.defaults.skills` 設定共用基準，使用 `agents.entries.*.skills` 設定個別代理程式的替代項目（明確指定的項目會取代預設值，而不是合併）。請參閱 [Skills：個別代理程式與共用](/zh-TW/tools/skills#per-agent-vs-shared-skills)及 [Skills：代理程式允許清單](/zh-TW/tools/skills#agent-allowlists)。

外掛擁有的儲存空間遵循該外掛的設定；新增第二個代理程式
不會自動分割每個全域外掛儲存區。例如，當不同角色不應共用
已編譯的 Wiki 知識時，請設定
[個別代理程式的 Memory Wiki 保存庫](/zh-TW/concepts/multi-agent#per-agent-memory-wiki-vaults)。

<Note>
  **工作區注意事項：**每個代理程式的工作區是**預設 cwd**，而不是強制沙箱。相對路徑會在工作區內解析，但除非啟用沙箱，否則絕對路徑可以存取主機上的其他位置。請參閱[沙箱機制](/zh-TW/gateway/sandboxing)。
</Note>

## 路徑

| 項目           | 預設值                                                                             | 覆寫方式                                                                                    |
| ------------ | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| 設定           | `~/.openclaw/openclaw.json`                                                     | `OPENCLAW_CONFIG_PATH`                                                                  |
| 狀態目錄         | `~/.openclaw`                                                                   | `OPENCLAW_STATE_DIR`                                                                    |
| 預設代理程式的工作區   | `~/.openclaw/workspace`（設定 `OPENCLAW_PROFILE` 時則為 `workspace-<profile>`）        | `agents.entries.*.workspace`，接著是 `agents.defaults.workspace` 或 `OPENCLAW_WORKSPACE_DIR` |
| 其他代理程式的工作區   | `<stateDir>/workspace-<agentId>`（設定時則為 `<agents.defaults.workspace>/<agentId>`） | `agents.entries.*.workspace`                                                            |
| 代理程式目錄       | `~/.openclaw/agents/<agentId>/agent`                                            | `agents.entries.*.agentDir`                                                             |
| 工作階段與逐字稿     | `~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite`                      | —                                                                                       |
| 舊版／封存的工作階段產物 | `~/.openclaw/agents/<agentId>/sessions`                                         | —                                                                                       |

### 單一代理程式模式（預設）

若未進行任何設定，OpenClaw 會執行一個代理程式：

* `agentId` 預設為 `main`。
* 工作階段使用 `agent:main:<mainKey>` 作為索引鍵（預設 `mainKey` 為 `main`）。
* 工作區預設為 `~/.openclaw/workspace`（當 `OPENCLAW_PROFILE` 設為 `default` 以外的值時，則為 `workspace-<profile>`）。
* 狀態預設為 `~/.openclaw/agents/main/agent`。

## 代理程式輔助工具

新增一個隔離的代理程式：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents add work
```

旗標：`--workspace <dir>`、`--model <id>`、`--agent-dir <dir>`、`--bind <channel[:accountId]>`（可重複使用）、`--non-interactive`（需要 `--workspace`）。

新增 `bindings` 以路由傳入訊息（精靈會提供代為執行的選項），然後驗證：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents list --bindings
```

## 快速開始

<Steps>
  <Step title="建立各代理程式工作區">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw agents add coding
    openclaw agents add social
    ```

    每個代理程式都會取得自己的工作區，其中包含 `SOUL.md`、`AGENTS.md` 及選用的 `USER.md`，並在 `~/.openclaw/agents/<agentId>` 下擁有專用的 `agentDir` 與工作階段儲存區。
  </Step>

  <Step title="建立頻道帳號">
    在偏好的頻道上為每個代理程式建立一個帳號：

    * Discord：每個代理程式使用一個機器人，啟用 Message Content Intent，並複製每個權杖。
    * Telegram：透過 BotFather 為每個代理程式建立一個機器人，並複製每個權杖。
    * WhatsApp：為每個帳號連結各自的電話號碼。

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw channels login --channel whatsapp --account work
    ```

    請參閱頻道指南：[Discord](/zh-TW/channels/discord)、[Telegram](/zh-TW/channels/telegram)、[WhatsApp](/zh-TW/channels/whatsapp)。
  </Step>

  <Step title="新增代理程式、帳號與繫結">
    在 `agents.entries` 下新增代理程式，在 `channels.<channel>.accounts` 下新增頻道帳號，並使用 `bindings` 將其連接（範例如下）。
  </Step>

  <Step title="重新啟動並驗證">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    openclaw agents list --bindings
    openclaw channels status --probe
    ```
  </Step>
</Steps>

## 多個代理程式、多個角色

每個設定的 `agentId` 都是核心代理程式狀態的獨立角色邊界：

* 每個頻道使用不同帳號（依 `accountId` 區分）。
* 不同個性（個別代理程式的 `AGENTS.md`/`SOUL.md`）。
* 驗證與工作階段彼此分離，只有透過明確功能或外掛設定才會啟用跨代理程式存取。

如此可讓多人共用一個閘道，同時維持核心代理程式狀態彼此分離。

## 個別代理程式的 Memory Wiki 保存庫

Memory Wiki 預設使用一個全域保存庫。若要讓支援代理程式的
已編譯知識與行銷代理程式分開，請將
`plugins.entries.memory-wiki.config.vault.scope` 設為 `agent`：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vault: {
            scope: "agent",
            path: "~/.openclaw/wiki",
          },
        },
      },
    },
  },
}
```

設定的路徑是父目錄。OpenClaw 會附加正規化後的
代理程式 ID，產生 `~/.openclaw/wiki/support` 和
`~/.openclaw/wiki/marketing` 等路徑。設定多個代理程式時，代理程式範圍的命令列介面與閘道操作
需要明確指定代理程式。關於橋接
篩選、移轉與信任邊界的詳細資訊，請參閱
[個別代理程式的 Memory Wiki 保存庫](/zh-TW/plugins/memory-wiki#per-agent-vaults)。

## 跨代理程式 QMD 記憶搜尋

若要讓某個代理程式搜尋另一個代理程式的 QMD 工作階段逐字稿，請在 `agents.entries.*.memory.search.qmd.extraCollections` 下新增額外集合。當所有代理程式都應共用相同集合時，請使用 `memory.search.qmd.extraCollections`。

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      workspace: "~/workspaces/main",
    },
    entries: {
      main: {
        workspace: "~/workspaces/main",
        memory: {
          search: {
            qmd: {
              extraCollections: [{ path: "notes" }], // 在工作區內解析 -> 名為 "notes-main" 的集合
            },
          },
        },
      },
      family: { workspace: "~/workspaces/family" },
    },
  },
  memory: {
    backend: "qmd",
    search: {
      qmd: {
        extraCollections: [{ path: "~/agents/family/sessions", name: "family-sessions" }],
      },
    },
    qmd: { includeDefaultMemory: false },
  },
}
```

額外集合路徑可由多個代理程式共用，但當路徑位於代理程式工作區外時，其 `name` 仍需明確指定。工作區內的路徑則維持代理程式範圍，讓每個代理程式保有自己的逐字稿搜尋集合。

## 一個 WhatsApp 號碼、多人使用（私訊分流）

透過 `peer.kind: "direct"` 比對傳送者的 E.164（`+15551234567`），即可在**同一個** WhatsApp 帳號上，將不同的 WhatsApp 私訊路由至不同代理程式。回覆仍會從同一個 WhatsApp 號碼傳送，不會有個別代理程式的傳送者身分。

<Note>
  直接聊天預設會合併至代理程式的主要工作階段索引鍵，因此要真正隔離，每個人都需要各自使用一個代理程式。
</Note>

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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 帳號的全域設定，而非個別代理程式的設定。對於共用群組，請將群組繫結至一個代理程式，或使用[廣播群組](/zh-TW/channels/broadcast-groups)。

## 路由規則

繫結是確定性的，且以最具體者優先。如需完整的層級順序（完全相符的對等端、父對等端、對等端萬用字元、伺服器＋角色、伺服器、團隊、帳號、頻道、預設代理程式），請參閱[頻道路由](/zh-TW/channels/channel-routing#routing-rules-how-an-agent-is-chosen)。以下幾項規則值得特別說明：

* 若同一層級內有多個繫結符合，會以設定順序中的第一個為準。
* 若一個繫結設定多個比對欄位（例如 `peer` + `guildId`），所有指定欄位都必須相符（`AND` 語意）。
* 省略 `accountId` 的繫結只會比對預設帳號，而不是所有帳號。若要設定整個頻道的後援，請使用 `accountId: "*"`；若要指定一個帳號，請使用 `accountId: "<name>"`。再次新增相同繫結並明確指定帳號 ID，會升級現有的僅頻道繫結，而不是建立重複項目。

## 多個帳號／電話號碼

支援多個帳號的頻道（例如 WhatsApp）會使用 `accountId` 識別每次登入。每個 `accountId` 都會路由至自己的代理程式，因此一部伺服器可以託管多個電話號碼，而不會混用工作階段。

設定 `channels.<channel>.defaultAccount`，以選擇省略 `accountId` 時使用的帳號。未設定時，OpenClaw 會優先使用 `default`（若存在），否則使用第一個已設定的帳號 ID（排序後）。

支援多個帳號的頻道：`discord`、`feishu`、`googlechat`、`imessage`、`irc`、`line`、`mattermost`、`matrix`、`nextcloud-talk`、`nostr`、`signal`、`slack`、`telegram`、`whatsapp`、`zalo`、`zalouser`。

## 概念

* `agentId`：一個「大腦」（工作區、各代理程式的驗證、各代理程式的工作階段儲存區）。
* `accountId`：一個頻道帳號執行個體（例如 WhatsApp 帳號 `personal` 與 `biz`）。
* `binding`：依據 `(channel, accountId, peer)`，以及選用的公會／團隊 ID，將傳入訊息路由至 `agentId`。
* 直接聊天會歸併至 `agent:<agentId>:<mainKey>`（各代理程式的「主要」工作階段；請參閱 `session.mainKey`）。

## 平台範例

<AccordionGroup>
  <Accordion title="每個代理程式各自使用 Discord 機器人">
    每個 Discord 機器人帳號都對應到唯一的 `accountId`。請將每個帳號繫結至一個代理程式，並分別維護各機器人的允許清單。

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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 },
                  },
                },
              },
            },
          },
        },
      },
    }
    ```

    * 將每個機器人邀請至公會，並啟用 Message Content Intent。
    * 權杖位於 `channels.discord.accounts.<id>.token`（預設帳號可使用 `DISCORD_BOT_TOKEN`）。
  </Accordion>

  <Accordion title="每個代理程式各自使用 Telegram 機器人">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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"],
            },
          },
        },
      },
    }
    ```

    * 使用 BotFather 為每個代理程式建立一個機器人，並複製各自的權杖。
    * 權杖位於 `channels.telegram.accounts.<id>.botToken`（預設帳號可使用 `TELEGRAM_BOT_TOKEN`）。
    * 若同一個 Telegram 群組中有多個機器人，請邀請每個機器人，並提及應回覆的那一個。
    * 停用每個群組機器人的 BotFather Privacy Mode（`/setprivacy` -> Disable），然後移除並重新加入機器人，讓 Telegram 套用此設定。
    * 使用 `channels.telegram.groups` 允許群組，或僅在受信任的群組部署中使用 `groupPolicy: "open"`。
    * 將傳送者使用者 ID 放入 `groupAllowFrom`。群組與超級群組 ID 應放入 `channels.telegram.groups`，而非 `groupAllowFrom`。
    * 依 `accountId` 繫結，讓每個機器人路由至各自的代理程式。
  </Accordion>

  <Accordion title="每個代理程式各自使用 WhatsApp 號碼">
    啟動閘道前，請先連結每個帳號：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw channels login --channel whatsapp --account personal
    openclaw channels login --channel whatsapp --account biz
    ```

    `~/.openclaw/openclaw.json`（JSON5）：

    ```js theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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",
            },
          },
        },
      },
    }
    ```
  </Accordion>
</AccordionGroup>

## 常見模式

<Tabs>
  <Tab title="WhatsApp 日常使用 + Telegram 深度工作">
    依頻道拆分：將 WhatsApp 路由至快速的日常代理程式，並將 Telegram 路由至 Opus 代理程式。

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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: "*" } },
      ],
    }
    ```

    這些範例使用 `accountId: "*"`，因此日後新增帳號時，繫結仍可繼續運作。若要將單一私訊／群組路由至 Opus，同時讓其餘對話保留在 chat，請為該對話對象新增 `match.peer` 繫結——對話對象比對永遠優先於整個頻道的規則。
  </Tab>

  <Tab title="同一頻道，將一個對話對象路由至 Opus">
    讓 WhatsApp 保持使用快速代理程式，但將一個私訊路由至 Opus：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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: "*" } },
      ],
    }
    ```

    對話對象繫結永遠優先，因此請將它們置於整個頻道的規則之前。
  </Tab>

  <Tab title="繫結至 WhatsApp 群組的家庭代理程式">
    將專用的家庭代理程式繫結至單一 WhatsApp 群組，並使用提及限制和更嚴格的工具政策：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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" },
          },
        },
      ],
    }
    ```

    工具允許／拒絕清單列出的是**工具**，而非 Skills。若某個 Skill 需要執行二進位檔，請確認允許 `exec`，且該二進位檔存在於沙箱中。若需要更嚴格的限制，請設定 `agents.entries.*.groupChat.mentionPatterns`，並保持啟用該頻道的群組允許清單。
  </Tab>
</Tabs>

## 各代理程式的沙箱與工具設定

每個代理程式都可以擁有自己的沙箱與工具限制：

```js theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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"],    // 拒絕其他工具
        },
      },
    ],
  },
}
```

<Note>
  `setupCommand` 位於 `sandbox.docker` 下，並會在建立容器時執行一次。當解析後的範圍為 `"shared"` 時，會忽略各代理程式的 `sandbox.docker.*` 覆寫。
</Note>

這可提供：

* **安全隔離**：限制不受信任代理程式可使用的工具。
* **資源控制**：讓特定代理程式使用沙箱，同時讓其他代理程式保留在主機上。
* **彈性政策**：為每個代理程式設定不同權限。

<Note>
  `tools.elevated` 同時具有全域閘門（`tools.elevated.enabled`/`allowFrom`）與各代理程式閘門（`agents.entries.*.tools.elevated.enabled`/`allowFrom`）。各代理程式閘門只能進一步限制全域閘門——兩者都必須允許某位傳送者，才能執行提升權限的命令。若要指定群組目標，請使用 `agents.entries.*.groupChat.mentionPatterns`，讓 @提及能明確對應至預期的代理程式。
</Note>

如需詳細範例，請參閱[多代理程式沙箱與工具](/zh-TW/tools/multi-agent-sandbox-tools)。

## 相關內容

* [ACP 代理程式](/zh-TW/tools/acp-agents) — 執行外部程式設計框架
* [頻道路由](/zh-TW/channels/channel-routing) — 訊息如何路由至代理程式
* [上線狀態](/zh-TW/concepts/presence) — 代理程式的上線狀態與可用性
* [工作階段](/zh-TW/concepts/session) — 工作階段隔離與路由
* [子代理程式](/zh-TW/tools/subagents) — 產生背景代理程式執行作業