SKILL.md
readonly

feishu-drive

Author:openclaw
Category:
Development
323.5k
62.3k
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/ABC123folder_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

Actions

install --global skills.sh
npx skills add openclaw/openclaw/extensions/feishu/skills/feishu-drive

Usage Guide

  1. 1. Run Install Command

    Copy the installation command above and run it in your terminal to install globally.

  2. 2. Configure Environment

    Add the required environment variables to your MCP client according to the skill description.

  3. 3. Use in Client

    Configure and enable this skill in any MCP-compatible app (e.g. Claude or Cursor).