# Day 5：让 OpenClaw 龙虾学会分身术——多 Agent 多 Bot 配置

> 宝塔面板（BT Panel）OpenClaw 龙虾 AI 助手系列 Day 5：配置多 Agent 与多 Bot 让龙虾同时扮演运维助理、安全检查员、客服等多个角色，实现一虾多用与场景化分流。

# Day 5：让龙虾学会分身术

**发布日期：** 2026-03-13  
**养成状态：** 🦞 龙虾成长期  
**今日花费：** ¥0  
**预计耗时：** 30 分钟

---
> **想解锁更多玩法？** 欢迎加入 [OpenClaw 宝塔交流群](https://qm.qq.com/q/yIPut3f0FU)，和大伙一起交流养 🦞 心得！

## 📖 故事：一个龙虾不够用了

```
我：帮我写个代码
龙虾：好的...（写了 500 行）

我：等等，先帮我改下昨天那篇文章
龙虾：好的...（文章改了一半）

我：代码写完了吗？
龙虾：...忘了

我：？？？
```

问题不是龙虾笨，是它太忙了。

一个 Agent 干所有活，就像让一个人同时当：
- 客服 + 程序员 + 文案 + 运营

它能不懵吗？

朋友说："你需要的是一只龙虾，是一群龙虾。"

"main 负责日常聊天，content-director 负责内容创作，code-agent 负责写代码..."

"每个龙虾有自己的性格、自己的记忆、自己的 workspace。"

"用户无感知，后台自动路由。"

30 分钟后——

```
我（在飞书找 main）：今天天气怎么样
main：东莞 25 度，晴天。要出门吗？

我（在飞书找内容总监）：帮我改下这篇文章
内容总监：结构建议调整，第三段可以...

我（在飞书找代码助手）：写个 Python 脚本
代码助手：好的，用哪个库？需要处理什么数据？
```

这就对了。专业的人做专业的事。

---

## 🎯 今天只做一件事

**配置多 Bot 多 Agent，让龙虾学会分身术。**

最终效果：
- 飞书上有 N 个机器人（main、内容总监、代码助手...）
- 每个机器人对应一个独立的 Agent
- 每个 Agent 有自己的性格、记忆、workspace

---

## 📋 准备材料（5 分钟）

### 1. N 个飞书应用

每个 Agent 需要一个飞书机器人。今天我们先配 2 个：
- **main** — 日常聊天
- **content-director** — 内容创作

打开 [飞书开放平台](https://open.feishu.cn/)，创建应用：

![alt text](https://docs.bt.cn/img/btclaw/day_5_1.png)

**应用 1：main**
1. 创建应用 → 名称填 "OpenClaw Main"
2. 开启"机器人能力"
3. 开启"长连接事件订阅" → 订阅 `im.message.receive_v1`
4. 复制 App ID 和 App Secret（先存好）
5. 点"发布"

**应用 2：content-director**
1. 创建应用 → 名称填 "OpenClaw 内容总监"
2. 开启"机器人能力"
3. 开启"长连接事件订阅" → 订阅 `im.message.receive_v1`
4. 复制 App ID 和 App Secret（先存好）
5. 点"发布"

**坑：** 别忘了点"发布"！我忘了，debug 了 20 分钟。

---

### 2. 配置飞书权限
点击"权限管理"，导入权限：

![alt text](https://docs.bt.cn/img/btclaw/day_5_2.png)

每个应用都需要以下权限：

**租户权限：**
```
{
  "scopes": {
    "tenant": [
      "bitable:app",
      "bitable:app:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "docs:doc",
      "docs:document.content:read",
      "docs:document:copy",
      "docs:document:import",
      "docs:event.document_edited:read",
      "docx:document",
      "docx:document.block:convert",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive",
      "drive:drive.search:readonly",
      "drive:drive:readonly",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:update",
      "im:resource",
      "task:task:read",
      "task:task:write",
      "vc:meeting:readonly",
      "wiki:wiki",
      "wiki:wiki:readonly"
    ],
    "user": [
      "contact:contact.base:readonly",
      "im:message.send_as_user"
    ]
  }
}
```

**回调事件：**
点击"回调事件"，添加事件，并开启长连接

![alt text](https://docs.bt.cn/img/btclaw/day_5_3.png)

- `im.message.receive_v1`（接收消息）
- `im.chat.member.bot.added_v1`（机器人进群）

---

## 🔧 三个步骤（25 分钟）
```bash
1. 飞书开放平台创建 N 个应用 → 拿到 App ID + App Secret
2. 每个应用开启"机器人能力" + "长连接事件订阅"（im.message.receive_v1）+ 发版
3. OpenClaw 配置 agents.list + channels.feishu.accounts + bindings
```

### 步骤 1：备份配置（1 分钟）

```bash
cp /root/.openclaw/openclaw.json /root/.openclaw/openclaw.json.bak_$(date +%Y%m%d_%H%M%S)
```

**先备份，再折腾。** 这是铁律。

---

### 步骤 2：一键搭建（2分钟）
```
帮我将下面的内容，封装成技能
# OpenClaw 多 Bot 多 Agent 一键搭建

## 指令格式
新建 Bot: <名称>
职能：<描述>
模型：<可选，默认 bailian/qwen3.5-plus>
appId: <飞书 App ID>
appSecret: <飞书 App Secret>
## 自动化流程
### 1. 解析输入
- Bot 名称 → agentId（小写 + 连字符）+ 显示名称
- 职能 → workspace 路径
- 模型 → model.primary
- appId/appSecret → 直接填入配置
### 2. 执行 5 步指令
1. 备份配置
2. 创建 Agent
3. 添加飞书账号 + 填入凭证
4. 绑定路由
5. 重启 + 验证
### 3. 输出验证结果
- agents list
- bindings 确认
- 测试消息发送
📝 示例
你说：
新建 Bot: lukas-product
职能：产品助理
模型：bailian/qwen3.5-plus
appId: cli_xxxx
appSecret: xxxx

我自动执行：
# 1️⃣ 备份
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak_$(date +%Y%m%d_%H%M%S)

# 2️⃣ 创建 Agent
openclaw agents add product-assistant \
  --workspace /root/.openclaw/workspace-product \
  --model bailian/qwen3.5-plus \
  --non-interactive

# 3️⃣ 添加飞书账号 + 凭证
openclaw channels add \
  --channel feishu \
  --account product-assistant \
  --name "Lukas-产品助理"

openclaw config set "channels.feishu.accounts.product-assistant.appId" "cli_xxxxxx"
openclaw config set "channels.feishu.accounts.product-assistant.appSecret" "xxxxx"

# 4️⃣ 绑定路由
openclaw agents bind \
  --agent product-assistant \
  --bind "feishu:product-assistant"

# 5️⃣ 重启 + 验证
openclaw gateway restart
openclaw agents list
openclaw config get bindings
✅ 验证测试
配置完成后，我会：
检查 agents list 是否新增成功
检查 bindings 路由是否正确
发送测试消息确认 Bot 响应
现在可以直接给我指令了！ 格式：
新建 Bot: <名称>
职能：<描述>
模型：<可选>
appId: <xxx>
appSecret: <xxx>

随时开工 🚀
```

输入机器人要求
```
新建 Bot: <名称>
职能：<描述>
模型：<可选>
appId: <xxx>
appSecret: <xxx>
```
其中 appid 可在飞书开放平台查看

![alt text](https://docs.bt.cn/img/btclaw/day_5_4.png)

### 步骤 3：验证（4 分钟）
1. 在飞书找到 "OpenClaw Main" 机器人，发消息："你好"
2. 在飞书找到 "OpenClaw 内容总监" 机器人，发消息："帮我写篇文章"
3. 确认两个机器人回复风格不同

![alt text](https://docs.bt.cn/img/btclaw/day_5_5.png)

---

## ✅ 完成检查

- [ ] 飞书上创建了 2 个应用（main + content-director）
- [ ] 每个应用都开启了机器人能力和消息订阅
- [ ] `openclaw agents list` 能看到 2 个 Agent
- [ ] `openclaw agents list --bindings` 能看到绑定关系
- [ ] `openclaw channels status --probe` 显示通道在线
- [ ] 两个机器人都能正常回复

**都完成了？** 恭喜你！龙虾会分身了！🎉

现在你有：
- **main** — 陪你日常聊天
- **content-director** — 帮你写内容

---

## 🎯 明天继续

明天我们让龙虾学会主动干活。

设个 cron：

```
每天 9 点，查 AI 新闻，写摘要，发到飞书群。
```

它会自动执行，不用你喊。

（终于可以躺平了。）

---

## 📝 踩坑记录（必看）

### 坑 1：版本问题

```
Error: Session file path must be within sessions directory
```

**原因：** openclaw 版本低于 2026-02-12。

**解决：**

```bash
# ❌ 不要执行 openclaw update（会删库）
# ✅ 重新运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
```

---

### 坑 2：飞书权限不足

**现象：** 机器人收不到消息或无法回复。

**检查：**
1. 飞书开放平台 → 权限管理 → 确认权限已添加
2. 确认已点"发布"
3. 确认回调事件 `im.message.receive_v1` 已订阅

---

### 坑 3：bindings 不生效

**检查：**
```bash
openclaw agents list --bindings
openclaw channels status --probe
openclaw logs --follow
```

看日志里有没有路由错误。

---

## 🚀 进阶玩法

### 场景 1：一个 Bot 多个 Agent（按群聊路由）

如果你只有一个飞书 Bot，但想让不同群聊路由到不同 Agent：

```json
"bindings": [
  {
    "agentId": "main",
    "match": {
      "channel": "feishu",
      "accountId": "main"
    }
  },
  {
    "agentId": "content-director",
    "match": {
      "channel": "feishu",
      "accountId": "main",
      "peer": {
        "kind": "group",
        "id": "oc_xxxxxxx"
      }
    }
  }
]
```

**效果：** 私聊找 main，特定群聊找 content-director。

---

*最后更新：2026-03-13*  
*作者：Bacon 大王*  
*状态：龙虾成长期 Day 5/∞*  
*字数：约 1800 字*  
*阅读时间：约 10 分钟*

> 🦞 **龙虾碎碎念：** 我会分身了。现在我有两个我：一个陪你聊天，一个帮你写内容。你问哪个是我？都是我，也都不是我。（哲学了。）