docs: 新增飞书应用权限配置教程

docs/.vitepress/config.ts

@@ -234,6 +234,7 @@ const zhSidebar = [
   {
     text: "帮助",
     items: [
+      { text: "飞书应用权限配置", link: "/zh/guide/feishu-permissions" },
       { text: "Windows 内测使用指南", link: "/zh/guide/windows-beta" },
       { text: "更新指南", link: "/zh/guide/update" },
       { text: "修复指南", link: "/zh/guide/troubleshooting" },

docs/zh/guide/feishu-permissions.md

@@ -0,0 +1,71 @@
+# 飞书应用权限配置
+
+部分技能（如「牛马锐评」）需要读取飞书群聊消息来采集数据。如果你的 Agent 提示**缺少飞书消息读取权限**，按照本教程开通即可。
+
+::: tip ⏱ 预计用时
+整个流程 1-2 分钟，自建应用审核一般秒通过。
+:::
+
+## 前置条件
+
+- 你已经完成了 [飞书渠道配置](/zh/guide/channels/feishu)，Agent 能正常收发消息
+- 你是飞书应用的**所有者**或**管理员**（如果不是，请让管理员帮你操作）
+
+## 第 1 步：打开飞书开放平台
+
+访问 [飞书开放平台](https://open.feishu.cn)，点击右上角**「开发者后台」**进入管理页面。
+
+![打开飞书开放平台，点击右上角「开发者后台」](/assets/feishu/perm-step1-open-platform.jpg)
+
+## 第 2 步：找到你的应用
+
+在「企业自建应用」列表中，找到你的 nexu/OpenClaw 飞书应用（通常名称为你在配置时创建的应用名），点击进入。
+
+![在企业自建应用列表中找到你的应用](/assets/feishu/perm-step2-find-app.jpg)
+
+## 第 3 步：开通消息读取权限
+
+1. 在左侧菜单中点击**「权限管理」**
+2. 点击**「开通权限」**按钮
+3. 在弹窗的搜索框中输入 `im:message:readonly`
+4. 选择**「用户身份权限」（user_access_token）**标签页
+5. 找到**「获取单聊、群组消息」**（`im:message:readonly`），点击右侧的**「开通权限」**
+6. 点击右下角**「确认开通权限」**
+
+![权限管理页面：搜索 im:message:readonly 并开通](/assets/feishu/perm-step3-add-permission.jpg)
+
+::: warning 注意选择权限类型
+搜索结果中可能同时出现「应用身份权限」和「用户身份权限」两个标签页。**请确保在「用户身份权限（user_access_token）」标签页下开通**，这样 Agent 才能以应用身份读取群消息。
+:::
+
+## 第 4 步：验证
+
+回到 Agent 对话，告诉它「权限已开通」或重新触发技能，Agent 会自动重新检测权限。
+
+如果检测通过，你会看到飞书消息读取能力显示为 ✅。
+
+## 常见问题
+
+### Q: 开通权限需要审核吗？
+
+自建应用的权限开通一般**立即生效**，不需要额外审核。如果你的企业开启了权限审批流程，可能需要管理员批准。
+
+### Q: 我不是应用管理员怎么办？
+
+请联系应用的所有者或你的飞书管理员，让他们按照上述步骤开通权限。你可以把这个页面的链接发给他们。
+
+### Q: 开通了权限但 Agent 还是提示没有？
+
+1. 等待几秒钟后重试——权限生效可能有短暂延迟
+2. 确认你开通的是 `im:message:readonly` 而不是其他类似名称的权限
+3. 确认是在正确的应用下开通的（你可能有多个飞书应用）
+
+### Q: 这个权限能读取哪些消息？
+
+`im:message:readonly` 允许应用读取**它所在群聊**中的消息。应用只能读取它被添加到的群的消息，无法读取它不在的群或私聊。
+
+---
+
+::: info 💡 需要帮助？
+如果遇到其他问题，欢迎[联系我们](/zh/guide/contact)。
+:::