feishu-files

What This Skill Does

The Feishu Files skill, developed by bingothreed, acts as a specialized bridge for OpenClaw users to interface with the Feishu (Lark) messaging platform. While standard messaging tools often struggle with binary file transfers, this skill provides a robust, multi-step workaround to securely upload and transmit media files like images and videos directly to specific Feishu users via the open-apis endpoint. It bypasses conventional message restrictions by programmatically handling authentication tokens and file stream uploads.

Installation

To install this skill, run the following command in your OpenClaw environment: clawhub install openclaw/skills/skills/bingothreed/feishu-files Ensure your Feishu app credentials (app_id and app_secret) are correctly configured in your /root/.openclaw/openclaw.json file, as the script relies on these for generating the required tenant access tokens.

Use Cases

This skill is ideal for developers and automated agents that need to share diagnostic screenshots, recorded video logs, or visual reporting data from a server to a human supervisor on Feishu. It is particularly useful for automated monitoring systems that need to report visual anomalies in real-time. By leveraging curl commands via the exec tool, you maintain granular control over the data lifecycle, ensuring that files are correctly handled by Feishu's media processing infrastructure.

Example Prompts

1. "Use the Feishu Files skill to send the image located at /tmp/error_log.png to the user with open_id ou_123456789."
2. "I need to report this video record to my supervisor. Upload /data/videos/capture.mp4 to Feishu for user ID ou_987654321 using the file-sharing skill."
3. "Automate the process of sending my daily status image report found at /root/reports/daily.png to my Feishu account identified by ou_abcdefg."

Tips & Limitations

Currently, this tool is specifically optimized for image and video files. Ensure that your Feishu bot has the necessary 'im:message' and 'im:image' permissions enabled in the Feishu Developer Console. Because this skill relies on the execution of shell commands, ensure your server environment has curl and python3 installed. Always verify the open_id of your recipients, as this value is required for the final delivery stage. If the authentication token fails, check that your app_secret in the configuration file has not expired or been rotated.