A specialized utility for Openclaw agents to upload and send local media files directly to Feishu users via internal API calls.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-files
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-files 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 Uploader?
The Feishu File Uploader is a technical workflow designed for Openclaw Skills to bypass the current limitations of standard messaging tools. While default tools may struggle with direct binary transfers of local media, this skill leverages the Feishu Open Platform API to ensure high-fidelity delivery of images and videos.
By utilizing native system commands like curl and python3, this skill provides a reliable bridge between an agent's local environment and the Feishu workspace. It is particularly useful for automated reporting, sharing generated assets, or sending security captures directly into team chats.
Feishu File Uploader Use Cases
- Sending AI-generated images or charts from a local workspace to a Feishu chat.
- Automating video status reports for long-running devops processes.
- Overcoming standard message tool limitations when handling local binary files.
- Integrating Feishu notifications into multi-step agentic workflows.
How Feishu File Uploader Works
- The agent extracts the App Secret and App ID from the local Openclaw configuration file.
- A POST request is made to the Feishu internal auth endpoint to generate a temporary tenant_access_token.
- The local file is uploaded to Feishu's media servers to generate a unique image_key or file identifier.
- The agent sends a message to the specified recipient (using open_id) referencing the generated media key.
Feishu File Uploader Setup
Ensure your Feishu App credentials are configured in your Openclaw environment. You can use the following logic within an exec tool:
# Extract credentials and fetch token
APP_SECRET=$(python3 -c "import json; c=json.load(open('/root/.openclaw/openclaw.json')); print(c['channels']['feishu']['appSecret'])")
APP_ID=$(python3 -c "import json; c=json.load(open('/root/.openclaw/openclaw.json')); print(c['channels']['feishu']['appId'])")
TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
-H 'Content-Type: application/json' \
-d '{"app_id":"'$APP_ID'","app_secret":"'$APP_SECRET'"}' \
| python3 -c "import json,sys; print(json.load(sys.stdin)['tenant_access_token'])")
Feishu File Uploader Data Schema & Taxonomy
The skill interacts with the following data points to facilitate the transfer:
| Attribute | Description | Source |
|---|---|---|
| appId | Unique Feishu Application ID | openclaw.json |
| appSecret | Secret key for API authentication | openclaw.json |
| image_key | The unique ID returned after a successful upload | Feishu API |
| receive_id | The Open ID of the target recipient | User Input |
Feishu File Uploader Advanced Features
- Support for multi-step media processing before upload.
- Dynamic token retrieval to ensure secure, short-lived sessions.
- Integration with local Python scripts for advanced JSON parsing of API responses.
- Extensible to support video and other file types beyond standard images.
SKILL.md
Loading
Related Openclaw Skills
Number 4 Cultural Guide
A bilingual expert guide exploring the deep-seated cultural taboos and positive symbolic meanings of the number 4 across East Asian traditions.
NeetoKB Integration
A powerful integration for managing NeetoKB articles, categories, and workspaces directly through an AI-driven terminal interface.
message-send
A specialized skill for AI agents to dispatch messages, media, and interactive components across multiple chat platforms using a unified CLI interface.
Melo
Melo provides a robust interface for AI agents to manage audio transcription and project-related tasks through Membrane integration.
Singapore Pools TOTO Results
An automated data extraction tool for fetching and parsing the latest Singapore Pools TOTO results into text or JSON formats.
Sages Stash
A safety-focused redirection skill that replaces sensitive content requests with high-quality, non-R18 random artwork.
Featured*
