Feishu Drive

What This Skill Does

The Feishu Drive skill empowers users to manage their Feishu Cloud Space files and folders directly through the OpenClaw AI agent. It provides a comprehensive suite of functionalities, including uploading, downloading, moving, and searching for files. Users can also create new folders and retrieve metadata for existing files. This skill is essential for anyone needing to interact with and organize content within their Feishu Cloud Drive environment programmatically.

Installation

To install the Feishu Drive skill, use the following command:

clawhub install openclaw/skills/skills/autogame-17/feishu-drive

This command will download and set up the necessary components for the skill to function. Ensure you have the ClawKit environment properly configured.

Use Cases

This skill is ideal for a variety of scenarios:

• Automated File Organization: Automatically upload daily reports to a specific folder in Feishu Drive.
• Content Retrieval: Search for and download important documents or project files without manually navigating the Feishu interface.
• Workflow Integration: Integrate Feishu Drive management into broader AI workflows, such as moving processed files to an archive folder.
• Team Collaboration Setup: Create shared project folders and grant necessary permissions programmatically.
• Metadata Management: Query file details like ownership and creation dates for auditing or reporting purposes.

🚀 Quick Start Guide (Mandatory Configuration): To ensure your robot's files are not lost in private folders and to enable proper functionality, please complete the following configurations before your first use:

1. Create an Anchor Folder: In your Feishu Cloud Space, create a dedicated folder (e.g., AI-Workspace).
2. Authorize the Robot: Within the "Collaboration" settings of this anchor folder, search for and add your application (robot) with "Manager" or "Editor" permissions.
3. Set the Root Folder Token: Extract the Token from the URL of the anchor folder you created and configure it as the ROOT_FOLDER_TOKEN for this skill.
4. Smoke Test: Execute the batch_query API call using the configured Token. A 200 response indicates successful configuration. If you receive a 403 or 404, verify the robot's visibility and authorization settings.

Example Prompts

1. "Search for the file named 'Q3 Marketing Report' in my Feishu Drive."
2. "Create a new folder called 'Project Alpha' in my Feishu Cloud Space and move the file 'final_design.pdf' into it."
3. "Upload the document 'meeting_minutes_2023-10-26.docx' to the 'Minutes' folder in my Feishu Drive."

Tips & Limitations

• Large File Uploads: For files larger than a few megabytes, it is highly recommended to use the multipart (chunked) upload API instead of the upload_all endpoint to avoid timeouts and ensure reliability.
• Permissions are Key: Remember that API operations are subject to the permissions granted to the robot within Feishu. Ensure the robot has the necessary drive:file:upload, drive:file:download, and folder access rights.
• Folder Visibility: Folders created via the API are initially only visible to the robot. To make them visible to users, you must explicitly grant them permissions using the relevant authorization API calls (like Skill 8 mentioned in the source documentation) after creation.
• Error Handling: Pay close attention to the API response codes. 403 errors often indicate permission issues, while 404 might suggest an incorrect token or a non-existent folder.
• Token Management: Securely manage your ROOT_FOLDER_TOKEN. This token is crucial for directing operations to the correct location within your Feishu Drive.