OpenClaw 多角色配置指南:一个 Gateway 搞定产品经理、工程师、QA 全团队
AI Agent 入门教程进阶10 分钟阅读
学习路径:AI Agent 入门

OpenClaw 多角色配置指南:一个 Gateway 搞定产品经理、工程师、QA 全团队

你以为搭建多角色 AI 团队需要多个机器人、多台服务器?不需要。本文手把手教你用 OpenClaw 的群组路由机制,一个 Gateway 搞定产品经理、工程师、QA 等多个角色,实现真正的 AI 团队协作。

先说结论

你以为搭建一个多角色 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 的「宿主」。

  1. 在 Telegram 搜索 @BotFather,发送 /newbot
  2. 给 Bot 起个名字(比如 lifezhushou
  3. 设置用户名(必须以 bot 结尾,比如 lifezhushou_bot
  4. 复制返回的 Token(长得像 123456:ABC-DEF...

注意:不要泄露这个 Token 值!

然后用这个 Token 把 Bot 接入 OpenClaw:

openclaw gateway add telegram --token 你的_BOT_TOKEN

最后一步配对:

openclaw pairing approve telegram <配对码>

配对码是类似「验证码」的东西,用于确认你有权限操作这个 Bot。一次配对,永久生效。

第二步:开启群组权限(千万别跳过!)

这是最容易踩坑的地方。

默认情况下,Bot 开启了「隐私模式」,只能看到 @ 它的消息。如果你不关掉,Bot 在群里就是个「聋子」。

  1. 回到 @BotFather
  2. 发送 /mybots
  3. 选择你的 Bot
  4. 选择 Bot Settings
  5. 选择 Group Privacy
  6. 选择 Turn off

重点: 改完之后,必须把 Bot 从群里踢出去,再重新拉进来。不重新拉,设置不生效。这是很多人配了半天没反应的根本原因。

第三步:创建群组,拿到 Group ID

每个子 Agent 需要一个专属群组。群组的 ID 就是「路由地址」。

  1. 新建一个 Telegram 群(建议用角色命名,比如「产品经理」)
  2. 把主 Bot 拉进群
  3. 在群里 @ 你的 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 不回复

检查清单:

  1. Bot 的隐私模式关了吗?
  2. Bot 重新拉进群了吗?
  3. 群组 ID 正确吗?
  4. 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 作战室」,随时召唤不同角色协同工作。