larksuite/openclaw-lark/feishu-troubleshoot

Claude Code and agent skill by larksuite/openclaw-lark

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令（/feishu_doctor）。 常见问题可随时查阅。诊断命令用于排查复杂问题（多次授权仍失败、自动授权无法解决等）， 会检查账户配置、API 连通性、应用权限、用户授权状态，并生成详细的诊断报告和解决方案。

Install

npx vskill@latest install larksuite/openclaw-lark/feishu-troubleshoot

SKILL.md

飞书插件问题排查

❓ 常见问题（FAQ）

卡片按钮点击无反应

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

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

解决步骤：

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

🔍 诊断命令（深度工具）

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

何时使用诊断：

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

使用方法：

在飞书聊天会话中直接输入（作为用户消息发送）：

/feishu doctor

诊断命令会检查：

  • 📋 诊断摘要（首先展示）：
  • 总体状态（✅ 正常 / ⚠️ 警告 / ❌ 失败）
  • 发现的问题列表和简要描述
  • 环境信息：
  • 插件版本
  • 账号信息：
  • 凭证完整性（appId, appSecret 掩码）
  • 账户启用状态
  • API 连通性测试
  • Bot 信息（名称和 openId）
  • 应用身份权限：
  • 应用已开通的必需权限数量
  • 缺失的必需权限列表
  • 一键申请链接（自动带上缺失权限参数）
  • 用户身份权限：
  • 用户授权状态统计（✓ 有效 / ⟳ 需刷新 / ✗ 已过期）
  • Token 自动刷新状态（是否包含 offline_access）
  • 权限对照表（应用已开通 vs 用户已授权，逐项对比）
  • 应用权限缺失时的申请指引和链接
  • 用户授权不足时的重新授权操作方法

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
1,155
Repository forks
97
Repository npm downloads, 7 days
40,009
7-day trend score
58

Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 22 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/larksuite/openclaw-lark/feishu-troubleshoot/badge)](https://verified-skill.com/skills/larksuite/openclaw-lark/feishu-troubleshoot)

Something wrong with this skill or its page? Tell us.