POPO 云空间文档上传

将用户指定的本地文件上传到 POPO 云空间文档，支持自动转换为在线文档和指定目标文件夹。

使用场景

当用户请求上传文件到 POPO 云空间时，使用此 skill。

触发词：

• "上传文件到 POPO"
• "把这个文件上传到云空间"
• "上传到 POPO 云空间"
• "把 xxx 文件上传到 POPO"
• "上传到文件夹 xxx"

在线文档支持

文件类型	支持转在线文档
docx	✅ 支持
txt	✅ 支持
xls	✅ 支持
xlsx	✅ 支持
csv	✅ 支持
pdf, ppt, 其他	❌ 不支持（上传为普通文件）

使用方式

1. 上传文件到"我的空间"

当用户说"上传 /path/to/file.pdf 到 POPO"时：

python3 /Users/admin/.openclaw/workspace/skills/popo-cloud-upload/scripts/upload_to_popo.py --file /path/to/file.pdf

2. 上传文件到指定文件夹

当用户说"上传 /path/to/file.pdf 到文件夹 123456"时：

python3 /Users/admin/.openclaw/workspace/skills/popo-cloud-upload/scripts/upload_to_popo.py --file /path/to/file.pdf --folder-id 123456

3. 上传目录

当用户说"上传 /path/to/directory 目录下的文件到 POPO"时：

python3 /Users/admin/.openclaw/workspace/skills/popo-cloud-upload/scripts/upload_to_popo.py --dir /path/to/directory

4. 上传目录到指定文件夹

当用户说"把 /path/to/directory 目录上传到文件夹 123456"时：

python3 /Users/admin/.openclaw/workspace/skills/popo-cloud-upload/scripts/upload_to_popo.py --dir /path/to/directory --folder-id 123456

参数说明

参数	说明	默认值
--file, -f	要上传的文件路径（从用户请求中获取）	-
--dir, -d	要上传的目录路径（从用户请求中获取）	-
--folder-id	目标文件夹 ID（从用户请求中获取）	我的空间
--permission, -p	访问权限：1=公开，0=私有	1
--transfer, -t	是否转换为在线文档	1

参数提取规则

文件路径提取

从用户消息中提取文件路径：

• "上传 /Users/admin/Documents/file.pdf 到 POPO" → --file /Users/admin/Documents/file.pdf
• "把 /tmp/test.txt 上传到云空间" → --file /tmp/test.txt

文件夹 ID 提取

从用户消息中提取文件夹 ID：

• "上传到文件夹 123456" → --folder-id 123456
• "上传到文件夹ID abc123" → --folder-id abc123
• "目标文件夹是 xyz789" → --folder-id xyz789

注意：文件夹 ID 通常是一串字母数字组合，由用户提供。

返回结果

支持转在线文档的文件（txt/docx/xls/xlsx/csv）

输出：

✅ 上传成功，在线文档地址：https://docs.popo.netease.com/lingxi/xxx

不支持转在线文档的文件（pdf/ppt等）

输出：

✅ 上传成功，文档地址：https://docs.popo.netease.com/docs/xxx

在线文档转换中

输出：

⏳ 上传成功，在线文档转换中，文档地址：https://docs.popo.netease.com/docs/xxx

处理流程

1. 提取参数：从用户消息中提取文件路径和文件夹 ID
2. 验证路径：检查路径是否存在
3. 执行上传：调用上传脚本
4. 输出结果：只输出在线文档地址（支持转换的文件）或文档地址（不支持的文件）

示例对话

用户：上传 /Users/admin/Documents/report.txt 到 POPO

回复：

✅ 上传成功，在线文档地址：https://docs.popo.netease.com/lingxi/xxx

---

用户：上传 /Users/admin/Documents/report.pdf 到文件夹 abc123def

回复：

✅ 上传成功，文档地址：https://docs.popo.netease.com/docs/xxx

（PDF 不支持转在线文档）

---

用户：把 /tmp/logs 目录下的文件上传到文件夹 xyz789

回复：

[1/5] log1.txt
✅ 上传成功，在线文档地址：https://docs.popo.netease.com/lingxi/xxx

[2/5] log2.txt
✅ 上传成功，在线文档地址：https://docs.popo.netease.com/lingxi/xxx
...

总计: 5 个文件，成功: 5，失败: 0

注意事项

• 文件路径从用户请求中获取，不要自己构造测试文件
• 文件夹 ID 从用户请求中获取，如未指定则上传到"我的空间"
• 确认文件路径存在后再执行上传
• 大文件（>100MB）自动使用分片上传
• 在线文档转换仅支持 docx/txt/xls/xlsx/csv 格式