— name: feishu-drive description: | Feishu cloud storage file management. Activate when user mentions cloud space, folders, drive. — # 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 | Type | Description | | ———- | ———————– | | `doc` | Old format document | | `docx` | New format document | | `sheet` | Spreadsheet | | `bitable` | Multi-dimensional table | | `folder` | Folder | | `file` | Uploaded file | | `mindnote` | Mind map | | `shortcut` | Shortcut | ## 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