Skip to content
cccskills
FreePublished on GitHub

feishu-troubleshoot

Troubleshoot Feishu plugin problems using a FAQ and a diagnostic command. Check account settings, API connectivity, application permissions, and user authorization to identify persistent access issues and find steps to resolve them.

OriginalShow the original description

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

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

Run score Not tested

See how to install

Good for

  • Investigating unresponsive message card buttons
  • Diagnosing errors that persist after repeated authorization
  • Checking application permissions against user authorization
  • Checking API connectivity and account settings

Files included (1)

  • SKILL.md2.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

飞书插件问题排查

❓ 常见问题(FAQ)

卡片按钮点击无反应

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

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

解决步骤:

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

🔍 诊断命令(深度工具)

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

何时使用诊断:

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

使用方法:

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

/feishu doctor

诊断命令会检查:

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

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

    • 插件版本
  • 账号信息:

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

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

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

clawhub

FreeSummary

Use the ClawHub command-line tool to find and install agent skills, update them to the latest or a specified version, list installed skills, and publish skill folders with version numbers and change notes.

  • Find and install a skill for a task
  • Install or update a skill to a specific version
  • Update all installed skills
nexu-io/nexu3.3KUpdated Apr 26, 2026

coding-agent

FreeSummary

Delegate feature development, code refactoring, and pull request reviews to Codex, Claude Code, Pi, or OpenCode. It guides background execution, progress monitoring, and parallel work in separate working directories.

  • Delegating new feature or app development
  • Reviewing pull requests in a separate working directory
  • Refactoring a large codebase
nexu-io/nexu3.3KUpdated Apr 26, 2026

datadog

FreeSummary

Investigate Nexu production issues through the Datadog Logs API. Search crash events, error output, startup activity, and API failures, then summarize findings by time, running instance, and deployed version to help trace related events.

  • Investigate OpenClaw crashes
  • Compare crash timing with deployments
  • Trace Slack authentication errors
nexu-io/nexu3.3KUpdated Apr 26, 2026

deep-research

FreeSummary

Turn a broad research topic into a structured report with traceable sources. The workflow defines questions, prioritizes authoritative material, separates facts from assumptions, compares evidence, and uses an independent agent to check key data and reasoning.

  • Comparing products or technical concepts
  • Weighing costs and risks before a decision
  • Investigating trends and their underlying drivers
nexu-io/nexu3.3KUpdated Apr 26, 2026

feedback

FreeSummary

Send bug reports, suggestions, or other feedback to the Nexu team using `/feedback`. The submission script automatically includes conversation history and images, then reports whether the feedback was successfully forwarded.

  • Reporting a Nexu platform issue
  • Suggesting improvements to Nexu
  • Sharing feedback with conversation history and images
nexu-io/nexu3.3KUpdated Apr 26, 2026

feishu-bitable

FreeSummary

Create and manage Feishu Bitable tables for work such as customer tracking. Add, search, update, or delete records, configure columns using 27 field types, filter and sort data, and manage views or batch imports.

  • Create a customer management table
  • Find records marked as in progress
  • Import customer data in batches
nexu-io/nexu3.3KUpdated Apr 26, 2026

See all skills by nexu-io

Report a problem with this skill