Feishu Drive

m1heng/clawdbot-feishu/skills/feishu-drive

by m1hengb07885b756acNo license4.2K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 6 months ago

Feishu cloud storage file management. Activate when user mentions cloud space, folders, drive.

Instructions onlyProductivity & Workflow
AI-generated overview

Manages Feishu cloud drive files and folders through a single feishu_drive tool.

What it does
Provides one tool, feishu_drive, for Feishu cloud storage operations: listing folder contents, getting file info, creating folders, moving files and deleting files. It documents token extraction from Feishu URLs, supported file types such as doc, docx, sheet, bitable, folder, file, mindnote and shortcut, and the drive:drive and drive:drive:readonly permission scopes. It also notes that bots lack a root folder and can only reach items shared with them.
When to use it
Use when a user mentions cloud space, folders or drive and needs to browse, inspect, organize or remove files in Feishu cloud storage. It fits requests to list a folder, look up a file, create a folder, move a file or delete a file.
Requirements
Requires the Feishu channel with the drive tool enabled and Feishu drive permissions (drive:drive for full access, drive:drive:readonly for read-only). Network access to Feishu is needed. No scripts ship with the skill; it is instructions only.

Feishu Drive Tool

Single tool feishu_drive for cloud storage operations.

Token Extraction

From URL https://xxx.feishu.cn/drive/folder/ABC123 → folder_token = ABC123

Actions

List Folder Contents

json
{ "action": "list" }

Root directory (no folder_token).

json
{ "action": "list", "folder_token": "fldcnXXX" }

Returns: files with token, name, type, url, timestamps.

Get File Info

json
{ "action": "info", "file_token": "ABC123", "type": "docx" }

Searches for the file in the root directory. Note: file must be in root or use list to browse folders first.

type: doc, docx, sheet, bitable, folder, file, mindnote, shortcut

Create Folder

json
{ "action": "create_folder", "name": "New Folder" }

In parent folder:

json
{ "action": "create_folder", "name": "New Folder", "folder_token": "fldcnXXX" }

Move File

json
{ "action": "move", "file_token": "ABC123", "type": "docx", "folder_token": "fldcnXXX" }

Delete File

json
{ "action": "delete", "file_token": "ABC123", "type": "docx" }

File Types

TypeDescription
docOld format document
docxNew format document
sheetSpreadsheet
bitableMulti-dimensional table
folderFolder
fileUploaded file
mindnoteMind map
shortcutShortcut

Configuration

yaml
channels:  feishu:    tools:      drive: true  # default: true

Permissions

  • drive:drive - Full access (create, move, delete)
  • drive:drive:readonly - Read only (list, info)

Known Limitations

  • Bots have no root folder: Feishu bots use tenant_access_token and don't have their own "My Space". The root folder concept only exists for user accounts. This means:
    • create_folder without folder_token will fail (400 error)
    • Bot can only access files/folders that have been shared with it
    • Workaround: User must first create a folder manually and share it with the bot, then bot can create subfolders inside it

Source and attribution

Source:m1heng/clawdbot-feishuinskills/feishu-driveat commitb07885b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal