feishu-troubleshoot

What This Skill Does

The feishu-troubleshoot skill acts as an intelligent diagnostic companion for OpenClaw users integrating with Feishu (Lark). It provides a dual-layer support mechanism: a comprehensive FAQ knowledge base for immediate self-service troubleshooting and a powerful, automated diagnostic command (/feishu_doctor) for identifying complex permission and authentication failures. The tool systematically evaluates your application's API connectivity, secret integrity, and the synchronization between application-level permissions and user-level authorization tokens, providing actionable remediation steps.

Installation

To install this skill, use the following command in your OpenClaw environment:

clawhub install openclaw/skills/skills/chenfa188/openclaw-feishu-troubleshoot

Ensure your OpenClaw agent has the necessary connectivity to reach the Feishu Open Platform APIs.

Use Cases

1. Integration Debugging: Quickly identify why an application fails to perform message card interactions by checking the 'card.action.trigger' callback configuration.
2. Permission Synchronization: Resolve issues where the application has the correct permissions, but the individual user session lacks the required access scope, preventing specific agent actions.
3. Auth Persistence Issues: Diagnose silent failures occurring when user tokens expire or fail to refresh, specifically looking for the 'offline_access' scope requirement.
4. Credential Verification: Validate that your App ID and App Secret are correctly configured and that the application is successfully communicating with Feishu's servers.

Example Prompts

• "I keep getting a permission error when trying to send messages. Can you run /feishu doctor to see what's wrong?"
• "My message card buttons aren't doing anything when clicked, how do I fix the callback issue?"
• "The agent asks me to re-authorize every day. Use the troubleshooting tool to check if my refresh tokens are valid."

Tips & Limitations

• Proactive Usage: Don't wait for total failure; use the /feishu_doctor command after initial setup to ensure all permissions are correctly provisioned.
• Security: The diagnostic output masks sensitive information like your App Secret to ensure log safety. However, always review the generated report before sharing it with third parties.
• Scope: This tool is strictly for configuration and authorization issues. It does not handle network-level issues outside of the Feishu API endpoint path or internal agent logic errors unrelated to the Feishu integration.