OpenClaw 飞书机器人配置：群消息免@自动回复

使用 OpenClaw 搭建飞书机器人时，默认配置下群消息需 @ 机器人 才能触发回复。若希望机器人在群内'隐身'工作，无需@即可自动监听和回复，需进行额外配置。

本文介绍该问题的完整解决方案。

问题描述

现象：

• 飞书群里 @ 机器人 → 正常回复 ✅
• 飞书群里不 @ 机器人 → 没有任何反应 ❌

环境：

• OpenClaw 框架
• 飞书自建应用（机器人）
• WebSocket 长连接模式

解决过程

第一步：修改 OpenClaw 配置

在 openclaw.json 中找到飞书渠道配置：

"channels":{"feishu":{"requireMention":false,...}}

将 requireMention 设为 false，让 OpenClaw 不再强制要求 @ 机器人。

但这还不够 ❌

第二步：申请飞书平台权限

修改 OpenClaw 配置后测试，发现消息依然收不到。

查日志发现：消息根本没有到达 OpenClaw——问题出在飞书平台层面。

飞书默认只推送 @ 机器人 的消息到应用。如果要接收群里所有消息（不限于 @），需要在飞书开放平台申请一个敏感权限：

权限名称：im:message.group_msg（获取群组中所有消息）

第三步：在飞书开放平台申请权限

1. 打开 飞书开放平台，进入你的应用
2. 事件与回调 → 事件配置 → 接收消息 → 获取群组中所有信息 (敏感权限) im:message.group_msg → 申请开通

第四步：验证效果

权限生效后，在群里发消息不用 @ 机器人，OpenClaw 就能正常收到并自动回复了 ✅

完整配置参考

OpenClaw 飞书渠道配置（完整示例）

"channels":{"feishu":{"enabled":true,"appId":"cli_xxxx","appSecret":"xxxx","domain":"feishu","connectionMode":"websocket","requireMention":false,"dmPolicy":"allowlist","allowFrom":["ou_你的用户 ID"],"groupAllowFrom":["ou_你的用户 ID"],"groupPolicy":"allowlist","groups":{"*":{"enabled":true}}}}

需要申请的飞书权限清单

权限标识	名称	类型	说明
im:message	发送消息	基础权限	机器人发消息
im:message.group_at_msg:readonly	接收群@消息事件	基础权限	接收群内@机器人消息
im:message.group_msg	获取群组中所有消息	敏感权限	接收群内所有消息（不限于@）
im:message.p2p_msg:readonly	接收单聊消息	基础权限	接收私信

注意事项

1. im:message.group_msg 是敏感权限
   • 需要企业管理员审批
   • 审批通过后才能使用
   • 建议同时申请 im:message.group_at_msg:readonly（基础权限）
2. 权限申请后需要重新发布应用
   • 权限审批通过后，必须重新发布版本才能生效
3. requireMention: false 的作用
   • 设为 false 后，OpenClaw 不会强制要求消息必须 @ 机器人
   • 但如果飞书平台没有相应权限，消息根本不会推送到 OpenClaw
4. WebSocket vs Webhook
   • 推荐使用 WebSocket 模式，更简单
   • 如果用 Webhook 模式，还需要额外配置 verificationToken 和 encryptKey

相关文档

• OpenClaw 飞书渠道文档
• 飞书开放平台权限说明

总结

飞书群消息免@触发机器人的关键就两步：

1. OpenClaw 侧：requireMention: false
2. 飞书平台侧：申请 im:message.group_msg 敏感权限并重新发布应用

两个缺一不可。按照这个流程配置，应该就能实现群里自由对话了。