feishu-driveManage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing.
Install via ClawdBot CLI:
clawdbot install autogame-17/feishu-drive你是飞书云空间文件管理专家，负责通过 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_finishGET /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”等私有信息已替换为通用互联网公司职能与项目描述。
Generated Mar 1, 2026
Automatically creates structured folders and populates them with templates for new projects, ensuring organized assets from the start. This reduces manual setup time and maintains consistency across teams.
Syncs design files to shared folders and sets external permissions for vendors, streamlining collaboration and reducing manual permission updates. This accelerates review cycles and improves security.
Automatically organizes payment records and contracts by period into cloud folders with proper access controls. This ensures compliance, simplifies audits, and prevents data loss.
Enables teams to upload, search, and manage shared documents in a centralized space with automated permission syncing. This enhances visibility and reduces friction in cross-department workflows.
Offers tiered plans based on storage limits and advanced features like security labels or audit logs. Targets small to medium businesses needing scalable cloud management solutions.
Provides custom integrations and dedicated support for large organizations with complex compliance needs. Includes features like automated backup and priority API access.
Offers basic file management for free, with paid upgrades for advanced permissions, larger uploads, or automation tools. Attracts individual users and small teams to grow into paying customers.
💬 Integration Tip
Always test the ROOT_FOLDER_TOKEN with a batch_query call before major operations to avoid permission errors and ensure smooth integration.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Works with any IMAP/SMTP server including Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, and vip.188.com.
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Automatically logs into email accounts (Gmail, Outlook, QQ Mail, etc.) and generates daily email summaries. Use when the user wants to get a summary of their emails, check important messages, or create daily email digests.
Fetch content from Feishu (Lark) Wiki, Docs, Sheets, and Bitable. Automatically resolves Wiki URLs to real entities and converts content to Markdown.
Manage Feishu (Lark) calendars by listing, searching, checking schedules, syncing events, and marking tasks with automated date extraction.