feishu-troubleshoot

Diagnose Feishu/Lark plugin authorization and permission failures.

1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/picpic2013/feishu-openclaw-plugin --skill feishu-troubleshoot-picpic2013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-troubleshoot
Source: https://github.com/picpic2013/feishu-openclaw-plugin/tree/main/skills/feishu-troubleshoot
Command: npx skills add https://github.com/picpic2013/feishu-openclaw-plugin --skill feishu-troubleshoot-picpic2013

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users troubleshoot Feishu/Lark plugin problems when normal authorization or setup steps do not resolve access errors, broken buttons, or permission mismatches.

Core Features & Use Cases

  • FAQ Guidance: Explains the most common failure modes, including card button callbacks that do not respond.
  • Deep Diagnostics: Provides a /feishu doctor workflow to inspect credentials, account status, API connectivity, bot identity, app permissions, and user authorization state.
  • Permission Resolution: Identifies missing application permissions, expired user grants, and refresh issues, then points to the next corrective action.
  • Use Cases: Useful when repeated authorization still fails, automatic authorization cannot recover, or you need a clear report of what is misconfigured.

Quick Start

Ask the skill to diagnose your Feishu plugin problem and explain the likely cause, the relevant permission checks, and the exact next fix in plain language.

Frequently Asked Questions about feishu-troubleshoot

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

FAQPage Schema
How do I fix Feishu plugin authorization failures when repeated attempts do not resolve access errors?

Feishu plugin authorization failures can be fixed by inspecting credentials, verifying bot identity, auditing app permissions, and validating user tokens to identify misconfigurations. This diagnostic process checks API connectivity and account status to provide actionable remediation guidance for persistent access errors.

Why do Feishu card buttons stop responding or fail to trigger callbacks?

Feishu card buttons stop responding due to permission mismatches, expired user grants, or failed automatic authorization. Checking bot identity, validating user tokens, and verifying API connectivity will identify the broken callback mechanism and point to the exact configuration requiring correction.

How do I run a Feishu diagnostic check for API connectivity and app permissions?

Running a Feishu diagnostic check involves inspecting credentials, verifying account status, testing API connectivity, and auditing application permissions to detect missing grants. This workflow validates bot and app configurations, returning a clear report of what is misconfigured and the next corrective action.

What should I do when automatic Feishu authorization fails to recover access?

When automatic Feishu authorization fails, you need to perform deep diagnostics to compare app permissions, validate user tokens, and check for expired grants. Inspecting bot and app configurations manually will reveal the specific permission or connectivity issue blocking recovery.

How do I identify missing application permissions causing Lark plugin setup errors?

Missing application permissions causing Lark plugin setup errors are identified through a permission audit that compares required grants against current configurations. Inspecting credentials and validating user authorization state will highlight the specific missing scopes and provide actionable remediation steps.

Does this Feishu troubleshooting workflow require specific dependencies or components to run?

This Feishu troubleshooting workflow requires no external dependencies or components to run diagnostics. It operates as a standalone diagnostic tool that inspects credentials, verifies account configurations, and audits API connectivity directly to resolve plugin authorization and permission failures.