An AI-ready skill to programmatically read and extract structured content from Feishu (Lark) documents, spreadsheets, and slides using the official Open API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-doc-reader
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-doc-reader 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 Reader?
The Feishu Document Reader is a specialized tool designed to bridge the gap between Feishu (Lark) content and developer-driven automation. As a key component of the Openclaw Skills ecosystem, it leverages the official Feishu Open API to transform complex document structures into clean, actionable JSON data. This skill is particularly valuable for developers building AI-powered workflows that need to ingest organizational knowledge directly from collaborative cloud documents.
By handling the intricacies of tenant authentication and API rate limiting, the skill allows you to focus on the data rather than the protocol. It supports a wide range of content types, from standard docx files to legacy docs and spreadsheets, ensuring that your Openclaw Skills implementation remains versatile and robust across different enterprise use cases.
Feishu Document Reader Use Cases
- Synchronizing team knowledge by feeding Feishu document content into RAG-based AI agents using Openclaw Skills.
- Automating the extraction of financial or project data from Feishu Sheets for external reporting dashboards.
- Migrating documentation from Feishu to markdown or other internal knowledge bases programmatically.
- Performing bulk audits of document metadata and access permissions within a Feishu tenant.
How Feishu Document Reader Works
- The user configures app credentials (App ID and Secret) within the reference directory to establish a secure connection.
- When triggered, the skill requests a tenant access token from the Feishu Open Platform, which is cached for optimal performance.
- The skill identifies the document type (docx, sheet, or doc) based on the provided token and selects the appropriate API endpoint.
- It recursively fetches document blocks, including headings, tables, and images, while maintaining the original parent-child hierarchy.
- The raw API response is parsed and formatted into a structured JSON object, making it immediately usable by other Openclaw Skills or local analysis tools.
Feishu Document Reader Setup
To start using this skill within your Openclaw Skills environment, follow these steps:
- Create a configuration file at
./reference/feishu_config.jsonwith your credentials:
{
"app_id": "your_feishu_app_id_here",
"app_secret": "your_feishu_app_secret_here"
}
Grant the necessary permissions in your Feishu App console:
docx:document:readonly,doc:document:readonly, andsheets:spreadsheet:readonly.Set executable permissions for the included shell scripts:
chmod +x scripts/read_doc.sh
chmod +x scripts/get_blocks.sh
Feishu Document Reader Data Schema & Taxonomy
The skill produces a structured data output that maps the complex Feishu block ecosystem into a readable format:
| Component | Description |
|---|---|
| Metadata | Includes document title, owner, create_time, and versioning info. |
| Content Blocks | An array of objects representing headings, text, code, and lists. |
| Tables | Fully parsed row and column data extracted from spreadsheet blocks. |
| Hierarchy | Mapping of parent_id and children_ids to maintain document flow. |
| Attachments | Metadata and tokens for images and external links. |
Feishu Document Reader Advanced Features
- Full block-level extraction allowing for granular access to specific document sections without fetching the entire file.
- Intelligent text resolution that automatically flattens rich-text formatting into plain-text strings for easier AI processing.
- Support for legacy Feishu doc formats alongside modern docx and sheet structures.
- Advanced error handling with specific Feishu error code diagnostics to simplify troubleshooting in Openclaw Skills deployments.
- Secure credential management supporting both environment variables and encrypted file storage.
SKILL.md
Loading
Related Openclaw Skills
Tencent Meeting Export
A specialized tool to automate the extraction of transcripts, AI summaries, and meeting events from public Tencent Meeting recording links.
Tailscale Serve Manager
A specialized skill for managing and orchestrating multiple service paths using the tailscale serve command without configuration conflicts.
Checkers Sixty60 Shopping
A sophisticated browser automation skill for managing grocery orders, deal hunting, and cart optimization on the Checkers Sixty60 platform.
PodSips Podcast Search
A powerful tool for searching podcast transcripts and retrieving episode metadata via semantic search.
Hong Kong Stock Trending
An automated market intelligence tool providing daily briefings and trend analysis for the Hong Kong stock exchange.
Twitter AI Trending Search
A specialized tool for extracting and summarizing high-engagement AI-related discussions from Twitter/X.
METADATA
Featured*
