Menu
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/dvcrn/openclaw-skills-marketplace --skill feishu-driveThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | feishu-drive |
| description | 飞书云空间文件管理 Skill。上传/下载/移动/搜索文件、创建文件夹、获取元数据等。当需要管理飞书云空间中的文件和文件夹时使用此 Skill。 |
你是飞书云空间文件管理专家，负责通过 API 实现文件的上传、下载、移动、搜索和元数据管理。
| 项目 | 值 |
|---|---|
| Base URL | https://open.feishu.cn/open-apis/drive/v1 |
| 认证方式 | Authorization: Bearer {tenant_access_token} |
| Content-Type | application/json（文件上传用 multipart/form-data） |
POST /open-apis/drive/v1/folders
{ "name": "文件夹名", "folder_token": "root" }
实测心法：
folder_token 为父文件夹 ID，root 表示根目录。full_access 协作者，这样文件夹才会出现在用户的「我的空间」列表中。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 | 文件大小（字节） |
实测心法：大文件建议使用分片上传接口。
第 1 步：准备上传
POST /open-apis/drive/v1/files/upload_prepare
{
"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
GET /open-apis/drive/v1/files/:file_token/download
实测心法：流式读取响应体，注意保存路径。返回的是二进制流。
POST /open-apis/drive/v1/files/:file_token/move
{ "type": "docx", "folder_token": "fldcn..." }
实测心法：需要同时拥有源文件夹和目标文件夹的权限。
POST /open-apis/drive/v1/files/:file_token/copy
{ "type": "bitable", "folder_token": "fldcn...", "name": "副本名称" }
实测心法：适用于从模板快速克隆多维表格、文档等。
POST /open-apis/drive/metadata/batch_query
{
"metadatas": [
{ "token": "...", "type": "docx" }
]
}
实测心法：支持批量查询，效率更高。可获取文件所有者、创建时间等。
POST /open-apis/drive/v1/files/search
{ "search_word": "关键词" }
实测心法：搜索结果包含文档、表格及文件夹。
GET /open-apis/drive/v1/files/:file_token/view_records
实测心法：用于监控敏感文件的流向，建立内部合规审计流。
POST /open-apis/drive/v1/files/:file_token/security_labels
实测心法：为核心文档打上"绝密"标签，限制二次转发。飞书企业版的核心安全能力。
关键教训 (2026-02-10)：机器人创建的文件默认对用户不可见。必须在每个写操作后手动补齐权限。
| 目标权限 | external_access_entity | link_share_entity | security_entity |
|---|---|---|---|
| 组织内可阅读 | closed | tenant_readable | anyone_can_view |
| 组织内可编辑 | closed | tenant_editable | anyone_can_edit |
| 互联网公开阅读 | open | anyone_readable | anyone_can_view |
| 互联网公开编辑 | open | anyone_editable | anyone_can_edit |
AI Agent 准则：
parent_node（如共享文件夹）。upload_all、copy 或 create_docx 后，必须紧接着调用权限接口，将请求者添加为 full_access 协作者，否则用户在云盘主目录无法管理该资产。ROOT_FOLDER_TOKEN 的可用性。若失效，应立即推送“配置引导”卡片而非报错。| 错误码 | 含义 | 解决方案 |
|---|---|---|
| 0 | 成功 | — |
| 1061001 | 文件不存在 | 检查 file_token |
| 1061002 | 无权限 | 检查应用权限和文件夹授权 |
| 1061045 | 文件大小超限 | 使用分片上传 |
| 99991663 | token 过期 | 重新获取 tenant_access_token |
| 功能维度 | 具体能力 | 说明 |
|---|---|---|
| 空间管理 | 文件夹自动化 | 支持在指定的共享空间内自动创建多级子文件夹，实现资产的结构化组织。 |
| 资产同步 | 跨空间克隆与上传 | 支持将本地文件（如 PPT/PDF）一键上传，或将云端标准模版（如 PRD）跨目录克隆到目标空间。 |
| 感知与检索 | 智能元数据查询 | 提供高效的文件元数据批量查询与关键词模糊搜索能力，解决资产定位难题。 |
| 协作安全性 | 权限自愈逻辑 | 在文件生成后自动同步指定用户的管理权限，打通“机器人-人类”之间的空间可见性隔阂。 |
新项目资产中心自动构建：
营销物料自动化分发与归档：
财务/法务文档智能备份：
权限“黑盒”隔阂 (Critical)：
permissions 接口调用，将相关负责人添加为 full_access 协作者。只有这样，文件才会出现在用户的「与我共享」列表中。指定“空间锚点”原则：
文件夹创建 API 兼容性：
upload_all 接口的 parent_node 参数来实现路径指定，而非频繁调用新建目录接口。冒烟测试先行：
list_files 探测该 Token 是否可用。如果冒烟测试不通过（报 403/404），应引导用户检查“机器人可见性”或“文件夹协作授权”是否已开启。注：以上内容已进行脱敏处理，所有“主帅”、“董事长”、“PixPaw”等私有信息已替换为通用互联网公司职能与项目描述。