mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-25 22:38:38 +00:00
2267d58afc
Replace the built-in Feishu SDK with the community-maintained clawdbot-feishu plugin by @m1heng. Changes: - Remove src/feishu/ directory (19 files) - Remove src/channels/plugins/outbound/feishu.ts - Remove src/channels/plugins/normalize/feishu.ts - Remove src/config/types.feishu.ts - Remove feishu exports from plugin-sdk/index.ts - Remove FeishuConfig from types.channels.ts New features in community plugin: - Document tools (read/create/edit Feishu docs) - Wiki tools (navigate/manage knowledge base) - Drive tools (folder/file management) - Bitable tools (read/write table records) - Permission tools (collaborator management) - Emoji reactions support - Typing indicators - Rich media support (bidirectional image/file transfer) - @mention handling - Skills for feishu-doc, feishu-wiki, feishu-drive, feishu-perm Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
98 lines
2.3 KiB
Markdown
98 lines
2.3 KiB
Markdown
---
|
|
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
|