Windows平台OpenClaw“养第二只龙虾”完全教程
你已经成功在公司一台不用的电脑上搭建了OpenClaw,并连接了第一个飞书机器人。现在想要“养第二只龙虾”——也就是让OpenClaw同时驱动两个独立的飞书机器人。这篇教程基于我们之前的对话整理而成,专门针对,手把手带你实现“单网关+多Agent”的方案。这个方案资源占用少、管理方便,非常适合在同一台机器上运行多个功能各异的机器人。
写在前面
你已经成功在公司一台不用的电脑上搭建了OpenClaw,并连接了第一个飞书机器人。现在想要“养第二只龙虾”——也就是让OpenClaw同时驱动两个独立的飞书机器人。
这篇教程基于我们之前的对话整理而成,专门针对Windows平台,手把手带你实现“单网关+多Agent”的方案。这个方案资源占用少、管理方便,非常适合在同一台机器上运行多个功能各异的机器人。
📚 核心概念速览
在开始操作前,先花1分钟理解我们要做什么:
| 概念 | 比喻 | 说明 |
|---|---|---|
| 网关 (Gateway) | 信息高速公路 | 你已经运行的OpenClaw主程序,负责维护与飞书的长连接 |
| Agent (大脑) | 工作团队 | 每个独立的机器人“人格”,有自己的记忆和技能 |
| 飞书应用 | 身份证 | 在飞书开放平台创建的应用,每个都有独立的App ID |
| Binding (路由) | 交通规则 | 规定哪张“身份证”的消息交给哪个“大脑”处理 |
我们的目标:在一条“高速公路”上,跑两个独立的“工作团队”。
✅ 准备工作检查
在开始之前,请确认:
-
你的OpenClaw已经在Windows上正常运行
-
第一个飞书机器人可以正常对话
-
你有飞书开放平台的管理员权限(或能自助审批应用发布)
-
PowerShell可以正常运行(建议以管理员身份运行)
📝 第一步:创建第二个飞书应用(办新“身份证”)
这一步和你第一次搭建时完全一样,只是换个名字和头像。
1.1 创建应用
-
访问飞书开放平台
-
点击右上角「创建企业自建应用」
-
填写应用名称(例如“我的二号助手”)、上传应用头像
-
创建成功后,进入应用详情页
-
在「凭证与基础信息」中,复制 App ID 和 App Secret 备用
💡 小提示:建议用文本文件临时保存这两个信息,后面配置时会用到。
1.2 添加机器人能力
在左侧菜单栏,找到「添加应用能力」,点击「机器人」并确认添加。
1.3 配置事件订阅
-
在左侧菜单点击「事件订阅」
-
确保「请求地址配置」处选择的是 「长连接加密」(和你第一个机器人保持一致)
-
在「事件订阅」页面下方,添加以下常用事件:
-
message(接收消息) -
message.read(消息已读) -
(可选)群聊相关事件
-
1.4 开通权限
-
在左侧菜单点击「权限管理」
-
搜索并添加以下常用权限:
im:message(发送消息)
im:message:send_as_bot(以机器人身份发送消息)
im:chat:readonly(获取群聊信息,用于@识别)
im:message.group:readonly(读取群消息)
im:message.p2p:readonly(读取私聊消息)
3. 建议对照你第一个机器人已开通的权限列表,确保两者一致
1.5 发布上线(关键!)
这一步最容易遗漏,但最关键!
-
在左侧菜单点击「版本管理与发布」
-
点击「创建版本」
-
填写版本号(如1.0.0)、更新说明
-
点击「保存」后,再点击「申请发布」
-
等待审核(通常几分钟内自动通过)
⚠️ 注意:如果不发布上线,新添加的权限不会生效,机器人将无法收发消息!
⚙️ 第二步:配置OpenClaw(“大脑”入驻)
现在回到你的Windows服务器,开始修改OpenClaw配置。
2.1 以管理员身份打开PowerShell
在Windows搜索栏输入“PowerShell”,右键点击「Windows PowerShell」,选择「以管理员身份运行」。
2.2 备份配置文件(好习惯)
powershell
Copy-Item C:\Users\你的用户名\.openclaw\openclaw.json C:\Users\你的用户名\.openclaw\openclaw.json.backup
💡 把「你的用户名」替换成你实际的Windows用户名,例如
Copy-Item C:\Users\Administrator\.openclaw\openclaw.json ...
2.3 编辑配置文件
用记事本或VS Code打开配置文件:
powershell
notepad C:\Users\你的用户名\.openclaw\openclaw.json
或者直接通过文件资源管理器导航到 C:\Users\你的用户名\.openclaw\,双击 openclaw.json 打开。
你会看到一个JSON格式的文件。我们需要在三个地方添加内容:
📍 修改点1:添加第二个Agent(大脑)
找到 "agents" 下的 "list" 数组,添加第二个Agent配置:
"agents": {
"list": [
// 你原来的第一个Agent(必须保留)
{
"id": "agent_xiaoming", // 你的第一个Agent ID
"workspace": "C:\\Users\\你的用户名\\.openclaw\\workspaces\\agent_xiaoming"
// ... 其他配置
},
// 👇 新增:第二个Agent
{
"id": "agent_xiaohong", // 给新大脑起个ID
"workspace": "C:\\Users\\你的用户名\\.openclaw\\workspaces\\agent_xiaohong"
// 注意:暂时不需要其他配置,模型等会继承全局设置
}
]
}
Windows路径格式要点:
-
必须用双反斜杠
\\或正斜杠/ -
不能用
~代表用户目录,必须写完整路径 -
路径不能包含中文(如果用户名是中文,可能会遇到问题)
-
📍 修改点2:添加第二个飞书账号
-
找到
"channels"→"feishu"→"accounts",添加第二个飞书应用的凭证:
"channels": {
"feishu": {
"accounts": {
// 你原来的第一个飞书应用
"feishu_app_xiaoming": {
"appId": "你的第一个App ID",
"appSecret": "你的第一个App Secret"
},
// 👇 新增:第二个飞书应用
"feishu_app_xiaohong": {
"appId": "第二个App ID", // 粘贴第一步复制的App ID
"appSecret": "第二个App Secret" // 粘贴第一步复制的App Secret
}
}
}
}
📍 修改点3:添加绑定规则(关键路由)
找到 "bindings" 数组,添加第二条路由规则:
"bindings": [
// 原来的绑定规则:第一个飞书应用给第一个Agent
{
"agentId": "agent_xiaoming",
"match": {
"channel": "feishu",
"accountId": "feishu_app_xiaoming"
}
},
// 👇 新增:绑定规则,把第二个飞书应用和第二个Agent连起来
{
"agentId": "agent_xiaohong",
"match": {
"channel": "feishu",
"accountId": "feishu_app_xiaohong"
}
}
]
这条规则的作用:所有来自 feishu_app_xiaohong 这个飞书应用的消息,都交给 agent_xiaohong 这个大脑处理。
✅ 完整配置示例
把你的配置和这个示例对比一下(注意替换其中的用户名):
{
"agents": {
"list": [
{
"id": "agent_xiaoming",
"workspace": "C:\\Users\\Administrator\\.openclaw\\workspaces\\agent_xiaoming"
},
{
"id": "agent_xiaohong",
"workspace": "C:\\Users\\Administrator\\.openclaw\\workspaces\\agent_xiaohong"
}
]
},
"channels": {
"feishu": {
"accounts": {
"feishu_app_xiaoming": {
"appId": "cli_xxxxx1",
"appSecret": "yyyyy1"
},
"feishu_app_xiaohong": {
"appId": "cli_xxxxx2",
"appSecret": "yyyyy2"
}
}
}
},
"bindings": [
{
"agentId": "agent_xiaoming",
"match": {
"channel": "feishu",
"accountId": "feishu_app_xiaoming"
}
},
{
"agentId": "agent_xiaohong",
"match": {
"channel": "feishu",
"accountId": "feishu_app_xiaohong"
}
}
]
}
保存文件后关闭编辑器。
2.4 创建独立的工作空间(新“办公室”)
在PowerShell中运行:
powershell
# 创建第二个Agent的工作空间目录 mkdir C:\Users\你的用户名\.openclaw\workspaces\agent_xiaohong -Force
这个文件夹会存放新Agent独立的记忆(memory.md)、性格(SOUL.md)和技能。后续你可以分别定制每个机器人的个性。
2.5 重启网关
在PowerShell中运行:
powershell
openclaw gateway restart
如果看到类似 Gateway started successfully 的提示,说明配置成功。
🧪第三步:验证“第二只龙虾”是否成活
3.1 检查Agent列表
在PowerShell中运行:
openclaw agents list
应该能看到两个Agent,包括刚新增的 agent_xiaohong。
3.2 用飞书测试
-
打开飞书客户端,找到你的两个机器人应用
(1)第一个机器人(原来的)(2)第二个机器人(新创建的) -
分别私聊测试
-
对第一个机器人说:“你是谁?”
-
对第二个机器人也说:“你是谁?”
-
-
观察回复
-
两个机器人应该给出不同的回答(因为还没有定制性格,可能回复相似,但可以问它们工作空间路径来区分)
-
可以这样问:“你的工作空间路径是什么?”
-
第二个机器人应该回复你刚创建的
C:\Users\你的用户名\.openclaw\workspaces\agent_xiaohong
-
-
3.3 群聊测试
如果你需要在群里使用:
- 把两个机器人都拉进同一个群
- 分别 @ 它们,应该都能正常响应
- 如果某个机器人不响应,可能是飞书应用权限没发版,或者群里没添加
更多推荐



所有评论(0)