Feishu PDF Uploader | 飞书PDF上传器
上传本地PDF文件到飞书云盘。支持任意文件类型，不仅限于PDF。
Upload local PDF files (or any files) to Feishu (Lark) cloud drive.
快速开始 | Quick Start
python3 scripts/upload_pdf.py /path/to/file.pdf --folder-token FOLDER_TOKEN
使用方法 | Usage
命令行
python3 scripts/upload_pdf.py <file_path> [options]
Options:
--folder-token 目标文件夹token (默认从环境变量读取)
--app-id 飞书应用ID (默认从config读取)
--app-secret 飞书应用密钥 (默认从config读取)
Python API
from upload_pdf import upload_file_to_feishu
result = upload_file_to_feishu(
file_path="/path/to/file.pdf",
folder_token="VnTdf2MNglfgPtdrhCxcSTdOnZd",
app_id="cli_xxx",
app_secret="xxx"
)
# Returns: {"success": True, "file_token": "...", "url": "..."}
工作原理 | How It Works
- Prepare - 调用
/drive/v1/files/upload_prepare获取 upload_id - Upload - 调用
/drive/v1/files/upload_part上传文件内容 - Finish - 调用
/drive/v1/files/upload_finish完成上传
关键技术点
⚠️ 重要：upload_part接口不需要 checksum 参数！
正确参数：
upload_id- 从prepare获取seq- 分片序号（从0开始）size- 文件大小（字节）file- 文件内容（multipart/form-data）
❌ 错误：添加checksum参数 → 返回 1061002 params error
✅ 正确：只传upload_id/seq/size/file → 上传成功
配置 | Configuration
从OpenClaw配置自动读取：
channels.feishu.accounts[].appIdchannels.feishu.accounts[].appSecret
错误处理 | Error Handling
| 错误码 | 原因 | 解决 |
|---|---|---|
| 1061002 | params error | 移除checksum参数 |
| 1062008 | checksum param Invalid | 不要传checksum |
| 1061021 | upload id expire | 重新调用prepare |
使用场景 | Use Cases
- 上传投资报告PDF到飞书云盘
- 备份生成的文档到云端
- 批量文件上传自动化
安全说明 | Security
凭证仅用于获取tenant access token并上传文件。不会存储或传输到其他地方。