Feishu Common

What This Skill Does

The Feishu Common skill serves as the foundational infrastructure for any automation task interacting with the Feishu (Lark) ecosystem. Rather than requiring developers to repeatedly implement complex authentication flows, token lifecycle management, and network resilience logic within individual skills, Feishu Common provides a centralized, robust utility layer. It handles the critical task of tenant token acquisition and secure caching, ensuring that your agent stays authenticated without hitting API rate limits or wasting resources on redundant authentication calls. Furthermore, it incorporates advanced networking capabilities, including automated retry mechanisms and timeout handling, to ensure that transient network issues do not cause long-running agent workflows to fail prematurely. By wrapping authenticated requests, this skill ensures that all outbound traffic to Feishu APIs is properly signed and structured.

Installation

To integrate this utility, ensure you have the OpenClaw CLI configured and run the following command in your terminal:

clawhub install openclaw/skills/skills/autogame-17/feishu-common

This package must be installed as a dependency for any other Feishu-related agents or skills. It is designed to be imported as a library by other skills, meaning it does not typically require standalone configuration beyond the initial installation.

Use Cases

This skill is indispensable for scenarios requiring tight integration with corporate collaboration tools. Use cases include: automating calendar scheduling for team meetings, pulling task lists from project management dashboards, managing file permissions in cloud storage, and synchronizing user status updates across multiple platforms. It is the backbone for any agent tasked with reading or writing data via Feishu Open Platform APIs.

Example Prompts

1. "Initialize the Feishu client and fetch the authentication token for our tenant so I can begin drafting the weekly meeting summary."
2. "Use the feishu-common helper to retry the failed request to the document API with a longer timeout period."
3. "Configure the environment for the Feishu-calendar skill, ensuring it correctly references the base token from feishu-common."

Tips & Limitations

To maximize the reliability of your automation, always utilize the provided fetchWithRetry method instead of standard fetch requests to account for fluctuating network conditions. Note that this skill is a library, not a standalone end-user interface; it requires other dependent skills to execute business logic. Ensure that your tenant credentials are stored securely in your OpenClaw environment configuration, as this skill relies on those environment variables to generate valid authentication tokens. Avoid modifying the internal caching logic directly to ensure that token refresh cycles remain stable and secure.