跳到正文
cccskills
免费在 GitHub 公开

feishu-troubleshoot

飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令(/feishu_doctor)。常见问题可随时查阅。

诊断命令用于排查复杂问题(多次授权仍失败、自动授权无法解决等), 会检查账户配置、API 连通性、应用权限、用户授权状态,并生成详细的诊断报告和解决方案。

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.2 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

飞书插件问题排查

❓ 常见问题(FAQ)

卡片按钮点击无反应

现象:点击卡片按钮后没有任何反应,然后提示报错.

原因:应用未开通「消息卡片回传交互」权限。

解决步骤:

  1. 登录飞书开放平台:https://open.feishu.cn/app
  2. 选择您的应用 → 事件与回调
  3. 在回调配置中,修改订阅方式为"长链接"并添加回调 "卡片回传交互"(card.action.trigger)
  4. 创建应用版本 → 提交审核 → 发布

🔍 诊断命令(深度工具)

注意:诊断命令仅用于排查复杂/疑难的权限相关问题。常规权限问题会自动触发授权流程,无需手动诊断。

何时使用诊断:

  • 多次授权后仍然报错
  • 自动授权流程无法解决的问题
  • 需要查看完整的权限配置状态

使用方法:

在飞书聊天会话中直接输入(作为用户消息发送):

/feishu doctor

诊断命令会检查:

  • 📋 诊断摘要(首先展示):

    • 总体状态(✅ 正常 / ⚠️ 警告 / ❌ 失败)
    • 发现的问题列表和简要描述
  • 环境信息:

    • 插件版本
  • 账号信息:

    • 凭证完整性(appId, appSecret 掩码)
    • 账户启用状态
    • API 连通性测试
    • Bot 信息(名称和 openId)
  • 应用身份权限:

    • 应用已开通的必需权限数量
    • 缺失的必需权限列表
    • 一键申请链接(自动带上缺失权限参数)
  • 用户身份权限:

    • 用户授权状态统计(✓ 有效 / ⟳ 需刷新 / ✗ 已过期)
    • Token 自动刷新状态(是否包含 offline_access)
    • 权限对照表(应用已开通 vs 用户已授权,逐项对比)
    • 应用权限缺失时的申请指引和链接
    • 用户授权不足时的重新授权操作方法

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

飞书多维表格(Bitable)的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**: (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录(行数据) (3) 需要管理字段(列)、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格

中文简介正在准备中。当前显示原文说明。

larksuite/openclaw-lark23782026年7月22日 更新

飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。

中文简介正在准备中。当前显示原文说明。

larksuite/openclaw-lark23782026年7月22日 更新

Lark/Feishu channel output rules. Always active in Lark conversations.

中文简介正在准备中。当前显示原文说明。

larksuite/openclaw-lark23782026年7月22日 更新

创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档,支持指定创建位置(文件夹/知识库/知识空间)。

中文简介正在准备中。当前显示原文说明。

larksuite/openclaw-lark23782026年7月22日 更新

获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。

中文简介正在准备中。当前显示原文说明。

larksuite/openclaw-lark23782026年7月22日 更新

飞书 IM 消息读取工具使用指南,覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。 **当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题(thread)内的回复消息 (3) 需要跨会话搜索消息(按关键词、发送者、时间等条件) (4) 消息中包含图片、文件、音频、视频,需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息

中文简介正在准备中。当前显示原文说明。

larksuite/openclaw-lark23782026年7月22日 更新

查看 larksuite 的全部技能

报告此技能的问题