错误码	原因	解决
1061002	params error	移除checksum参数
1062008

Feishu PDF Uploader | 飞书PDF上传器

上传本地PDF文件到飞书云盘。支持任意文件类型，不仅限于PDF。

Upload local PDF files (or any files) to Feishu (Lark) cloud drive.

快速开始 | Quick Start

bash
python3 scripts/uploadpdf.py /path/to/file.pdf --folder-token FOLDERTOKEN

使用方法 | Usage

命令行

bash
python3 scripts/uploadpdf.py path> [options]

Options:
--folder-token 目标文件夹token (默认从环境变量读取)
--app-id 飞书应用ID (默认从config读取)
--app-secret 飞书应用密钥 (默认从config读取)

Python API

python
from uploadpdf import uploadfiletofeishu

result = uploadfileto_feishu(
file_path=/path/to/file.pdf,
folder_token=VnTdf2MNglfgPtdrhCxcSTdOnZd,
appid=clixxx,
app_secret=xxx
)

Returns: {success: True, file_token: ..., url: ...}

工作原理 | How It Works

1. Prepare - 调用 /drive/v1/files/uploadprepare 获取 uploadid
Upload - 调用 /drive/v1/files/uploadpart 上传文件内容
Finish - 调用 /drive/v1/files/uploadfinish 完成上传

关键技术点

⚠️ 重要：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[].appId
channels.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并上传文件。不会存储或传输到其他地方。

feishu-pdf-uploader飞书PDF上传器