A robust authentication and API utility layer designed to power Feishu-based automation workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-common
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install feishu-common using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Feishu Common?
Feishu Common is a foundational utility skill that provides a centralized authentication and API handling layer for the Feishu (Lark) ecosystem. It simplifies the development of complex Openclaw Skills by managing the lifecycle of tenant access tokens, implementing intelligent retry logic, and handling request timeouts. By abstracting the complexities of the Feishu API, it ensures that dependent skills can focus on their core logic while maintaining secure and reliable communication with Feishu servers.
This skill serves as the backbone for any Feishu-integrated agent, offering a standardized way to interact with the platform. It reduces boilerplate code and ensures that all your team communication automations follow best practices for security and performance.
Feishu Common Use Cases
- Centralizing Feishu tenant token management across multiple Openclaw Skills.
- Implementing automatic token refresh and caching to minimize API overhead and latency.
- Standardizing error handling and request retries for mission-critical Feishu integrations.
- Accelerating the development of new Feishu-integrated agent capabilities by leveraging pre-built auth wrappers.
How Feishu Common Works
- The skill acts as a required dependency for other Feishu-related Openclaw Skills.
- It requests and securely caches tenant access tokens from the Feishu identity provider.
- When a dependent skill initiates a request, Feishu Common wraps the call in an authenticated layer using fetchWithAuth.
- It automatically monitors token expiration and triggers a refresh before the token becomes invalid.
- It provides a robust fetch wrapper that handles network timeouts and implements exponential backoff or retries for transient failures.
Feishu Common Setup
Install this skill before installing or running any dependent Openclaw Skills. Ensure the skill files are placed in the appropriate directory structure.
# Navigate to your skills directory
cd path/to/openclaw/skills
# Create the feishu-common directory if it doesn't exist
mkdir -p feishu-common
To use this helper in your own custom Openclaw Skills, import the required utilities as follows:
const { getToken, fetchWithRetry, fetchWithAuth } = require("../feishu-common/index.js");
Feishu Common Data Schema & Taxonomy
The skill manages internal authentication states and exports functional helpers for data interaction. It does not store persistent user data but manages temporary memory-based tokens.
| Function | Description |
|---|---|
| getToken | Retrieves the current valid tenant token from cache or the Feishu API. |
| fetchWithRetry | Executes a network request with configurable retry and timeout logic. |
| fetchWithAuth | Executes an authenticated Feishu API request, managing token headers automatically. |
Feishu Common Advanced Features
- Intelligent token caching mechanism to prevent hitting Feishu API rate limits.
- Compatibility aliasing via feishu-client.js to support various integration patterns.
- Modular request wrappers that can be easily extended for custom Feishu API endpoints.
- High-performance retry logic specifically tuned for team-communication environments within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Chat Forwarder
A specialized utility designed to capture recent chat history and deliver it as a unified merge-forward message to specific recipients.
Feishu Calendar
Automate Feishu (Lark) calendar management, event synchronization, and collaborative task marking through a developer-friendly interface.
Feishu Broadcast Skill
A powerful automation tool for broadcasting rich text, markdown posts, and media to every user within a Feishu tenant.
Feishu Bitable Skill
A powerful tool for programmatically managing and adding records to Feishu Bitable (Base) environments.
Feishu Group Manager
A specialized toolset for programmatically managing Feishu group chat settings and visual processing indicators.
Feishu Memory Recall
A specialized skill providing cross-group message search, activity summarization, and event logging for Feishu-integrated OpenClaw agents.
METADATA
Featured*
