使用阿里云盘官方 SDK (aliyunpan Python 包) 进行文件操作。
python3 -m venv /tmp/venv
/tmp/venv/bin/pip install aliyunpan requests
在 .env 文件中配置:
ALIYUN_DRIVE_REFRESH_TOKEN="your_refresh_token"
获取 refresh_token:登录阿里云盘网页版 → F12 → Application → Local Storage → 找 refreshToken
| action | 说明 | 关键参数 |
|---|---|---|
| -------- | ------ | ---------- |
upload | 上传文件 | file_path, target_folder |
list | 列出文件 | parent_id (默认 root) |
create_folder | 创建文件夹 | name, parent_id |
search | 搜索文件 | name, parent_id |
share | 创建分享链接 | file_id |
delete | 删除文件 | file_id |
download_url | 获取下载链接 | file_id |
user_info | 获取用户信息 | - |
action: upload
file_path: /path/to/file.png
target_folder: backup
action: list
parent_id: 69f3075d2490bbe147834f8ba84df323453f4d08
action: create_folder
name: backup
parent_id: root
action: search
name: openclaw.png
target_folder: 文件夹名称(如 openclaw),在根目录创建/查找parent_id: 直接指定父文件夹 ID.envaliyunpan SDK (3.0.9),是唯一能正常工作的 SDK共 1 个版本