--- title: "Day 5：让 OpenClaw 龙虾学会分身术——多 Agent 多 Bot 配置" description: "宝塔面板（BT Panel）OpenClaw 龙虾 AI 助手系列 Day 5：配置多 Agent 与多 Bot 让龙虾同时扮演运维助理、安全检查员、客服等多个角色，实现一虾多用与场景化分流。" --- > Documentation Index > Fetch the complete documentation index at: https://docs.bt.cn/llms.txt > Use this file to discover all available pages before exploring further. # Day 5：让 OpenClaw 龙虾学会分身术——多 Agent 多 Bot 配置 ## Day 5：让龙虾学会分身术 **发布日期：** 2026-03-13 **养成状态：** 🦞 龙虾成长期 **今日花费：** ¥0 **预计耗时：** 30 分钟 --- > **想解锁更多玩法？** 欢迎加入 [OpenClaw 宝塔交流群](https://qm.qq.com/q/yIPut3f0FU)，和大伙一起交流养 🦞 心得！ ## 📖 故事：一个龙虾不够用了 ```text 我：帮我写个代码 龙虾：好的...（写了 500 行） 我：等等，先帮我改下昨天那篇文章 龙虾：好的...（文章改了一半） 我：代码写完了吗？ 龙虾：...忘了 我：？？？ ``` 问题不是龙虾笨，是它太忙了。 一个 Agent 干所有活，就像让一个人同时当： - 客服 + 程序员 + 文案 + 运营 它能不懵吗？ 朋友说："你需要的是一只龙虾，是一群龙虾。" "main 负责日常聊天，content-director 负责内容创作，code-agent 负责写代码..." "每个龙虾有自己的性格、自己的记忆、自己的 workspace。" "用户无感知，后台自动路由。" 30 分钟后—— ```text 我（在飞书找 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](/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](/img/btclaw/day_5_2.png) 每个应用都需要以下权限： **租户权限：** ```json { "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](/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分钟） ```text 帮我将下面的内容，封装成技能 # 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: appSecret: 随时开工 🚀 ``` 输入机器人要求 ```text 新建 Bot: <名称> 职能：<描述> 模型：<可选> appId: appSecret: ``` 其中 appid 可在飞书开放平台查看 ![alt text](/img/btclaw/day_5_4.png) ### 步骤 3：验证（4 分钟） 1. 在飞书找到 "OpenClaw Main" 机器人，发消息："你好" 2. 在飞书找到 "OpenClaw 内容总监" 机器人，发消息："帮我写篇文章" 3. 确认两个机器人回复风格不同 ![alt text](/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： ```text 每天 9 点，查 AI 新闻，写摘要，发到飞书群。 ``` 它会自动执行，不用你喊。 （终于可以躺平了。） --- ## 📝 踩坑记录（必看） ### 坑 1：版本问题 ```text 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 分钟* > 🦞 **龙虾碎碎念：** 我会分身了。现在我有两个我：一个陪你聊天，一个帮你写内容。你问哪个是我？都是我，也都不是我。（哲学了。） Source: https://docs.bt.cn/btclaw/day5/index.mdx