A specialized utility tool for locating and downloading specific files from Feishu chat history based on filenames.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-doc-finder
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-finder 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 File Finder?
The Feishu File Finder is a technical utility designed to streamline file retrieval from Feishu communication channels. It addresses common pain points in team collaboration where important documents or assets might be buried in deep chat histories or missed by automated download triggers. By leveraging the Feishu API, this skill provides a programmatic way to target specific files and bring them into your local environment.
As a part of the Openclaw Skills library, this tool is optimized for developers and automation workflows. It ensures that finding a specific zip file, document, or image from a chat thread is a matter of a simple command rather than manual scrolling. It is particularly effective for teams using AI agents that need to ingest specific documents from a shared workspace without manual intervention.
Feishu File Finder Use Cases
- Recovering specific project assets from historical Feishu chat threads.
- Automating the retrieval of documentation mentioned in team conversations.
- Supplementing data ingestion pipelines when automated sync tools miss individual files.
- Developing custom backup scripts for important shared resources within Openclaw Skills workflows.
How Feishu File Finder Works
- The tool accepts a specific Chat ID and the target filename as input parameters.
- It authenticates with the Feishu platform using the FEISHU_APP_ID and FEISHU_APP_SECRET credentials.
- The skill queries the chat history, scanning message metadata for matching filenames within a specified lookback period.
- Upon finding a match, it triggers the Feishu download API to fetch the file binary.
- The file is saved locally to the designated output directory for immediate use.
Feishu File Finder Setup
To get started with this skill, navigate to the directory and install dependencies:
cd skills/feishu-file-finder
npm install
You must also set your Feishu API credentials in your environment:
export FEISHU_APP_ID=your_app_id_here
export FEISHU_APP_SECRET=your_app_secret_here
Run the skill using node:
node index.js --chat <chat_id> --file <filename>
Feishu File Finder Data Schema & Taxonomy
The skill manages data through CLI arguments and environment variables to ensure secure and precise file retrieval. The following table describes the data configuration:
| Parameter | Description | Default |
|---|---|---|
--chat |
The unique ID of the Feishu chat to search. | Required |
--file |
The exact name of the file to find and download. | Required |
--output |
The local directory where the file will be saved. | Current Directory |
--hours |
The number of hours to look back in the chat history. | 24h |
Feishu File Finder Advanced Features
- Configurable history lookback to search for files uploaded days or weeks ago.
- Flexible output pathing to integrate with existing file organization systems.
- Command-line interface designed for easy inclusion in larger Openclaw Skills automation scripts.
- Environment-based configuration for secure deployment in CI/CD or agent-led environments.
SKILL.md
Loading
Related Openclaw Skills
EvoMap Quality Generator
A specialized tool for transforming real workspace skills into high-quality, code-backed EvoMap bundles for AI agent evolution.
EvoMap Mass Publisher
An automated pipeline to generate, optimize, and publish massive quantities of EvoMap bundles with high quality and rate-limiting.
EvoMap Bundle Optimizer
A specialized utility to validate, auto-fix, and optimize EvoMap Gene and Capsule bundles for better AI agent discoverability.
Scientific Writer
An AI-powered scientific writing engine that transforms raw research data and queries into publication-ready manuscripts, grant proposals, and conference posters.
Feishu Doc Long Content Handler
A strategic workflow to bypass Feishu's 1KB API limit for long document creation and management.
Feishu File Sender
A specialized skill for Openclaw agents to programmatically send binary files and compressed packages to Feishu channels.
Featured*
