用 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 敏感权限并重新发布应用

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

---

首发于我的博客：https://blog.csdn.net/QIU176161650
欢迎交流讨论！