feishu-common

Manage Feishu tenant tokens and authenticated API calls for OpenClaw skills.

20|1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/autogame-17/feishu-skills --skill feishu-common
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-common
Source: https://github.com/autogame-17/feishu-skills/tree/main/feishu-common
Command: npx skills add https://github.com/autogame-17/feishu-skills --skill feishu-common

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shared Feishu authentication and API helper for OpenClaw Feishu skills.

This module centralizes tenant token management, automatic token refresh, retry logic, and a lightweight fetch wrapper for Feishu endpoints.

Core Features & Use Cases

  • Centralized token management and caching
  • Automatic token refresh on expiry
  • Robust HTTP client with exponential backoff and 429 handling
  • Simple API wrappers for common Feishu endpoints

Quick Start

Import and use the helpers from feishu-common to obtain tokens and perform authenticated requests.

Frequently Asked Questions about feishu-common

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

FAQPage Schema
How do I manage Feishu tenant tokens automatically in OpenClaw?

You can manage Feishu tenant tokens automatically by importing the fetch wrapper, which handles token caching and expiry refresh internally. It requires setting the FEISHU_APP_ID and FEISHU_APP_SECRET environment variables to authenticate requests.

How to handle Feishu API rate limits and retry failed requests?

Handle Feishu API rate limits using the built-in retry logic with exponential backoff. The fetch wrapper automatically detects 429 responses and retries the failed authenticated requests to ensure resilient API interactions.

Do I need to manually refresh expired Feishu tenant tokens?

No, you do not need to manually refresh expired Feishu tenant tokens. The module automatically caches tokens and handles refresh logic upon expiry, providing resilient authenticated API calls without manual intervention.

What environment variables are required for Feishu API authentication?

Feishu API authentication requires the FEISHU_APP_ID and FEISHU_APP_SECRET environment variables. These credentials allow the centralized token management system to generate, cache, and refresh tenant tokens for authenticated requests.

Why does my Feishu API wrapper keep failing on 429 errors?

Your Feishu API wrapper likely fails on 429 errors because it lacks built-in rate limit handling. This module resolves 429 errors by implementing robust retry logic with exponential backoff to manage rate limits and ensure request completion.

What is the best way to centralize Feishu authentication for multiple API calls?

The best way to centralize Feishu authentication is using a unified helper that manages tenant token caching, automatic refresh, and a lightweight fetch wrapper. This ensures consistent authentication and resilient retries across all Feishu API endpoints.