Files
Obsidian/openclaw/从0到1完整搭建OpenClaw多角色团队.md
T
2026-07-21 14:53:24 +08:00

286 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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<token>/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)