Feishu Upload Skill

What This Skill Does

The Feishu Upload Skill, developed by deewooo, is a powerful utility designed for the OpenClaw ecosystem to streamline document workflows with Feishu (Lark). This skill provides a robust, Node.js-based interface for uploading local files directly to the Feishu cloud and distributing them via messages to specific chats or channels. It automates the complex authentication flow required by the Feishu API, including token generation, automatic refresh mechanisms, and payload management, enabling users to move files from their local machine to enterprise collaboration spaces with a single command.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure your system meets the requirements (Node.js 18+ for native fetch and FormData support). Execute the following command in your terminal: clawhub install openclaw/skills/skills/deewooo/feishu-upload-skill

Once installed, ensure your application credentials (App ID and App Secret) are configured within the skill's environment settings. The skill handles local caching of access tokens in feishu_token.txt to optimize performance and prevent unnecessary API calls.

Use Cases

This tool is ideal for developers and automated agents that need to:

• Automate report distribution: Automatically push generated PDF or Excel reports to team project channels.
• Share logs or debugging data: Send diagnostic text files or error dumps to developers in real-time.
• Content sync: Transfer images or media assets from local storage to a group workspace for team collaboration.
• Backup workflows: Quickly archive small project files or configuration backups to Feishu storage.

Example Prompts

1. "OpenClaw, please upload my project-summary.pdf and send it to the 'Engineering Team' group chat."
2. "Upload the latest performance report, metrics_v2.json, to the dev-support channel on Feishu."
3. "Take the archived folder archive.tar.gz and send it to my manager's chat ID [chat_id]."

Tips & Limitations

• Size Limit: Files are strictly capped at 30MB per upload due to Feishu API constraints.
• Authentication: Keep your App ID and Secret secure; do not commit them to public version control.
• Network: The machine running the skill must have internet access to reach the Feishu open-api endpoints.
• Permissions: Ensure your Feishu App has the im:message:send_as_bot and im:file:send_as_bot permissions enabled in the Feishu Developer Console.
• Debugging: If a task fails, run the script with DEBUG=1 to view detailed API request/response logs.