A comprehensive tool for interacting with Feishu documents using user-level authentication for reading, writing, and block management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-user
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-user 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 Document Operations (User Access)?
The feishu-user skill provides a robust interface for developers to manage Feishu documents via the Feishu Open API. By utilizing User Access Tokens, it enables secure, identity-based operations on personal and shared documents within the Feishu ecosystem. This integration within the Openclaw Skills library allows AI agents and automated scripts to handle complex document structures, making it an essential tool for teams relying on Feishu for collaboration.
Whether you need to extract information from existing docs or programmatically generate new reports, this skill simplifies the REST API interactions into a clean Pythonic interface. It supports the modern Feishu Docx format, ensuring compatibility with the latest features of the platform.
Feishu Document Operations (User Access) Use Cases
- Automating the creation of weekly project reports directly in Feishu documents.
- Syncing external data sources or meeting transcripts into centralized Feishu docs.
- Building AI-driven research assistants that can browse and summarize Feishu cloud drive content.
- Programmatically updating specific blocks in a document based on real-time system alerts.
How Feishu Document Operations (User Access) Works
- The user registers an application on the Feishu Open Platform to obtain an App ID and App Secret.
- An authorization URL is generated to request specific permissions like document reading and cloud drive searching.
- Upon user authorization, a temporary code is exchanged for a persistent User Access Token.
- The FeishuClient is initialized with the token to authorize REST API calls.
- The skill executes operations by targeting specific document tokens or block IDs through the Feishu Docx API.
Feishu Document Operations (User Access) Setup
To get started with this addition to Openclaw Skills, install the necessary Python dependencies:
pip install requests
Next, exchange your authorization code for a token using the following command:
curl -X POST "https://open.feishu.cn/open-apis/authen/v1/access_token" \
-H "Content-Type: application/json" \
-d '{
"grant_type": "authorization_code",
"code": "{YOUR_CODE}",
"app_id": "{YOUR_APP_ID}",
"app_secret": "{YOUR_APP_SECRET}"
}'
Feishu Document Operations (User Access) Data Schema & Taxonomy
The skill manages document data through specific metadata and token structures:
| Attribute | Type | Description |
|---|---|---|
| doc_token | String | The unique identifier for the Feishu document. |
| block_id | String | The identifier for a specific content block within a document. |
| user_access_token | String | The bearer token used for authenticating API requests. |
| config.json | File | Local storage at ~/.config/claw-feishu-user/ for cached tokens. |
Feishu Document Operations (User Access) Advanced Features
- Includes a dedicated
feishu_token.pyscript for automated token refreshing and lifecycle management. - Provides granular control over document structure with block-level CRUD operations (Create, Read, Update, Delete).
- Offers high-level convenience functions for quick document updates without manual client instantiation.
- Supports identity-based access, allowing the agent to act on behalf of a specific user with full permission transparency.
SKILL.md
Loading
Related Openclaw Skills
AllStock Data Query
A versatile stock market data retrieval tool supporting China A-shares, Hong Kong, and US markets via lightweight APIs and advanced SDKs.
Subagent Orchestrator
A sophisticated workflow controller for managing continuous, multi-step AI subagent task lines without manual user re-prompting.
Bailian TTS
A high-performance text-to-speech skill leveraging Aliyun Bailian for natural AI voice generation via command-line tools.
Model Usage (Linux)
A Linux-native tool to analyze AI model token consumption and financial costs from session logs.
Safe Backup
A cross-platform utility for securely backing up OpenClaw state directories and workspaces while automatically excluding sensitive credentials.
Social Reader
A comprehensive social media scraping and automation skill supporting real-time interaction and scheduled batch monitoring.
Featured*
