| name | feishu-file-upload |
| description | 上传文件到飞书云空间。支持单文件上传(<=20MB)和分片上传(>20MB)。触发词:上传文件、传到飞书、飞书上云、文件上传。 |
| metadata | {"openclaw":{"emoji":"📤","requires":{"config":["channels.feishu"]}}} |
feishu-file-upload
上传本地文件到飞书云空间(My Space)。
使用限制
- 单文件上传:最大 20MB(使用
upload_all 接口)
- 分片上传:支持超大文件(使用
uploadPrepare + uploadFinish)
触发方式
当用户说「上传文件」「传到飞书」「飞书上云」时使用。
调用方式
使用飞书 MCP 工具调用:
方式一:单文件上传(<=20MB)
需要先通过其他途径获取文件内容,然后调用飞书 Drive API。
方式二:分片上传(推荐)
由于 MCP 环境限制,建议通过以下方式实现:
- 先将文件转为 Base64 或获取文件路径
- 使用
drive.v1.file.uploadPrepare 获取上传事务 ID
- 分片上传文件内容
- 使用
drive.v1.file.uploadFinish 完成上传
参数说明
| 参数 | 必填 | 类型 | 说明 |
|---|
| file_path | 是 | string | 本地文件路径 |
| parent_node | 否 | string | 目标文件夹 token(默认上传到根目录) |
注意事项
- 需要飞书应用具有
Upload file 权限
- 文件名最大 250 字符
- 云空间单个目录最多 1500 个文件
- 个人空间最多 400,000 个节点
示例
用户说「把这个 zip 包传到飞书」:
- 确认文件路径
- 检查文件大小
- 调用上传接口
- 返回文件链接
错误处理
- 1061043: 文件大小超限 → 建议使用分片上传
- 1061044: 文件夹不存在 → 检查 parent_node 是否正确
- 1061073: 没有权限 → 需要在飞书应用后台添加权限