tx-cos
面向 OpenClaw 的腾讯云 COS 原生操作技能。适用于上传本地文件、批量同步目录、大文件分片上传、生成临时签名链接、浏览对象与文件夹视图、复制/移动/重命名/删除对象、统计目录体量,以及排查 COS 凭证和 Bucket 配置。
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/156554395/tx-cos腾讯云 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/<script>.js '<json>'
默认执行策略
1. 先检查配置
优先先跑 scripts/check_config.js 确认关键配置是否齐全。
如果必需项缺失,直接告诉用户缺哪几个,不继续执行上传/删除类操作。
2. 需要真实操作时,优先调用现成脚本
这个技能的目标是让代理直接完成对象存储相关工作,而不是额外引入中间层。
优先采用脚本化、输入输出明确的执行方式;只有脚本覆盖不了时,才补临时逻辑。
3. 输出要面向人类
返回结果时优先包含:
- 操作是否成功
- 对象键 / 路径
- URL / ETag / 大小 / 数量等关键信息
- 失败时给出可执行的修复建议
不要把整段 SDK 原始响应直接甩给用户,除非对方明确要原始 JSON。
常用工作流
上传单文件
适用:用户说“把这个文件传到 COS”。
执行前要先确认本地文件存在、路径是文件而不是目录。返回结果时至少包含对象键、访问地址或资源标识、以及是否上传成功。
批量上传
适用:上传整个目录、多个文件、构建产物。
建议策略:
- 先枚举文件列表
- 明确远端前缀映射规则
- 控制并发,避免一下子打爆带宽
- 汇总成功数、失败数、失败文件
如果用户没有指定对象键规则,默认保留相对路径。
大文件上传
适用:视频、模型文件、压缩包。
优先用分片上传接口,并显式设置:
SliceSizeAsyncLimit- 进度回调
如果要做长时间上传,告诉用户:
- 文件大小
- 并发设置
- 预计风险(网络抖动、覆盖同名对象)
获取签名 URL
适用:用户要临时下载链接、分享给别人。
关键参数:
KeyExpires
默认有效期可设为 3600 秒;如果用户没说,明确说明是临时链接。
列目录 / 文件夹视图
COS 没有真实目录,通常要用 Prefix + Delimiter: '/' 模拟文件夹。
当用户要“看看某个目录里有什么”时:
- 优先返回文件夹和文件的分组视图
- 结果过多时只展示前若干项,并提示可继续翻
删除、复制、移动、重命名
这些操作要更谨慎:
- 删除前,确认对象键或前缀范围
- 批量删除前,最好先列出将被删除的对象数量
- 移动/重命名本质通常是复制后删除,要提示这一点
- 跨 bucket 复制时,确认目标 bucket 是否由当前凭证可访问
如果用户表达不明确,比如“删一下旧文件”,先澄清范围。
安全边界
- 绝不在回复里泄露敏感凭证
- 输出配置检查结果时,只给出必要状态,不展示敏感值
- 对删除、批量删除、递归删除操作保持高警惕
- 如果涉及公开分享链接,提醒用户签名 URL 有时效,公开 Bucket 需额外确认
- 不要擅自假设 Bucket 名、地域、对象路径
故障排查
常见问题与处理:
- 凭证错误:检查访问凭证是否正确
- 地域错误:检查地域配置是否和 Bucket 实际地域一致
- Bucket 名错误:确认名称是否完整且可访问
- 本地路径不存在:先校验文件存在
- 自定义域名访问异常:先回退到默认访问域名验证
- 大文件失败:降低并发、增大分片、重试上传
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-156554395-tx-cos": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
amoeba-management-analysis
阿米巴经营分析技能。基于稻盛和夫阿米巴经营理念,提供单位时间核算、经营会计报表分析、阿米巴组织划分评估、业绩改善诊断等能力。 当用户需要做阿米巴经营分析、单位时间核算、经营会计、阿米巴组织划分、利润中心分析、内部交易定价、业绩评价时触发。 触发词:阿米巴、阿米巴经营、单位时间核算、经营会计、利润中心、内部交易、阿米巴划分、巴长、稻盛和夫、京瓷会计学
doubao-image-video
豆包图片与视频生成原生技能。适用于用户提到豆包、文生图、图生图、文生视频、图生视频、查询视频生成任务、等待任务完成或下载最终视频时,直接调用火山引擎 Ark 接口,不依赖外部 MCP 服务。
zhipu-free-image-video
智谱免费图片与视频生成技能。适用于用户想用智谱生成图片、批量出图、生成短视频、查询视频任务结果、等待视频完成,或优先使用免费/低成本模型快速产出创意内容时。
bigmodel-image-video
使用 BigModel (CogView/CogVideoX) API 生成高质量图片和视频。当用户需要"生成图片"、"制作视频"、"AI 绘画"、"创建封面"、"设计海报"、"视觉内容生成"、或任何需要创建图像/视频内容的场景时使用此技能。即使没有明确提到"生成",只要用户需要创建、设计或制作视觉内容(如小说封面、产品图片、宣传图、短视频等),都应该主动使用此技能。
novel-writer
小说写作助手。触发词:写小说/创作小说/生成小说/帮我写个小说/小说大纲/网文创作。工作流:需求收集(类型/风格/字数)→ AI生成大纲(世界观/人物/剧情/章节规划)→ 用户确认 → 自动逐章生成 → 一章一个文件保存。支持玄幻、仙侠、都市、科幻、历史、武侠、网游、灵异、军事、竞技等主流网文类型,面向新手作者。