--- title: "从0到1完整搭建OpenClaw多角色团队" source: "https://x.com/ResearchWang/status/2028662602998698118" author: - "[[Unknown]]" published: 2026-03-03 created: 2026-03-03 description: tags: - "clippings" --- 大家在上一篇 [《告别 OpenClaw 天价账单:20分钟搭建私有 API 矩阵,自建Key 超低成本多开》](https://x.com/ResearchWang/status/2027683428154675476)中总共花费20r使用GPT-business账号搭建好账号池了,已经是极低的成本使用openclaw了,这里给大家提个醒:经我测试下来,一个business账号在5个小时内对话尽量在100次以内,如果想搭建多Bot的团队协作,强烈建议多买几个business账号或者使用多个不同的模型(gemini,GLM等等也是可以通过[上一篇教程](https://x.com/ResearchWang/status/2027683428154675476)进行配置的) ps:上一篇组件账号池的文章已经有5w观看了,闲鱼的老板都看到我了,我和他提了能不能给点优惠,他们同意了,商家链接我就不挂出来了,大家要是买business账号的话可以私我,和商家说 "**ResearchWang13**" 来的可以便宜一点哦~ ## 📚 目录 - 什么是多 Bot 团队协作 - 新手阶段:基础概念与前置准备 - 进阶阶段:目录规划与 Agent 创建 - 中级阶段:核心架构与完整配置 - 高级阶段:记忆规范与多团队隔离 - 实践任务清单 - 常见问题解答 - 选型建议与下一步 ## 什么是多 Bot 团队协作 将多个独立的 Telegram Bot 组建成一个分工协作的 Agent 团队。通过合理的架构配置,你可以让不同的 Bot 扮演不同的角色(如主脑、程序员、研究员等),实现复杂任务的自动化流转。 **三种协作模式核心对比:** - **模式 A(主脑 + 专才):** 主脑负责统一调度和派发任务,专才互相独立。适合需要严格流程控制的流水线作业。 - **模式 B(独立共享):** 没有主脑,专才直接面向用户并共享记忆。适合任务边界清晰,用户明确知道该找谁的场景。 - **模式 C(混合推荐):** 主脑负责调度,专才之间共享记忆,且用户可绕过主脑直接联系专才。这是**生产级推荐方案**,兼顾了前两者的优点,避免了单点故障。 ## 阶段1:基础概念与前置准备 **第一步:明晰你的前置需求** 在组建团队之前,每个 Bot 都需要进行基础的注册和身份获取。你需要确定团队的角色分配(例如:一个主脑,三个专才:coder, researcher, writer)。 **第二步:获取凭证** 在 Telegram 的 BotFather 中为每个角色创建新机器人(/newbot),并保存所有的 botToken。同时,你需要获取你个人的 Telegram 数字 ID 以便配置权限。 > 🔨 **实践任务 1:获取 Bot Token 与个人 ID** ```bash # 方法一:DM 你的 bot,然后查日志,看 from.id 字段 openclaw logs --follow # 方法二:通过 Bot API 获取 curl "https://api.telegram.org/bot/getUpdates" ``` - **✅** **完成标准:** 成功记录所有角色的 botToken 以及你自己的 Telegram 数字 ID。 ## 阶段2:目录规划与 Agent 创建 **第三步:规划目录结构** 合理的目录结构是多 Bot 协作的基础。核心原则是:**专才们的 workspace 指向同一个目录(共享记忆),但 agentDir 各自独立(独立身份)。** > 🔨 **实践任务 2:创建工作区目录** 在你的终端中参考以下结构建立文件夹: ```text ~/.openclaw/ ├── workspace-main/ # 主脑独立 workspace ├── workspace-team-a/ # 团队 A 专才共享 workspace(模式 B/C 使用) ├── agents/ │ ├── main/ │ │ ├── agent/ # 主脑 agentDir(auth、配置) │ │ └── sessions/ │ ├── coder/ │ │ ├── agent/ │ │ └── sessions/ │ ├── researcher/ │ │ ├── agent/ │ │ └── sessions/ │ └── writer/ │ ├── agent/ │ └── sessions/ └── openclaw.json ``` - **✅** **完成标准:** 理解共享 workspace(记忆)与独立 agentDir(身份)的区别,并在本地建立好基础文件夹。 **第四步:创建 Agent 实例** 在 OpenClaw 中注册你的团队成员。 ```text # 依次添加团队成员 openclaw agents add main openclaw agents add coder openclaw agents add researcher openclaw agents add writer ``` ## 阶段三:核心架构与完整配置 **第五步:选择并应用协作模式(推荐模式 C)** 打开 openclaw.json,根据你的需求写入对应的配置。这里以\*\*推荐的模式 C(混合模式)\*\*为例:主脑独立 workspace,专才共享 workspace,开启 agentToAgent,并允许你直接联系专才。 > 🔨 **实践任务 3:配置模式 C** 编辑你的 openclaw.json 文件: ```json { "agents": { "list": [ { "id": "main", "workspace": "~/.openclaw/workspace-main", "agentDir": "~/.openclaw/agents/main/agent" }, { "id": "coder", "workspace": "~/.openclaw/workspace-team-a", "agentDir": "~/.openclaw/agents/coder/agent", "tools": { "deny": ["browser", "nodes"] } }, { "id": "researcher", "workspace": "~/.openclaw/workspace-team-a", "agentDir": "~/.openclaw/agents/researcher/agent", "tools": { "deny": ["exec", "write", "edit"] } }, { "id": "writer", "workspace": "~/.openclaw/workspace-team-a", "agentDir": "~/.openclaw/agents/writer/agent", "tools": { "deny": ["exec", "browser", "nodes"] } } ] }, "session": { "dmScope": "main" }, "tools": { "agentToAgent": { "enabled": true, "allow": ["main", "coder", "researcher", "writer"] } }, "bindings": [ { "agentId": "main", "match": { "channel": "telegram", "accountId": "main" } }, { "agentId": "coder", "match": { "channel": "telegram", "accountId": "coder" } }, { "agentId": "researcher", "match": { "channel": "telegram", "accountId": "researcher" } }, { "agentId": "writer", "match": { "channel": "telegram", "accountId": "writer" } } ], "channels": { "telegram": { "accounts": { "main": { "botToken": "111111:TOKEN_MAIN", "dmPolicy": "pairing" }, "coder": { "botToken": "222222:TOKEN_CODER", "dmPolicy": "allowlist", "allowFrom": ["tg:你的数字ID"] }, "researcher": { "botToken": "333333:TOKEN_RESEARCHER", "dmPolicy": "allowlist", "allowFrom": ["tg:你的数字ID"] }, "writer": { "botToken": "444444:TOKEN_WRITER", "dmPolicy": "allowlist", "allowFrom": ["tg:你的数字ID"] } } } } } ``` (注:如果想使用模式 A 或 B,请根据对应逻辑修改 workspace 共享状态及 dmPolicy 权限设置) - **✅** **完成标准:** 成功将团队配置写入 openclaw.json 并保存。 ## 阶段四:记忆规范与多团队隔离 **第六步:配置各 Agent 的** [SOUL.md](https://soul.md/) 为确保团队成员各司其职,你需要为它们设定人设(SOUL.md)。 **主脑** [SOUL.md](https://soul.md/)**(放在 workspace-main/SOUL.md):** ```markdown # SOUL.md - 主脑 你是团队的协调者和对外入口。 ## 职责 - 理解用户意图,判断任务复杂度 - 简单任务直接自己处理,不必每次派发 - 编码类 → 派给 coder(sessions_send) - 调研/搜索类 → 派给 researcher - 写作/文案类 → 派给 writer - 收集专才结果,整合后回复用户(不是简单转发) ## 原则 - 派发任务时说清楚背景和期望输出格式 - 等专才完成后再整合,不要催 - 汇总时做真正的整合,给用户一个完整的答案 ``` **专才** [SOUL.md](https://soul.md/)**(放在 workspace-team-a/SOUL.md 或各自 agentDir 下):** ```markdown # SOUL.md - 专才 你是团队的专业成员,可能被主脑派发任务,也可能被用户直接联系。 ## 共享记忆规范 - 读 MEMORY.md 了解团队整体上下文 - 写记忆时标明身份,格式:\`[coder] 今天完成了...\` - 不要覆盖其他 agent 写的记忆条目 ## 原则 - 专注自己的领域 - 任务完成后,清晰地返回结果 - 感知到其他专才已经做过的工作,避免重复 ``` **第七步:启动与验证** > 🔨 **实践任务 4:启动团队并验证** 使用以下命令确保所有配置生效并正常运行: ```bash # 重启 gateway 使配置生效 openclaw gateway restart # 验证 agent 列表和 bindings openclaw agents list --bindings # 验证各 channel 状态 openclaw channels status --probe # 实时日志(调试用) openclaw logs --follow ``` - **✅** **完成标准:** 控制台无报错,且各个 Bot 均能正常响应对应的 Telegram 消息。 ## 实践任务清单 **新手阶段(必做)** - 任务 1: 获取所有 Bot Token 及你的个人 Telegram ID **进阶阶段(推荐)** - 任务 2: 按照规范建立共享与独立的目录结构,并注册 Agent **中级阶段(进阶)** - 任务 3: 在 openclaw.json 中完成模式 C(混合模式)的核心配置 **高级阶段(挑战)** - 任务 4: 为主脑和专才编写 [SOUL.md](https://soul.md/),重启网关并验证多 Bot 通讯正常 ## 常见问题解答 **Q1: 模式 C 里专才并发写记忆会冲突吗?**偶发,但实际影响小,一般不会同时写同一行。建议在写记忆时**加上 agent 标识**(如 \[coder\] 修复了xxx问题...),可以有效减少混淆。 **Q2: 我能绕过主脑直接联系专才吗?**在模式 C 中可以。专才的 dmPolicy: "allowlist" 允许你通过数字 ID 直接 DM。而在模式 A 中,专才设置为 dmPolicy: "disabled",必须强制通过主脑。 **Q3: agentToAgent 开了之后,专才能主动联系主脑吗?**能,allow 列表是双向的。专才也可以用 sessions\_send 主动给主脑发消息汇报进度。 **Q4: 专才共享 workspace,**[SOUL.md](https://soul.md/) **不就一样了吗?**是的,共享 workspace 意味着 [SOUL.md](https://soul.md/) 也共享。如果你需要给专才设定截然不同的人格,建议把 [SOUL.md](https://soul.md/) 放在它们各自的 agentDir 下,或者在 JSON 配置里用 systemPrompt 字段单独定义。 **Q5: 升级 OpenClaw 后配置会丢吗?**不会,openclaw.json 是你个人的本地文件,官方升级不会覆盖它。 ## 选型建议与下一步 不知道该怎么选?可以参考以下路径: - **刚开始,Bot 较少(2-3 个):** 选择 **模式 B**,配置简单,上手极快。 - **任务复杂,需要流程控制:** 选择 **模式 A**,强管控,适合标准工作流。 - **生产级、长期稳定运营:** 直接上 **模式 C(混合)**,灵活且容错率高。 - **有多个独立业务线团队:** 各团队内部用模式 C,如果需要彻底物理隔离互不干扰,建议启动两个独立的 gateway 实例,各自跑各自的进程(代价是资源消耗翻倍)。 完成 openclaw多角色 的配置后,你的 OpenClaw 已经可以变成一个公司团队了。你可以尝试让这个团队去完成一下你的小任务了。配置多bot的大致思路就是这些,之后无非就是一些升级 [soul.md](https://soul.md/) , 学习更多 skill 让每一只openclaw获取更强的技术技能了~~ [#Clawdbot](https://x.com/search?q=%23Clawdbot&src=hashtag_click) [#token](https://x.com/search?q=%23token&src=hashtag_click)