---
name: Feishu Troubleshooting
slug: feishu-troubleshooting
category: DevOps
description: Feishu Troubleshooting provides a FAQ and /feishu_doctor diagnostic command to inspect Feishu plugin configuration, API connectivity, app permissions, and user authorization, generating reports and fixes. Use for repeated authorization failures or unclear permission issues.
github: "https://github.com/op7418/CodePilot/tree/main/%E8%B5%84%E6%96%99/feishu-openclaw-plugin/package/skills/feishu-troubleshoot"
language: TypeScript
stars: 6394
forks: 690
install: "npx degit 'https://github.com/op7418/CodePilot/tree/main/%E8%B5%84%E6%96%99/feishu-openclaw-plugin/package/skills/feishu-troubleshoot' ~/.claude/skills/feishu-troubleshoot"
installs_to: ~/.claude/skills/feishu-troubleshoot
source_path: 资料/feishu-openclaw-plugin/package/skills/feishu-troubleshoot/SKILL.md
collection_size: 9
category_size: 798
collection_url: "https://dirskills.com/collections/op7418/CodePilot"
added: 2026-08-15T06:52:07.433Z
last_synced: 2026-08-15T06:52:07.433Z
canonical_url: "https://dirskills.com/skills/feishu-troubleshooting"
---

# Feishu Troubleshooting

Feishu Troubleshooting provides a FAQ and /feishu_doctor diagnostic command to inspect Feishu plugin configuration, API connectivity, app permissions, and user authorization, generating reports and fixes. Use for repeated authorization failures or unclear permission issues.

**Install:**

```bash
npx degit 'https://github.com/op7418/CodePilot/tree/main/%E8%B5%84%E6%96%99/feishu-openclaw-plugin/package/skills/feishu-troubleshoot' ~/.claude/skills/feishu-troubleshoot
```

## README

# 飞书插件问题排查

## ❓ 常见问题（FAQ）

### 卡片按钮点击无反应

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

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

**解决步骤**：

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

---

## 🔍 诊断命令（深度工具）

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

**何时使用诊断**：
- 多次授权后仍然报错
- 自动授权流程无法解决的问题
- 需要查看完整的权限配置状态

**使用方法**：

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

/feishu doctor

诊断命令会检查：

- **📋 诊断摘要**（首先展示）：
  - 总体状态（✅ 正常 / ⚠️ 警告 / ❌ 失败）
  - 发现的问题列表和简要描述

- **环境信息**：
  - 插件版本

- **账号信息**：
  - 凭证完整性（appId, appSecret 掩码）
  - 账户启用状态
  - API 连通性测试
  - Bot 信息（名称和 openId）

- **应用身份权限**：
  - 应用已开通的必需权限数量
  - 缺失的必需权限列表
  - 一键申请链接（自动带上缺失权限参数）

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