本文記錄了我從零開始配置 OpenClaw 多 Agent 多 Discord 頻道的完整過程，基于最新的 OpenClaw 2026.2.22-2 版本，包含實際配置文件和踩坑實錄。一、背景與需求
1.1 為什么要多 Agent？當 AI Agent 的應用場景越來越豐富時，單一 Agent 很難同時勝任多種專業(yè)任務：
編程任務需要代碼能力和技術(shù)深度內(nèi)容創(chuàng)作需要寫作技巧和文案感覺健康管理需要健身知識和營養(yǎng)學背景投資分析需要金融市場理解和數(shù)據(jù)敏感性讓每個 Agent 專注一個領域，比讓一個 Agent 什么都懂但什么都不精要好得多。
1.2 為什么要多 Discord 頻道？在 Discord 場景中，不同的頻道有不同的氛圍和用途：
頻道用途對應 Agent#-指揮臺主溝通入口，任務分發(fā)Cypher (主控)#-編程技術(shù)討論、代碼分享Forge (開發(fā)專家)#??-創(chuàng)作文章寫作、內(nèi)容策劃Muse (創(chuàng)作專家)#-健康健身打卡、飲食記錄Vitality (健康專家)#-投資股市分析、交易記錄Sigma (投資顧問)每個頻道有獨立的 Agent 響應，用戶體驗更清晰。
1.3 最終架構(gòu)指揮中心 └── #-指揮臺 → Cypher（調(diào)度中樞） ? 工作區(qū) ├── #-編程 → Forge（開發(fā)專家） ├── #??-創(chuàng)作 → Muse（創(chuàng)作專家） ├── #-健康 → Vitality（健康專家） └── #-投資 → Sigma（投資顧問）
Cypher 作為總調(diào)度，可以在 #-指揮臺 接收任務，然后委托給對應的專家 Agent。
二、Discord 端準備工
二、Discord 端準備工作
2.1 創(chuàng)建 Discord 服務器如果你還沒有 Discord 服務器，需要先創(chuàng)建一個：
打開 Discord（網(wǎng)頁版或客戶端）點擊左側(cè)欄的「+」按鈕選擇「創(chuàng)建我自己的服務器」選擇「僅供我和我的朋友使用」輸入服務器名稱（如「AI 指揮中心」）點擊「創(chuàng)建」2.2 創(chuàng)建頻道結(jié)構(gòu)在服務器中創(chuàng)建以下頻道結(jié)構(gòu)：
指揮中心 └── #-指揮臺 (ID: xx) → Cypher ? 工作區(qū) ├── #-編程 (ID: xxx) → Forge ├── #??-創(chuàng)作 (ID: xxx) → Muse ├── #-健康 (ID: xxx) → Vitality └── #-投資 (ID: xxx) → Sigma
創(chuàng)建頻道步驟：
右鍵服務器名稱 → 創(chuàng)建頻道選擇「文字頻道」輸入頻道名稱（可包含 Emoji）點擊「創(chuàng)建頻道」2.3 獲取 Guild ID 和 Channel ID配置 Bot 需要服務器 ID 和頻道 ID，獲取方法：
開啟開發(fā)者模式：
點擊左下角「用戶設置」（齒輪圖標）選擇「高級」開啟「開發(fā)者模式」復制服務器 ID（Guild ID）：
右鍵服務器名稱點擊「復制服務器 ID」復制頻道 ID：
右鍵頻道名稱點擊「復制頻道 ID」2.4 創(chuàng)建 5 個 Discord Bot在 Discord Developer Portal 創(chuàng)建 5 個 Bot：
步驟 1：創(chuàng)建應用訪問 https://discord.com/developers/applications點擊「New Application」輸入應用名稱（如「Cypher Bot」）點擊「Create」
步驟 2：獲取 Bot Token進入左側(cè)「Bot」選項卡點擊「Reset Token」復制 Token（只能查看一次，務必保存好）步驟 3：開啟 Privileged Gateway Intents在同一頁面，開啟以下二個 Intent：
? Server Members Intent? Message Content Intent（必需，否則無法讀取消息內(nèi)容）
步驟 4：邀請 Bot 加入服務器進入左側(cè)「OAuth2」→「URL Generator」在「Scopes」中勾選「bot」在「Bot Permissions」中勾選：Send MessagesRead Messages/View ChannelsUse Slash CommandsEmbed LinksAttach FilesRead Message History復制生成的 URL，在瀏覽器中打開選擇你的服務器，點擊「繼續(xù)」確認權(quán)限后點擊「授權(quán)」Add Reactions
重復以上步驟，創(chuàng)建 5 個 Bot：
Bot 名稱用途Token 占位符Cypher Bot主控 BotYOUR_CYPHER_BOT_TOKENForge Bot開發(fā)專家YOUR_FORGE_BOT_TOKENMuse Bot創(chuàng)作專家YOUR_MUSE_BOT_TOKENVitality Bot健康專家YOUR_VITALITY_BOT_TOKENSigma Bot投資顧問YOUR_SIGMA_BOT_TOKEN 2.5 設置頻道權(quán)限為了安全起見，建議設置每個頻道只允許對應的 Bot 發(fā)送消息：
設置步驟（以 #-編程 為例）：
右鍵頻道 → 頻道設置選擇「權(quán)限」選項卡點擊「+」添加成員選擇「Forge Bot」設置權(quán)限：? 查看頻道? 發(fā)送消息? 讀取消息歷史將 @everyone 的「發(fā)送消息」設為 ?重復以上操作，為每個頻道設置對應 Bot 的專屬權(quán)限。
三、配置多 Agent 工作區(qū)
3.1 創(chuàng)建 Agent 工作區(qū)為每個 Agent 創(chuàng)建獨立的工作區(qū)：
openclaw agents add forge --workspace ~/.openclaw/workspace-forge openclaw agents add muse --workspace ~/.openclaw/workspace-muse openclaw agents add vitality --workspace ~/.openclaw/workspace-vitality openclaw agents add sigma --workspace ~/.openclaw/workspace-sigma
這會創(chuàng)建對應的目錄結(jié)構(gòu)：
~/.openclaw/ ├── workspace/ # Cypher (main) 主工作區(qū) ├── workspace-forge/ # Forge 工作區(qū) ├── workspace-muse/ # Muse 工作區(qū) ├── workspace-vitality/ # Vitality 工作區(qū) ├── workspace-sigma/ # Sigma 工作區(qū) └── agents/ ├── main/ ├── forge/ ├── muse/ ├── vitality/ └── sigma/ 3.2 配置多 Discord Bot
編輯 ~/.openclaw/openclaw.json，在 channels.discord 中配置多個賬號：
{"channels":{"discord":{"enabled":true,"groupPolicy":"allowlist","streaming":"block","accounts":{"default":{"token":"YOUR_CYPHER_BOT_TOKEN","groupPolicy":"allowlist","blockStreaming":true,"streaming":"block","guilds":{"YOUR_GUILD_ID":{"slug":"YourServer","channels":{"-指揮臺":{"allow":true,"requireMention":false,"autoThread":true},"-歸檔":{"allow":true,"requireMention":false,"autoThread":true}}}}},"forge":{"token":"YOUR_FORGE_BOT_TOKEN","groupPolicy":"allowlist","blockStreaming":true,"streaming":"block","guilds":{"YOUR_GUILD_ID":{"channels":{"1474332097371046010":{"allow":true,"requireMention":false,"autoThread":false}}}}},"muse":{"token":"YOUR_MUSE_BOT_TOKEN","groupPolicy":"allowlist","blockStreaming":true,"streaming":"block","guilds":{"YOUR_GUILD_ID":{"channels":{"1474331895859777576":{"allow":true,"requireMention":false,"autoThread":false}}}}},"vitality":{"token":"YOUR_VITALITY_BOT_TOKEN","groupPolicy":"allowlist","blockStreaming":true,"streaming":"block","guilds":{"YOUR_GUILD_ID":{"channels":{"1474331960770953334":{"allow":true,"requireMention":false,"autoThread":false}}}}},"sigma":{"token":"YOUR_SIGMA_BOT_TOKEN","groupPolicy":"allowlist","blockStreaming":true,"streaming":"block","guilds":{"YOUR_GUILD_ID":{"channels":{"1474332013673578592":{"allow":true,"requireMention":false,"autoThread":false}}}}}}}}}
關鍵配置說明：
字段說明accounts.defaultCypher 主 Bot，使用 default 賬號名accounts.forgeForge 專家 Botguilds服務器配置，用服務器 ID 作為 keychannels頻道權(quán)限配置，可用頻道名或頻道 IDallow: true允許該頻道requireMention: false不需要 @Bot 就能觸發(fā)autoThread: true自動創(chuàng)建線程回復blockStreaming: true阻塞式流式輸出（推薦） ?? 注意：建議使用頻道數(shù)字 ID 而非名稱，避免權(quán)限審計受限。3.3 配置 Agent 路由綁定在 openclaw.json 的 bindings 中配置路由規(guī)則：
{"bindings":[{"agentId":"main","match":{"channel":"discord","accountId":"default"}},{"agentId":"forge","match":{"channel":"discord","accountId":"forge"}},{"agentId":"muse","match":{"channel":"discord","accountId":"muse"}},{"agentId":"vitality","match":{"channel":"discord","accountId":"vitality"}},{"agentId":"sigma","match":{"channel":"discord","accountId":"sigma"}}]}
路由邏輯：
當 Cypher Bot (default) 收到消息 → 路由給 main Agent當 Forge Bot 收到消息 → 路由給 forge Agent以此類推…四、Agent 間通信配置（重要：避坑指南）
4.1 ?? 踩坑實錄：配置位置錯誤導致 Gateway 啟動失敗在配置 Agent 間通信時，我犯了一個致命錯誤：把 subagents 配置放在了 openclaw.json 的根級別。
? 錯誤配置（導致 Gateway 啟動失?。?/strong>
{"subagents":{"allowAgents":["forge","muse","vitality","sigma"]}}
? 正確配置位置：subagents.allowAgents 必須在 agents.list[].subagents 下，每個 Agent 都需要單獨配置：
{"agents":{"list":[{"id":"main","subagents":{"allowAgents":["main","forge","muse","vitality","sigma"]}},{"id":"forge","name":"forge","workspace":"/root/.openclaw/workspace-forge","agentDir":"/root/.openclaw/agents/forge/agent","subagents":{"allowAgents":["main","forge","muse","vitality","sigma"]}},{"id":"muse","name":"muse","workspace":"/root/.openclaw/workspace-muse","agentDir":"/root/.openclaw/agents/muse/agent","subagents":{"allowAgents":["main","forge","muse","vitality","sigma"]}},{"id":"vitality","name":"vitality","workspace":"/root/.openclaw/workspace-vitality","agentDir":"/root/.openclaw/agents/vitality/agent","subagents":{"allowAgents":["main","forge","muse","vitality","sigma"]}},{"id":"sigma","name":"sigma","workspace":"/root/.openclaw/workspace-sigma","agentDir":"/root/.openclaw/agents/sigma/agent","subagents":{"allowAgents":["main","forge","muse","vitality","sigma"]}}]}}
踩坑總結(jié)：
? 不要把 subagents 放在根級別? 必須在每個 Agent 的 agents.list[] 條目下添加? 每個 Agent 的 allowAgents 要包含所有需要通信的 Agent ID（包括自己） 修改后必須重啟 Gateway：openclaw gateway restart4.2 啟用 Agent-to-Agent 通信在 openclaw.json 中添加 tools.agentToAgent 配置：
{"tools":{"agentToAgent":{"enabled":true,"allow":["main","forge","muse","vitality","sigma"]}}}注意：這是用于 sessions_send 的跨 Agent 通信，和上面的 subagents 配置是互補的。4.3 驗證配置是否生效
使用 CLI 檢查允許的 Agent 列表：
$ openclaw agents list
輸出應顯示所有 5 個 Agent：
{"requester":"main","allowAny":false,"agents":[{"id":"main","configured":true},{"id":"forge","name":"forge","configured":true},{"id":"muse","name":"muse","configured":true},{"id":"sigma","name":"sigma","configured":true},{"id":"vitality","name":"vitality","configured":true}]}
如果只看到 main，說明配置未生效，請檢查配置位置。
4.4 測試 Agent 間通信在配置完成后，可以通過 Cypher 測試向其他 Agent 發(fā)送消息：
$ openclaw sessions_send --agent-id muse --task"寫一篇關于 AI Agent 的短文"
或使用工具調(diào)用：
{"tool":"sessions_send","params":{"sessionKey":"muse","message":"測試 Agent 通信"}}4.5 Cypher 的調(diào)度邏輯
在 Cypher 的 SOUL.md 中定義工作流程：
## 工作流程 1. **收到 Channing 的請求后，先判斷任務類型** 2. **簡單閑聊和問答**：直接回復 3. **專業(yè)任務**：使用 `sessions_send` 委托給對應專家，并告知 Channing 已委托 4. **跨領域任務**：協(xié)調(diào)多個專家，匯總結(jié)果 ## 任務委托規(guī)則 - **編程/技術(shù)問題** → `sessions_send` 給 `forge` - **寫作/創(chuàng)作需求** → `sessions_send` 給 `muse` - **健康/健身/飲食** → `sessions_send` 給 `vitality` - **投資/股票/財經(jīng)** → `sessions_send` 給 `sigma` ## 絕對禁止 - ? 不要將任務委托給自己（`agentId: main` 或 `cypher`） - ? 收到專家返回結(jié)果后，直接匯總，不要再次委托 - ? 不要創(chuàng)建超過 2 層的委托鏈
五、實際使用示例
5.1 場景一：直接聯(lián)系專家在 #-編程 頻道發(fā)消息：
幫我寫一個 Python 腳本，批量重命名文件
→ Forge 響應，提供代碼實現(xiàn)
5.2 場景二：通過 Cypher 中轉(zhuǎn)在 #-指揮臺 頻道發(fā)消息：
@Cypher 幫我寫篇文章，關于 AI Agent 架構(gòu)的
→ Cypher 收到后，使用 sessions_send 委托給 Muse
→ Muse 完成文章后返回給 Cypher
→ Cypher 匯總后回復給用戶
在 #-指揮臺 頻道發(fā)消息：
幫我分析一下 AI 行業(yè)的投資機會，需要技術(shù)趨勢和市場數(shù)據(jù)
→ Cypher 同時委托給 Forge（技術(shù)趨勢）和 Sigma（市場分析）
→ 收到兩者結(jié)果后，Cypher 綜合匯總
→ 給出完整的投資分析報告
六、常見問題
6.1 Bot 沒有響應？檢查清單：
? Bot 已加入服務器? Bot 有頻道讀取/發(fā)送權(quán)限? Message Content Intent 已開啟? Token 配置正確? Gateway 已重啟：openclaw gateway restart6.2 消息路由錯誤？檢查 bindings 配置中的 accountId 是否和 channels.discord.accounts 中的 key 匹配。
6.3 Agent 間通信失??？確保以下兩處配置都正確：
每個 Agent 的 subagents.allowAgents 包含目標 Agent IDtools.agentToAgent.allow 包含所有需要通信的 Agent ID6.4 流式輸出卡頓？建議使用 blockStreaming: true 和 streaming: "block" 配置，獲得更穩(wěn)定的輸出體驗。
七、配置版本信息
本文基于以下版本配置：
OpenClaw 版本：2026.2.22-2Node.js：v22.22.0模型：Kimi Code (kimi-for-coding)更新日期：2026-02-28八、總結(jié)
通過 OpenClaw 的多 Agent 多頻道配置，我們可以：
專業(yè)化分工 - 每個 Agent 專注一個領域清晰的交互邊界 - 不同頻道對應不同 Agent靈活的調(diào)度機制 - Cypher 作為總控，可單可群可擴展的架構(gòu) - 隨時添加新的專家 Agent這種架構(gòu)讓 AI 助手從"全能但平庸"進化為"專業(yè)且協(xié)同"，每個任務都能找到最適合的專家來處理。
