home / skills / openclaw / openclaw / feishu-drive

feishu-drive skill

safe

This skill helps you manage Feishu Drive cloud storage by listing, creating folders, moving, and deleting files through simple prompts.

npx playbooks add skill openclaw/openclaw --skill feishu-drive

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

2.3 KB

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

Overview

This skill manages files and folders in Feishu cloud storage (Drive). It provides listing, file info, folder creation, move and delete operations, and understands Feishu file tokens extracted from Drive URLs. Use it when users mention cloud space, folders, drive, or ask to organize files in Feishu.

How this skill works

The skill accepts simple action objects (list, info, create_folder, move, delete) and optional tokens to target folders or files. For folder URLs it extracts the folder_token (e.g., the last path segment). It returns file metadata including token, name, type, url, and timestamps, and enforces Feishu permission boundaries and sharing rules.

When to use it

Browsing or listing contents of a Feishu Drive or a shared folder
Getting metadata or details for a specific Feishu document or file
Creating subfolders inside a folder that has been shared with the bot
Moving files between folders within the bot-accessible space
Deleting files when you want to remove items the bot can access

Best practices

Always use shared folders: the bot cannot create a root folder for you—share a parent folder first
List a folder before requesting info if the file may be nested rather than in root
Include the correct file type (doc, docx, sheet, bitable, file, mindnote, shortcut) when calling info/move/delete
Share folders with the bot account and grant drive:drive when write operations are needed
Use folder_token extracted from the Drive URL to target folder-specific operations

Example use cases

User shares a project folder with the bot; create subfolders per sprint and move documents into them
List contents of a shared team folder to show recent files and timestamps
Retrieve file info for a document token to display its URL and last modified time
Delete an obsolete uploaded file that the bot has been granted access to
Move a spreadsheet from one shared folder to another to reorganize team data

FAQ

Can the bot create a new top-level folder in my Drive?

No. Bots have no root My Space. You must create a top-level folder and share it with the bot; the bot can then create subfolders inside it.

What if I get a 400 error when creating a folder without folder_token?

That means the operation tried to create a folder in root. Provide a folder_token for a shared parent folder or share a folder with the bot first.