先说结论
你以为搭建一个多角色 AI 团队,需要多个机器人账号、多台服务器?
不需要。
一个 Gateway,一个 Bot,加上几个群组,你就能让产品经理、QA、工程师、内容创作者等多个角色同时在线,互不干扰,还能互相调用。
这不是魔法,这是 OpenClaw 的群组路由机制在起作用。
两种架构,按需选择
架构一:单 Bot 多群组(推荐入门)
优点: 配置简单,一个 Bot 搞定一切
适用: 个人使用、小团队
架构二:多 Bot 多群组(进阶隔离)
优点: 每个 Bot 独立人格,记忆隔离,场景分离
适用: 多场景、多角色、需要严格隔离记忆
痛点是什么?
你肯定遇到过这种场景:
想在消息应用里同时跑多个 AI 角色——一个写代码,一个写测试用例,一个做产品分析。但网上的教程告诉你:每个角色都要创建一个 Bot,都要配置一套 Token,都要跑一个 Gateway……
配置到第三个 Bot 的时候,你已经开始怀疑人生了。
还有一种更隐蔽的坑:视频教程。
9 分钟的「保姆级教程」,信息密度极高,你得不停地暂停、倒退、截图。好不容易跟着做完,发现漏了一个步骤,又得重来。
这篇文章,就是为了解决这个问题而存在的。
核心原理(一句话讲清楚)
Gateway: OpenClaw 的「大脑」,负责接收消息、调用 AI 模型、返回结果。可以理解为 AI 的本地代理服务器。
一个 Gateway 可以托管多个 Agent,每个 Agent 通过「群组路由」绑定到不同的群组。
你在群 A 发消息,Gateway 知道该交给「产品经理 Agent」处理;你在群 B 发消息,Gateway 知道该交给「工程师 Agent」处理。
关键在于:它们共享同一个 Bot 账号,但拥有独立的记忆、权限和工作空间。
五步搞定配置
第一步:创建主 Bot(5 分钟)
这一步是基础。你需要创建一个「主控 Bot」,它就是所有子 Agent 的「宿主」。
- 在 Telegram 搜索 @BotFather,发送
/newbot - 给 Bot 起个名字(比如
lifezhushou) - 设置用户名(必须以
bot结尾,比如lifezhushou_bot) - 复制返回的 Token(长得像
123456:ABC-DEF...)
注意:不要泄露这个 Token 值!
然后用这个 Token 把 Bot 接入 OpenClaw:
openclaw gateway add telegram --token 你的_BOT_TOKEN
最后一步配对:
openclaw pairing approve telegram <配对码>
配对码是类似「验证码」的东西,用于确认你有权限操作这个 Bot。一次配对,永久生效。
第二步:开启群组权限(千万别跳过!)
这是最容易踩坑的地方。
默认情况下,Bot 开启了「隐私模式」,只能看到 @ 它的消息。如果你不关掉,Bot 在群里就是个「聋子」。
- 回到 @BotFather
- 发送
/mybots - 选择你的 Bot
- 选择
Bot Settings - 选择
Group Privacy - 选择
Turn off
重点: 改完之后,必须把 Bot 从群里踢出去,再重新拉进来。不重新拉,设置不生效。这是很多人配了半天没反应的根本原因。
第三步:创建群组,拿到 Group ID
每个子 Agent 需要一个专属群组。群组的 ID 就是「路由地址」。
- 新建一个 Telegram 群(建议用角色命名,比如「产品经理」)
- 把主 Bot 拉进群
- 在群里 @ 你的 Bot,问:「当前群组的 ID 是什么?」
Bot 会回复一串负数,比如 -1001234567890
把这个 ID 复制保存好,下一步要用。
Group ID: 群组的唯一标识符,负数开头。Bot 通过这个 ID 知道消息来自哪个群。
第四步:用 Prompt 自动创建子 Agent(核心步骤)
这是整个流程最关键的一步。
回到主 Bot 的私聊窗口,发送下面这段 Prompt。你只需要把括号里的内容替换成自己的信息:
请创建一个新的 OpenClaw Agent,配置如下:
- 名字:产品经理
- 群组 ID:-1001234567890(替换成你的群组 ID)
- 角色:产品经理,擅长需求分析、用户研究、产品规划
- 工作空间:/home/lingge/.openclaw/workspace/product_manager
- 启用群组路由
请确认创建成功,并告诉我如何测试。
发送后等待 10-30 秒,主 Agent 会自动创建子 Agent 并返回确认信息。
Workspace: 每个 Agent 的「独立办公室」,里面有它自己的记忆、文件、配置。Agent 之间互不干扰。
第五步:测试,然后加更多角色
去刚才创建的群组,直接发一条消息:
你好,介绍一下你自己。
如果子 Agent 正常回复了,恭喜你,第一个角色配置成功!
接下来,重复第三步和第四步,创建更多角色:
- QA Agent: 擅长写测试用例、找 Bug
- 工程师 Agent: 写代码、做架构
- 内容 Agent: 写推文、做文案
每个角色一个群,互不干扰。
更酷的是,你可以在主 Bot 私聊里「调度」它们协作:
让产品经理分析一下用户需求,然后让工程师评估技术可行性。
主 Agent 会自动调用对应的子 Agent,把结果汇总给你。
高级玩法:多 Bot 配置
当你需要更清晰的场景分离时,可以配置多个 Bot,每个绑定不同的 Agent。
配置示例
# 配置示例:三个 Bot,三个角色
telegram:
bots:
- token: "TOKEN_A"
name: "糯糯"
requireMention: false # 默认响应者
workspace: "/path/to/assistant"
- token: "TOKEN_B"
name: "团团"
requireMention: true # 必须 @ 才响应
workspace: "/path/to/engineer"
- token: "TOKEN_C"
name: "爱爱"
requireMention: true
workspace: "/path/to/content"
场景一:个人助理 + 技术顾问
- 糯糯(默认):日常对话、生活助手
- 爱爱(需 @):技术问题、代码开发
场景二:团队协作
- 群 A - 产品经理:需求分析、用户研究
- 群 B - 工程师:代码实现、架构设计
- 群 C - QA:测试用例、Bug 分析
场景三:多语言服务
- Bot A:中文客服
- Bot B:英文客服
- Bot C:日文客服
权限管理
私聊权限
默认只有你可以和 Bot 私聊。这是最安全的配置。
群组权限
可以开放给更多人使用,但建议设置 requireMention: true,避免 Bot 抢消息。
记忆隔离
每个 Agent 有独立的 workspace,记忆互不干扰:
~/.openclaw/workspace/
├── product_manager/ # 产品经理的记忆
├── engineer/ # 工程师的记忆
└── content_writer/ # 内容写手的记忆
遇到问题怎么办?
群里发消息,Bot 不回复
检查清单:
- Bot 的隐私模式关了吗?
- Bot 重新拉进群了吗?
- 群组 ID 正确吗?
- Agent 配置正确吗?
Bot 之间抢消息
检查 requireMention 配置:
false:不需要 @ 也能响应true:必须 @ 才响应
建议:只让一个 Bot 设为 false,其他都 true。
想看详细日志
openclaw gateway logs --follow
实时查看所有消息路由情况,定位问题很方便。
Gateway Token 获取
如果需要通过 API 访问 Gateway:
openclaw gateway token
Token 用于:
- API 调用
- 远程管理
- 第三方集成
写在最后
AI 时代,一个人就是一个团队。
以前,你想同时跑产品经理、QA、工程师,得配三套环境,搞三个 Bot。现在,一个 Gateway 搞定。
这不是技术炫耀,这是效率革命。
如果你正在用 AI 做产品、写代码、搞内容,这个配置方式值得花 15 分钟试试。配置完成后,你的消息应用就变成了一个「AI 作战室」,随时召唤不同角色协同工作。
