飞书应用权限配置

部分技能（如「牛马锐评」）需要读取飞书群聊消息来采集数据。如果你的 Agent 提示缺少飞书消息读取权限，按照本教程开通即可。

⏱ 预计用时

整个流程 1-2 分钟，自建应用审核一般秒通过。

前置条件

• 你已经完成了 飞书渠道配置，Agent 能正常收发消息
• 你是飞书应用的所有者或管理员（如果不是，请让管理员帮你操作）

第 1 步：打开飞书开放平台

访问 飞书开放平台，点击右上角**「开发者后台」**进入管理页面。

第 2 步：找到你的应用

在「企业自建应用」列表中，找到你的 nexu/OpenClaw 飞书应用（通常名称为你在配置时创建的应用名），点击进入。

第 3 步：开通消息读取权限

1. 在左侧菜单中点击**「权限管理」**
2. 点击**「开通权限」**按钮
3. 在弹窗的搜索框中输入 im:message:readonly
4. 选择**「用户身份权限」（user_access_token）**标签页
5. 找到**「获取单聊、群组消息」（im:message:readonly），点击右侧的「开通权限」**
6. 点击右下角**「确认开通权限」**

注意选择权限类型

搜索结果中可能同时出现「应用身份权限」和「用户身份权限」两个标签页。请确保在「用户身份权限（user_access_token）」标签页下开通，这样 Agent 才能以应用身份读取群消息。

第 4 步：验证

回到 Agent 对话，告诉它「权限已开通」或重新触发技能，Agent 会自动重新检测权限。

如果检测通过，你会看到飞书消息读取能力显示为 ✅。

常见问题

Q: 开通权限需要审核吗？

自建应用的权限开通一般立即生效，不需要额外审核。如果你的企业开启了权限审批流程，可能需要管理员批准。

Q: 我不是应用管理员怎么办？

请联系应用的所有者或你的飞书管理员，让他们按照上述步骤开通权限。你可以把这个页面的链接发给他们。

Q: 开通了权限但 Agent 还是提示没有？

1. 等待几秒钟后重试——权限生效可能有短暂延迟
2. 确认你开通的是 im:message:readonly 而不是其他类似名称的权限
3. 确认是在正确的应用下开通的（你可能有多个飞书应用）

Q: 这个权限能读取哪些消息？

im:message:readonly 允许应用读取它所在群聊中的消息。应用只能读取它被添加到的群的消息，无法读取它不在的群或私聊。

---

💡 需要帮助？

如果遇到其他问题，欢迎联系我们。