What makes feishu-drive notable?

825 downloads. Trust evidence available

How should feishu-drive be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

feishu-drive

Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Skill: feishu-drive Owner: autogame-17 Summary: Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-13T06:56:09.673Z | user **Major change: Simplified skill structure and transitioned to template-driven card system.** - Replaced all code and CLI scripts with static interactive card templates.

OpenClaw

View on ClawHub

Rank

Safety

Downloads

825

Updated

Apr 15, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 825 downloads reported by the source. Last updated 4/15/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Apr 15, 2026
Protocol compatibility: OpenClawcompatibility · observed Apr 15, 2026
Adoption signal: 825 downloadsadoption · observed Apr 15, 2026
Latest release: 1.0.0release · observed Feb 13, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn7apafdj4thknczrgxdzfd2v1808svf:feishu-drive

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/snapshot"

Documentation

CLAWHUB

6,766 characters of source documentation, loaded on request.

Extracted files

2 files captured from the source.

SKILL.md

---
name: feishu-drive
description: 飞书云空间文件管理 Skill。上传/下载/移动/搜索文件、创建文件夹、获取元数据等。当需要管理飞书云空间中的文件和文件夹时使用此 Skill。
required_permissions:
  - drive:file:upload
  - drive:file:download
  - drive:drive:readonly
  - drive:drive.search:readonly
  - space:folder:create
  - space:document:move

# 🚀 快速启动：三步打通云空间 (必读)
为避免机器人文件进入“私有黑盒”，请在首次使用前完成以下配置：
1. **创建锚点**：在您的飞书云空间创建一个文件夹（如 `AI-Workspace`）。
2. **授权机器人**：在文件夹的【协作】设置中，搜索并添加您的应用（机器人）为【管理】或【编辑】权限。
3. **设置 Token**：复制该文件夹 URL 中的 Token，配置为 Skill 的 `ROOT_FOLDER_TOKEN`。
4. **冒烟测试**：调用 `batch_query` 接口查询该 Token 元数据。若返回 200 则配置成功；若返回 403/404 则检查应用可见性或授权是否到位。
---

# 飞书云空间文件管理

你是飞书云空间文件管理专家，负责通过 API 实现文件的上传、下载、移动、搜索和元数据管理。

---

## 一、API 基础信息

| 项目 | 值 |
|------|---|
| Base URL | `https://open.feishu.cn/open-apis/drive/v1` |
| 认证方式 | `Authorization: Bearer {tenant_access_token}` |
| Content-Type | `application/json`（文件上传用 `multipart/form-data`） |

---

## 二、文件夹操作

### 1. 创建文件夹

```
POST /open-apis/drive/v1/folders
```

```json
{ "name": "文件夹名", "folder_token": "root" }
```

**实测心法**：
1. `folder_token` 为父文件夹 ID，`root` 表示根目录。
2. **可见性保障 (重要)**：通过 API 创建的文件夹默认只对机器人可见。**强烈建议在创建后立即调用权限接口 (Skill 8)**，将用户（如管理员）添加为 `full_access` 协作者，这样文件夹才会出现在用户的「我的空间」列表中。
3. **权限继承**：一旦您被添加为父文件夹的管理员，AI 机器人在该文件夹下创建的所有子文件夹和文档，您都将自动拥有管理权限，无需重复授权。

---

## 三、文件上传

### 2. 上传文件（小文件一次性上传）

```
POST /open-apis/drive/v1/files/upload_all
Content-Type: multipart/form-data
```

表单字段：

| 字段 | 说明 |
|------|------|
| `file` | 文件二进制内容 |
| `file_name` | 文件名（如 `report.pdf`） |
| `parent_type` | 父节点类型（`explorer` = 云空间，`bitable_file` = 多维表格附件） |
| `parent_node` | 父节点 token（文件夹 token 或 app_token） |
| `size` | 文件大小（字节） |

**实测心法**：大文件建议使用分片上传接口。

### 3. 分片上传（大文件）

**第 1 步：准备上传**

```
POST /open-apis/drive/v1/files/upload_prepare
```

```json
{
  "file_name": "large_file.zip",
  "parent_type": "explorer",
  "parent_node": "fldcnXXX",
  "size": 104857600
}
```

返回 `upload_id` 和分片信息。

**第 2 步：逐片上传**

```
POST /open-apis/drive/v1/files/upload_part
Content-Type: multipart/form-data
```

**第 3 步：完成上传**

```
POST /open-apis/drive/v1/files/upload_finish
```

---

## 四、文件下载

### 4. 下载文件

```
GET /open-apis/drive/v1/files/:file_token/download
```

**实测心法**：流式读取响应体，注意保存路径。返回的是二进制流。

---

## 五、文件操作

### 5. 移动文件

```
POST /open-apis/drive/v1/files/:file_token/move
```

```json
{ "type": "docx", "folder_token": "fldcn..." }
```

**实测心法**：需要同时拥有源文件夹和目标文件夹的权限。

### 6. 复制文件

```
POST /open-apis/drive/v1/files/:file_token/copy
```

```json
{ "type": "bitable", "folder_token": "fldcn...", "name": "副本名称" }
```

**实测心法**：适用于从模板快速克隆多维表格、文档等。

---

## 六、文件查询

### 7. 获取文件元数据（批量）

```
POST /open-apis/drive/metadata/batch_query
```

```json
{
  "metadatas": [
    { "token": "...", "type": "docx" }
  ]
}
```

**实测心法**：支持批量查询，效率更高。可获取文件所有者、创建时间等。

### 8. 搜索文件

```
POST /open-apis/drive/v1/files/search
```

```json
{ "search_word": "关键词" }
```

**实测心法**：搜索结果包含文档、表格及文件夹。

---

## 七、安全与审计

### 9. 获取文件下载记录

```
GET /open-apis/drive/v1/files/:file_token/view_records
```

**实测心法**：用于监控敏感文件的流向，建立内

_meta.json

{
  "ownerId": "kn7apafdj4thknczrgxdzfd2v1808svf",
  "slug": "feishu-drive",
  "version": "1.0.0",
  "publishedAt": 1770965769673
}

Github ReposUpdated 5h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular