feishu-drive

Original🇺🇸 English
Translated

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

12installs
Added on

NPX Install

npx skill4agent add m1heng/clawdbot-feishu feishu-drive

Tags

Translated version includes tags in frontmatter

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
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