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. 1. Prepare - 调用 /drive/v1/files/uploadprepare 获取 uploadid
2. Upload - 调用 /drive/v1/files/uploadpart 上传文件内容
3. 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

使用场景 | Use Cases

• - 上传投资报告PDF到飞书云盘
• 备份生成的文档到云端
• 批量文件上传自动化

安全说明 | Security

凭证仅用于获取tenant access token并上传文件。不会存储或传输到其他地方。