阿里云OSS文件上传工具
安全、高效的文件上传和临时链接生成工具
🎯 核心功能
- ✅ 单文件上传: 支持上传单个本地文件到OSS
- ✅ 批量上传: 支持同时上传多个文件
- ✅ 大文件分片上传: 自动处理超过100MB的大文件
- ✅ 指定目录上传: 可指定OSS中的存储路径
- ✅ 文件大小限制: 拒绝超过2GB的文件
- ✅ 自动重命名: 避免文件名冲突（UUID或时间戳策略）
- ✅ 预签名URL生成: 自动生成临时访问链接
- ✅ 链接有效期自定义: 支持1小时、6小时、1天、7天等选项
- ✅ 文件检索: 根据文件名搜索OSS中的文件
🔒 安全特性
- ✅ AK/SK认证: 使用阿里云AccessKey进行认证
- ✅ 配置分离: 所有敏感信息通过外部配置文件管理
- ✅ 链接时效性: 预签名URL自动过期，降低数据泄露风险
- ✅ 文件大小限制: 防止上传超大文件
⚙️ 配置要求
创建配置文件 /root/.openclaw/aliyun-oss-config.json:
{
"endpoint": "oss-cn-shanghai.aliyuncs.com",
"bucket_name": "your-bucket-name",
"auth": {
"access_key_id": "your-access-key-id",
"access_key_secret": "your-access-key-secret"
},
"max_file_size_mb": 2048,
"default_expire_hours": 0.5,
"large_file_threshold_mb": 100,
"default_prefix": "uploads/"
}
🚀 使用方法
命令行使用
# 上传单个文件
python3 main.py upload /path/to/file.txt uploads/
# 批量上传
python3 main.py batch_upload file1.txt file2.txt file3.txt uploads/
# 搜索文件
python3 main.py search filename.txt
OpenClaw集成
- 支持作为媒体处理器处理文件上传
- 可通过OpenClaw的消息系统触发上传任务
- 生成的临时链接可直接在聊天中分享
🔧 技术细节
- 依赖:
oss2,requests - 分片上传: 使用OSS SDK的multipartUpload
- 预签名URL: 使用OSS SDK的sign_url方法
- 错误处理: 完善的异常处理和重试机制
🛡️ 安全最佳实践
- 使用RAM用户: 创建专门的RAM用户用于OSS上传
- 最小权限: 用户权限仅包含
oss:PutObject,oss:GetObject,oss:ListObjects - 配置文件权限: 设置为600（仅所有者可读写）
- 定期轮换: 定期更新AccessKey
🆘 故障排除
- 403错误: 检查RAM用户权限和AccessKey
- 文件大小超限: 确认文件不超过2GB限制
- 上传失败: 检查网络连接和OSS配置
💡 开发规范
此技能严格遵循以下开发准则：
- ✅ 开源兼容性: 完全符合开源skills的配置要求和目录结构
- ✅ 合规性: 完全符合当地的法律法规要求
- ✅ 功能完整性: 仅包含已实现和测试通过的功能，无占位符或未完成代码
📦 部署说明
- 生产就绪: 所有测试代码和临时文件已在发布前清理
- 安全配置: 敏感信息通过外部配置文件管理，不在源码中硬编码
- 依赖管理: 仅依赖必要的Python包（oss2, requests）