腾讯云 COS 原生操作技能

---

name: tx-cos description: 面向 OpenClaw 的腾讯云 COS 原生操作技能。适用于上传本地文件、批量同步目录、大文件分片上传、生成临时签名链接、浏览对象与文件夹视图、复制/移动/重命名/删除对象、统计目录体量，以及排查 COS 凭证和 Bucket 配置。 metadata: { "openclaw": { "requires": { "bins": ["node", "npm"] } } }

---

腾讯云 COS 技能

把腾讯云 COS 变成 OpenClaw 可直接调用的一组高频对象存储工作流。

适合这些典型任务：

把本地文件或整个目录快速上传到 COS

为图片、压缩包、构建产物生成临时访问链接

浏览某个前缀下的文件结构，做复制、移动、重命名、清理

处理视频、模型、备份包等大文件上传

快速判断凭证、地域、Bucket、自定义域名哪里配错了

默认做法是：

优先检查关键配置与目标路径

在需要时生成并执行简洁脚本，直接完成对象存储操作

结果以结构化 JSON 或简洁中文返回给用户

适用场景

当用户出现这些意图时启用：

把本地文件上传到腾讯云 COS

批量上传一个目录或多个文件到 COS

上传大文件并控制并发、分片大小、断点续传策略

获取 COS 对象的临时签名 URL

列出某个前缀下的文件或文件夹

创建、删除、移动、复制、重命名 COS 对象

统计某个目录下的文件数量和总大小

排查 COS 凭证、地域、Bucket、自定义域名配置

前置条件

要求具备可访问腾讯云 COS 的运行环境和必要配置。

如果关键配置不完整，先明确缺什么，不要猜。

脚本资源

优先使用 scripts/ 里的可执行脚本，而不是每次临时重写一遍逻辑。

可直接复用的脚本：

scripts/check_config.js - 检查关键配置是否齐全

scripts/upload_file.js - 上传单个文件

scripts/upload_batch.js - 批量上传文件或整个目录

scripts/generate_signed_url.js - 生成临时签名链接

scripts/list_objects.js - 列出对象或文件夹视图

scripts/manage_objects.js - 删除、批量删除、复制、移动、重命名、创建文件夹

scripts/upload_large_file.js - 大文件分片上传

scripts/delete_folder.js - 删除文件夹，支持递归删除

scripts/get_folder_stats.js - 统计目录文件数量、总体积和类型分布

调用方式统一为：

node projects/skills/tx-cos/scripts/