feishu-api-lookup

What This Skill Does

The feishu-api-lookup skill is an advanced diagnostic and retrieval tool designed for developers and automation engineers working within the Feishu (Lark) ecosystem. Since the official Feishu Open Platform documentation is built as a complex Single Page Application (SPA), standard scrapers often fail to retrieve meaningful data. This skill circumvents those limitations by utilizing a strategic combination of web_search and web_fetch to identify, navigate, and parse technical specifications in real-time. It enables the OpenClaw agent to act as a bridge between the user's requirements and the official API definitions, ensuring accuracy when integrating custom workflows or troubleshooting integration errors.

Installation

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

clawhub install openclaw/skills/skills/deadblue22/feishu-api-lookup

Ensure that your environment has sufficient permissions for web_search and web_fetch, as these are mandatory dependencies for the skill's functionality. The skill is sourced directly from the official openclaw/skills repository.

Use Cases

This skill is indispensable in the following scenarios:

• Rapid API Discovery: Quickly identifying the correct endpoint path for specific actions like forwarding threads, managing calendar events, or updating Bitable records.
• Parameter Verification: Ensuring your API request payloads are correctly structured, identifying required vs. optional fields, and understanding complex nested JSON structures.
• Error Resolution: When you encounter specific Feishu API error codes, the skill can look up the corresponding documentation to identify which permission scope or parameter value is causing the failure.
• Code Implementation: Generating robust Python or Node.js logic by extracting official request/response models directly from the source documentation.

Example Prompts

1. "Look up the Feishu API endpoint for creating a new document in a specific folder and tell me which permissions I need."
2. "I'm getting a 400 error when calling the im/v1/messages API. Search the docs for common causes and let me know how to structure the request body correctly."
3. "How do I forward a message thread using the Feishu Open API? Please provide the HTTP method, URL path, and required headers."

Tips & Limitations

• Language Sensitivity: Always prefer using Chinese terms (e.g., "多维表格" or "发送消息") in your search queries, as the documentation is primarily indexed in Chinese.
• SPA Challenges: If web_fetch returns empty results, default to searching the feishu.apifox.cn mirror, which is often easier for the agent to parse.
• Authentication: Remember that almost all operations require a tenant_access_token. Ensure your bot or app has the correct Scopes configured in the Feishu Developer Console for the API you are accessing.