OpenClaw 飞书机器人配置指南
用 OpenClaw 做飞书机器人时,默认配置下,群里的消息必须 @机器人 才能触发回复。这在很多场景下很不方便——如果希望机器人在群里"隐身"工作,不用 @ 就能自动监听和回复,需要额外配置。
问题描述
现象:
- 飞书群里 @ 机器人 → 正常回复 ✅
- 飞书群里不 @ 机器人 → 没有任何反应 ❌
OpenClaw 飞书机器人默认配置下群消息需@触发回复。若希望隐身工作免@自动监听,需在框架配置中将 requireMention 设为 false,同时在飞书开放平台申请 im:message.group_msg 敏感权限。权限审批通过后必须重新发布应用方可生效。建议优先使用 WebSocket 长连接模式,Webhook 模式需额外配置验证 Token 与加密密钥。
用 OpenClaw 做飞书机器人时,默认配置下,群里的消息必须 @机器人 才能触发回复。这在很多场景下很不方便——如果希望机器人在群里"隐身"工作,不用 @ 就能自动监听和回复,需要额外配置。
现象:
环境:
在 openclaw.json 中找到飞书渠道配置:
"channels":{"feishu":{"requireMention":false,...}}
将 requireMention 设为 false,让 OpenClaw 不再强制要求 @ 机器人。
但这还不够 ❌
修改 OpenClaw 配置后测试,发现消息依然收不到。
查日志发现:消息根本没有到达 OpenClaw——问题出在飞书平台层面。
飞书默认只推送 @机器人 的消息到应用。如果要接收群里所有消息(不限于 @),需要在飞书开放平台申请一个敏感权限:
权限名称:im:message.group_msg(获取群组中所有消息)
im:message.group_msg → 申请开通权限生效后,在群里发消息不用 @ 机器人,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 | 接收单聊消息 | 基础权限 | 接收私信 |
im:message.group_msg 是敏感权限
im:message.group_at_msg:readonly(基础权限)requireMention: false 的作用
false 后,OpenClaw 不会强制要求消息必须 @ 机器人verificationToken 和 encryptKey飞书群消息免 @ 触发机器人的关键就两步:
requireMention: falseim:message.group_msg 敏感权限并重新发布应用两个缺一不可。按照这个流程配置,应该就能实现群里自由对话了。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online