基于 Coze 与 OpenClaw 搭建飞书机器人群组
背景
在企业数字化办公场景中，飞书机器人已经成为团队自动化协作的核心工具。但很多团队在配置机器人时经常遇到多个机器人触发逻辑混乱、指令冲突、Token 浪费等问题。本文将基于 Coze 低代码 AI 开发平台 + OpenClaw 智能代理框架，分享一种清晰可控的飞书机器人群组搭建方案，实现机器人触发逻辑清晰、资源占用低、用户体验优秀。
1. 创建专属单人群，作为机器人调试运行的独立空间
为什么选择单人群？
创建仅包含自己的专属群组是搭建机器人群组的基础，核心优势有三点：
- 隔离调试环境：避免在公共群调试机器人时产生大量无效消息，干扰正常工作交流
- 权限可控：单人群内机器人权限独立，不会误操作公共群资源
- 日志集中：所有机器人运行日志都集中在同一会话中，方便问题排查
操作步骤
打开飞书客户端，点击右上角「+」→ 选择「创建群组」，群组名称建议设置为「Coze 机器人工作群」，成员仅选择自己作为唯一成员，无需添加其他人员，点击「创建」即可完成。
2. 群组设置中添加 Coze 机器人，完成基础配置
单人群创建完成后，即可将 Coze 平台开发的机器人添加到群组中，配合 OpenClaw 框架实现多工具调用能力。
操作步骤
- 进入单人群的群组设置页面，找到「群机器人」选项
- 点击「添加机器人」，选择你在 Coze 平台已开发完成的机器人，或选择「自定义机器人」获取 Webhook 地址
- 完成机器人权限配置：仅开放消息读取、消息发送权限，不开放管理员权限
- 配置安全校验：开启签名校验，避免恶意请求触发机器人
陆续加入自己需要的机器人
OpenClaw 通道配置示例
将机器人的 Webhook 地址配置到 OpenClaw 的飞书通道配置文件中，示例配置如下：
# openclaw 飞书通道配置示例（config.yaml）
channels:
feishu:
enabled: true
app_id: "cli_xxxxxxxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxxxxxxxxxx"
verification_token: "xxxxxxxxxxxxxxxxxxxx"
encrypt_key: "xxxxxxxxxxxxxxxxxxxxxxxx"
webhook_path: "/webhook/feishu"
bot_open_id: "ou_xxxxxxxxxxxxxxxxxxxxxxxx" # 机器人的 open_id
配置完成后重启 OpenClaw 服务，发送测试消息验证机器人是否能正常接收群消息。
3. 使用 @ 触发机器人，逻辑清晰，节省 Token
@触发的核心优势
建议使用 @ 触发方式替代传统的关键词触发，核心优势如下：
- 触发逻辑清晰：用户必须明确 @ 指定要调用的机器人，不会出现多个机器人同时响应同一个关键词的混乱情况
- 节省 Token 消耗：只有被 @ 的机器人会接收和处理消息，其他机器人不会解析未被 @ 的消息，减少无效 Token 消耗约 70% 以上
- 用户体验优秀：用户明确知道自己在和哪个机器人对话，不会出现预期外的回复
OpenClaw 消息处理逻辑示例
OpenClaw 框架默认支持 @ 触发逻辑，示例代码如下：
// OpenClaw 飞书消息处理中间件
async function handleFeishuMessage(ctx) {
const { message, mentions } = ctx.request.body;
// 仅处理被@的消息，未被@直接返回
if (!mentions || !mentions.includes(process.env.FEISHU_BOT_OPEN_ID)) {
return ctx.status = 200;
}
// 移除@提及的文本，提取用户纯指令
const userCommand = message.content.replace(/@<at]+">/g, '').trim();
// 调用 Coze 平台处理用户指令
const result = await cozeClient.run({
query: userCommand,
user_id: ctx.request.body.sender_id.open_id,
conversation_id: ctx.request.body.chat_id
});
// 回复用户消息
await feishuClient.sendMessage({
chat_id: ctx.request.body.chat_id,
content: JSON.stringify({ text: result.content })
});
ctx.status = 200;
}
最佳实践：每个机器人设置清晰的名称和头像，方便用户快速识别要@的对象；指令设计简洁明了，避免复杂的关键词规则。
4. @所有人 不会触发任何机器人，飞书平台原生行为说明
很多用户会疑惑：为什么在群里@所有人的时候，机器人没有响应？这是飞书平台的原生设计：@所有人 的消息中，不会包含任何具体的 mention 列表，因此机器人无法判断是否被@，所以不会触发任何机器人的响应。
这个设计的优势
- 避免@所有人时所有机器人同时响应，产生大量刷屏消息，干扰群聊秩序
- 减少无效的机器人调用，节省服务器和 Token 资源
如果需要通知所有机器人处理某个任务，建议单独@每个需要处理的机器人，或者使用专门的广播指令。
总结
通过「创建专属单人群 + @触发机器人」的方案，有效解决了飞书机器人使用过程中的混乱问题，配合 Coze 低代码平台和 OpenClaw 智能代理框架，可以快速搭建高效、稳定、低成本的机器人群组，提升团队自动化协作效率。