feishu-troubleshoot

Diagnose Feishu plugin permission and connectivity failures with remediation steps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/alexaundre/mycc --skill feishu-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-troubleshoot
Source: https://github.com/alexaundre/mycc/tree/main/skills/feishu-troubleshoot
Command: npx skills add https://github.com/alexaundre/mycc --skill feishu-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps developers and administrators quickly identify and resolve permission, authorization, and connectivity issues that cause Feishu (Lark) plugin features—such as card button interactions and automated authorizations—to fail or behave unexpectedly.

Core Features & Use Cases

  • FAQ for common failures: Explains typical causes such as missing card callback permissions and provides step-by-step remediation.
  • Deep diagnostic command: A /feishu doctor check that inspects account credentials, API connectivity, bot identity, app-level permissions, and user authorization states.
  • Actionable report and fixes: Produces a summary status, detailed findings, missing-permission lists, user token health, and one-click links or instructions to request missing permissions.
  • Use Case: Use when multiple authorization attempts fail, automated token refresh is not working, or card interactions do not trigger any callbacks.

Quick Start

Type /feishu doctor in a Feishu chat to run a full permissions and connectivity diagnostic and receive a detailed report with recommended fixes.

Frequently Asked Questions about feishu-troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do Feishu card interactions fail to trigger callbacks?

Feishu card interactions fail when the chatbot lacks the required card callback permissions. Running a diagnostic check inspects app-level permission matrices and generates remediation steps to restore button interactivity.

What causes unauthorized access errors during Feishu API integration?

Unauthorized access errors occur when Feishu app credentials lack sufficient API permissions. A diagnostic check verifies account credentials, bot identity, and user authorization states to identify missing permission scopes.

How do I diagnose Feishu chatbot connectivity and permission failures?

Diagnose Feishu chatbot connectivity by running a full diagnostic check to inspect API reachability, app credentials, and user token health, generating a detailed report with one-click permission links.

Does automated Feishu token refresh require specific app permissions?

Automated Feishu token refresh requires correct app-level permissions and valid user authorization states. A diagnostic check evaluates token health and provides remediation steps when automated refresh fails.

How do I fix missing permissions when Feishu bot authorization attempts fail?

Fix failed Feishu bot authorizations by running a diagnostic check to identify missing permission lists and generate one-click links to request the required app and user permissions.