1. 为什么单 Agent 撑不起飞书里的团队协作如果你已经在飞书里跑过一个通用 AI 机器人大概率遇到过这种场面早上让它整理行业资讯中午让它审一段代码下午又让它写篇推文结果它把三个任务的上下文搅在一起回复里混着昨天的代码片段和前天的选题。这不是模型不行而是单 Agent 架构本身的天花板——一个上下文窗口要同时装下资讯、代码、文案、任务进度记忆互相污染是迟早的事。OpenClaw 的多 Agent 结构解决的正是这个问题。它允许你在同一台机器上跑 5 个互相独立的 Agent每个 Agent 有自己独立的 workspace 目录、独立的记忆文件、独立的飞书机器人身份。它们平时各干各的需要协同时通过 agentToAgent 通道互相发消息。落到飞书里你看到的就是 5 个不同的机器人大总管、资讯助手、内容助手、代码助手、任务助手各回各的消息互不串台。这篇要交付的是一套能直接复制粘贴的 config.toml 骨架、TaoToken 统一 Key 的接入方式、飞书 5 个应用的回调配置以及逐项的联调验证动作。目标很明确一次跑通多助理协同响应而不是停留在配置看起来对的阶段。适合已经装好 OpenClaw、手里有飞书开放平台账号、想让 AI 助理真正分工干活的人。需要提前说清楚一点OpenClaw 的配置文件在不同版本里可能是openclaw.json或config.toml本文以config.toml的 TOML 写法为主线同时给出 JSON 等价片段你按自己版本的实际文件名落盘即可。核心结构agents / channels / bindings / tools是一致的。2. TaoToken 前置一个 Key 打通 5 个 Agent 的模型通道5 个 Agent 如果各自配一套模型 Key管理成本会立刻上来轮换要改 5 处额度要分别盯某个 Key 失效还得逐个排查是哪个 Agent 挂了。更省事的做法是让 5 个 Agent 共用一条统一的模型 API 通道TaoToken 就是干这个的——它提供一个兼容 Anthropic Messages 协议的入口OpenClaw 的models.providers里配一次5 个 Agent 全部复用。先拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来形如sk-xxxxxxxx。这个 Key 就是后面所有 Agent 的模型凭证不需要给每个 Agent 单独申请。拿到 Key 之后在 OpenClaw 的模型 provider 段里配置 baseUrl 和 apiKey。TaoToken 的 API 入口是https://taotoken.net/api协议选anthropic-messages这样 OpenClaw 会按 Anthropic 的消息格式发请求兼容性最好。配置片段如下[models.providers.taotoken] baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 api anthropic-messages [[models.providers.taotoken.models]] id claude-sonnet-4-5 name Claude Sonnet 4.5 [[models.providers.taotoken.models]] id claude-haiku-4-5 name Claude Haiku 4.5如果你用的是 JSON 版配置等价写法是{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, api: anthropic-messages, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5 }, { id: claude-haiku-4-5, name: Claude Haiku 4.5 } ] } }, mode: merge } }这里有个容易踩的点mode要设成merge否则 OpenClaw 可能用你的配置整体覆盖默认 provider 列表导致内置模型消失。设成 merge 后taotoken 是追加进去的原有 provider 保留。配好之后先别急着上 5 个 Agent用一条命令验证通道是否通openclaw models test taotoken/claude-sonnet-4-5返回里能看到模型正常回一句话说明 Key 和 baseUrl 都没问题。如果报 401检查 Key 有没有复制全如果报连接超时检查服务器出网是否正常。这一步过了再往下配 Agent能省掉后面一半的排障时间。关于模型选择5 个 Agent 不必都用同一个。资讯助手和任务助手这类偏轻量的活用 Haiku 就够内容助手和代码助手对输出质量要求高用 Sonnet。在 Agent 的model.primary里分别指定即可Key 还是同一个。3. 可复制配置5 个 Agent 的 config.toml 骨架这一节是全文的核心给出完整的 config.toml 骨架。我把它拆成四块讲agents 列表、channels 飞书账号、bindings 路由、tools 协作开关。你按顺序拼起来就是一份可用的配置。3.1 agents 列表5 个角色与独立 workspace先建 5 个独立工作目录每个 Agent 一个数据隔离靠的就是这个mkdir -p /root/.openclaw/workspace-boss mkdir -p /root/.openclaw/workspace-news mkdir -p /root/.openclaw/workspace-content mkdir -p /root/.openclaw/workspace-code mkdir -p /root/.openclaw/workspace-task然后是 agents 段。5 个 Agent 的 id 全部用小写字母这是硬性要求大小写混用会导致路由失效[[agents.list]] id aiboss default true name aiboss workspace /root/.openclaw/workspace-boss model { primary taotoken/claude-sonnet-4-5 } [[agents.list]] id ainews name ainews workspace /root/.openclaw/workspace-news model { primary taotoken/claude-haiku-4-5 } [[agents.list]] id aicontent name aicontent workspace /root/.openclaw/workspace-content model { primary taotoken/claude-sonnet-4-5 } [[agents.list]] id aicode name aicode workspace /root/.openclaw/workspace-code model { primary taotoken/claude-sonnet-4-5 } [[agents.list]] id aitask name aitask workspace /root/.openclaw/workspace-task model { primary taotoken/claude-haiku-4-5 }default true只能有一个这里给了 aiboss它是团队入口。5 个 Agent 的角色分工建议这样定aiboss 负责总协调和任务分发ainews 负责行业资讯收集和定时推送aicontent 负责文章和脚本产出aicode 负责代码审查和技术方案aitask 负责任务跟踪和提醒。分工清晰后面写 SOUL.md 时才有依据。3.2 channels 飞书账号5 个应用对应 5 个机器人飞书这边需要先在开放平台建 5 个自建应用每个应用拿到一对 App ID 和 App Secret。建应用的流程是登录 https://open.feishu.cn 进入开发者后台创建企业自建应用填名称和描述然后在凭证与基础信息里复制 App ID 和 App Secret。5 个应用分别对应 5 个 Agent建议用表格先记下来避免后面填错。配置到 channels 段[channels.feishu] enabled true [channels.feishu.accounts.aiboss] appId cli_你的大总管AppID appSecret 你的大总管AppSecret [channels.feishu.accounts.ainews] appId cli_你的资讯助手AppID appSecret 你的资讯助手AppSecret [channels.feishu.accounts.aicontent] appId cli_你的内容助手AppID appSecret 你的内容助手AppSecret [channels.feishu.accounts.aicode] appId cli_你的代码助手AppID appSecret 你的代码助手AppSecret [channels.feishu.accounts.aitask] appId cli_你的任务助手AppID appSecret 你的任务助手AppSecretaccounts 下面的 keyaiboss、ainews 等必须和 Agent 的 id 完全一致这是路由能对上的前提。3.3 bindings 路由消息怎么找到对应的 Agentbindings 段决定飞书哪个账号收到的消息交给哪个 Agent 处理。5 条规则一一对应[[bindings]] match { channel feishu, accountId aiboss } agentId aiboss [[bindings]] match { channel feishu, accountId ainews } agentId ainews [[bindings]] match { channel feishu, accountId aicontent } agentId aicontent [[bindings]] match { channel feishu, accountId aicode } agentId aicode [[bindings]] match { channel feishu, accountId aitask } agentId aitaskmatch.accountId对应 channels 里的账号 keyagentId对应 agents 里的 id。两边都小写一一对齐路由就不会错。3.4 tools 协作开关让 5 个 Agent 能互相喊话多 Agent 的价值在协作协作靠 agentToAgent 通道。开启它并显式列出允许互相通信的 Agent[tools.agentToAgent] enabled true allow [aiboss, ainews, aicontent, aicode, aitask]allow列表里没写的 Agent 无法参与协作。5 个都写上团队内部就能自由喊话。aiboss 通过sessions_send工具给其他 Agent 发消息比如让 ainews 去查资讯、让 aicontent 去写稿。3.5 每个 Agent 的核心文件IDENTITY / SOUL / AGENTS / MEMORY配置只是骨架Agent 的行为靠 workspace 里的几个 Markdown 文件定义。每个 Agent 的 workspace 下至少放四个文件IDENTITY.md 写身份SOUL.md 写人设和行为准则AGENTS.md 写团队成员通讯录MEMORY.md 写长期记忆。以 aiboss 为例cat /root/.openclaw/workspace-boss/IDENTITY.md EOF # IDENTITY.md - AIBoss - Name: AIBoss - Role: 大总管团队协调者 - Vibe: 专业、高效、有条理 EOF cat /root/.openclaw/workspace-boss/SOUL.md EOF # SOUL.md - AIBoss 你是 AIBoss负责团队协调和任务分发。 ## 核心职责 - 团队协调和任务分发 - 项目进度跟踪 - 跨 Agent 协作调度 ## 协作方式 需要其他 Agent 协作时使用 sessions_send 工具 - 需要资讯 - sessions_send(agentIdainews, message...) - 需要内容 - sessions_send(agentIdaicontent, message...) - 需要技术支持 - sessions_send(agentIdaicode, message...) - 需要任务提醒 - sessions_send(agentIdaitask, message...) EOF cat /root/.openclaw/workspace-boss/AGENTS.md EOF # AGENTS.md - 团队成员 - AIBoss (你) - agentId: aiboss - 团队协调、任务分发 - AINews - agentId: ainews - 资讯收集、每日推送 - AIContent - agentId: aicontent - 文章写作、脚本产出 - AICode - agentId: aicode - 代码审查、技术方案 - AITask - agentId: aitask - 任务跟踪、提醒 EOFAGENTS.md 这个文件特别关键。Agent 之间能不能协作取决于它知不知道队友的存在。每个 Agent 的 workspace 里都要放一份完整的团队成员列表否则 aiboss 想喊 ainews 时根本不知道 ainews 的 agentId 是什么。这一步漏了协作必然失败。其他 4 个 Agent 照此办理把 IDENTITY 和 SOUL 换成各自的角色描述即可。ainews 的 SOUL 里写清楚推送时间比如每天 8:00 和 18:00aicontent 写清楚产出类型aicode 写清楚审查范围aitask 写清楚提醒规则。3.6 飞书应用侧配置权限、事件订阅、发布配置文件的 channels 段只是 OpenClaw 侧的声明飞书应用侧还要做三件事缺一不可。第一开启机器人能力并加权限。进入每个应用的权限管理开启机器人能力添加这三个权限im:message接收消息、im:message:group_at_msg接收群组 消息、im:message:send_as_bot以机器人身份发消息。第二配置事件订阅模式选长连接。进入事件订阅选择长连接模式添加im.message.receive_v1事件。这一步是最容易漏的——不配长连接事件订阅机器人会一直显示离线配置文件再对也没用。第三发布应用。进入版本管理与发布创建版本填更新日志发布。开发版即可测试够用。5 个应用都要走完这三步。建议做一个检查表每完成一个应用勾一项避免漏配。4. 验证请求从单 Agent 到多 Agent 协作的逐项联调配置落盘后重启 Gateway 让配置生效openclaw gateway restart openclaw gateway statusstatus 显示 running 之后按下面的顺序逐项验证。顺序很重要从单点到协作前面不通就别急着测后面。4.1 验证 5 个 Agent 是否都起来了openclaw status期望输出里能看到 5 个 Agent 全部是 runningAgent: aiboss Status: running Agent: ainews Status: running Agent: aicontent Status: running Agent: aicode Status: running Agent: aitask Status: running如果某个 Agent 没起来先看日志openclaw logs --follow日志里通常会直接指出是 workspace 路径不存在、模型 provider 找不到还是 id 大小写问题。4.2 验证单个 Agent 能回消息在飞书里找到每个机器人分别发一条测试消息。第一次发消息时机器人会返回配对提示OpenClaw: access not configured. Your Feishu user id: ou_xxx Pairing code: xxxx Ask the bot owner to approve with: openclaw pairing approve feishu xxxx在服务器上执行批准命令openclaw pairing approve feishu xxxx批准后就能正常对话。5 个机器人都要走一遍配对。测试消息建议这样发AIBoss你好你是谁AINews今天有什么 AI 资讯AIContent帮我写一个文章大纲AICode这段代码有什么问题AITask创建一个任务提醒每个机器人都能正常回复说明单 Agent 链路通了。4.3 验证 Agent 间协作这是最关键的一步。在飞书里 AIBoss让它去调用其他 AgentAIBoss 帮我让 AINews 推送今天的 AI 资讯期望的行为链路是AIBoss 收到指令通过 sessions_send 联系 AINewsAINews 执行并把结果返回给 AIBossAIBoss 汇总后回复你。如果 AIBoss 回复我不知道怎么联系 AINews说明它的 AGENTS.md 没写全或者 agentToAgent 没开如果 AIBoss 说联系了但 AINews 没反应检查 AINews 的 workspace 是否正常、模型通道是否通。4.4 验证消息路由不串台分别给 5 个机器人发一条带身份标识的消息比如你是哪个 Agent确认每个机器人都报自己的身份没有出现 AICode 的消息被 AINews 回复的情况。串台基本是 bindings 里 accountId 和 agentId 对错了逐条核对即可。4.5 验证清单跑完上面四步对照这份清单确认检查项期望结果5 个飞书应用全部发布应用状态为已发布5 个应用都配了长连接事件订阅机器人显示在线openclaw status 显示 5 个 running全部 running5 个机器人单独对话正常各自回复正确身份AIBoss 能调度其他 Agent协作链路走通消息不串台各回各的5. 本篇常见错排查配置多 Agent 系统时下面这几个坑出现频率最高我按症状、原因、解决三段式列出来方便你对照。坑一机器人一直离线。症状是飞书里机器人头像灰着发消息没反应。原因几乎都是没配长连接事件订阅。解决进入飞书开放平台应用详情事件订阅选长连接模式添加im.message.receive_v1保存后重新发布应用。注意改完事件订阅必须重新发布版本才生效。坑二Agent 之间无法协作。症状是 aiboss 说联系不上队友或者 sessions_send 报错。原因有两个一是tools.agentToAgent.enabled没开或 allow 列表漏了某个 Agent二是目标 Agent 的 workspace 里没有 AGENTS.md它不知道队友的 agentId。解决确认 agentToAgent 开启且 allow 包含全部 5 个 id然后给每个 workspace 补一份完整的 AGENTS.md。坑三workspace 数据混乱。症状是不同 Agent 的记忆互相覆盖或者 aicode 读到了 aicontent 的文件。原因是多个 Agent 共用了同一个 workspace 路径。解决检查 agents.list 里每个 Agent 的 workspace 是否唯一建议目录名和 Agent id 保持一致比如 aiboss 对应 workspace-boss。坑四消息路由错误。症状是发给 aicode 的消息被 aicontent 回复。原因是 bindings 里的 accountId 和 agentId 没对齐或者 channels 里的账号 key 和 bindings 里的 accountId 不一致。解决把 channels.feishu.accounts 的 key、bindings 的 accountId、bindings 的 agentId、agents.list 的 id 四者拉出来逐行核对必须完全一致。坑五id 大小写导致配置失效。症状是配置看起来没问题但 Agent 起不来或消息不路由。原因是 id 里混用了大小写比如写成AIBoss或aIContent。OpenClaw 对 id 的处理是大小写敏感的混用会导致匹配失败。解决所有 id 统一小写包括 agents.list[].id、channels 账号 key、bindings 的 accountId 和 agentId。检查清单全部小写、无下划线、无空格。坑六模型通道报 401 或超时。症状是 Agent 起来了但回复报错。原因是 TaoToken Key 复制不全、baseUrl 写错或者服务器出网异常。解决先用openclaw models test taotoken/claude-sonnet-4-5单独测通道401 查 Key超时查网络。通道通了再排查 Agent 层。6. 跑通之后把 5 个助理用起来配置跑通只是起点真正让这套系统产生价值的是日常使用方式。几个实测下来比较顺手的做法把 aiboss 拉进一个飞书群当调度入口其他 4 个机器人按需拉进不同的项目群这样资讯、内容、代码、任务各在各的群里干活aiboss 在总群里做协调。定时任务交给 ainews 和 aitask比如 ainews 每天早晚各推一次资讯aitask 在任务截止前提醒。如果你后面想把这套系统接到编码场景里让 aicode 直接参与代码仓库的审查和补全可以了解一下 Coding Plan 的用法它和 OpenClaw 的 Agent 结构能配合起来用。模型通道这边5 个 Agent 共用一个 TaoToken Key轮换和额度管理都只在一处操作比每个 Agent 单独配 Key 省心得多。接入文档在 https://taotoken.net/doc 有更细的参数说明遇到协议层面的问题可以对照查。最后提醒一句5 个 Agent 的 SOUL.md 和 AGENTS.md 是这套系统的灵魂配置只是让它们能跑起来真正决定协作质量的是你怎么写这些角色定义。花点时间把每个 Agent 的职责边界写清楚比反复调配置参数有用得多。