ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

tx-cos

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

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/156554395/tx-cos
Or

腾讯云 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”。

执行前要先确认本地文件存在、路径是文件而不是目录。返回结果时至少包含对象键、访问地址或资源标识、以及是否上传成功。

批量上传

适用:上传整个目录、多个文件、构建产物。

建议策略:

  • 先枚举文件列表
  • 明确远端前缀映射规则
  • 控制并发,避免一下子打爆带宽
  • 汇总成功数、失败数、失败文件

如果用户没有指定对象键规则,默认保留相对路径。

大文件上传

适用:视频、模型文件、压缩包。

优先用分片上传接口,并显式设置:

  • SliceSize
  • AsyncLimit
  • 进度回调

如果要做长时间上传,告诉用户:

  • 文件大小
  • 并发设置
  • 预计风险(网络抖动、覆盖同名对象)

获取签名 URL

适用:用户要临时下载链接、分享给别人。

关键参数:

  • Key
  • Expires

默认有效期可设为 3600 秒;如果用户没说,明确说明是临时链接。

列目录 / 文件夹视图

COS 没有真实目录,通常要用 Prefix + Delimiter: '/' 模拟文件夹。

当用户要“看看某个目录里有什么”时:

  • 优先返回文件夹和文件的分组视图
  • 结果过多时只展示前若干项,并提示可继续翻

删除、复制、移动、重命名

这些操作要更谨慎:

  • 删除前,确认对象键或前缀范围
  • 批量删除前,最好先列出将被删除的对象数量
  • 移动/重命名本质通常是复制后删除,要提示这一点
  • 跨 bucket 复制时,确认目标 bucket 是否由当前凭证可访问

如果用户表达不明确,比如“删一下旧文件”,先澄清范围。

安全边界

  • 绝不在回复里泄露敏感凭证
  • 输出配置检查结果时,只给出必要状态,不展示敏感值
  • 对删除、批量删除、递归删除操作保持高警惕
  • 如果涉及公开分享链接,提醒用户签名 URL 有时效,公开 Bucket 需额外确认
  • 不要擅自假设 Bucket 名、地域、对象路径

故障排查

常见问题与处理:

  • 凭证错误:检查访问凭证是否正确
  • 地域错误:检查地域配置是否和 Bucket 实际地域一致
  • Bucket 名错误:确认名称是否完整且可访问
  • 本地路径不存在:先校验文件存在
  • 自定义域名访问异常:先回退到默认访问域名验证
  • 大文件失败:降低并发、增大分片、重试上传

Metadata

Author@156554395
Stars4473
Views2
Updated2026-05-01
View Author Profile
AI Skill Finder

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 skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-156554395-tx-cos": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

amoeba-management-analysis

阿米巴经营分析技能。基于稻盛和夫阿米巴经营理念,提供单位时间核算、经营会计报表分析、阿米巴组织划分评估、业绩改善诊断等能力。 当用户需要做阿米巴经营分析、单位时间核算、经营会计、阿米巴组织划分、利润中心分析、内部交易定价、业绩评价时触发。 触发词:阿米巴、阿米巴经营、单位时间核算、经营会计、利润中心、内部交易、阿米巴划分、巴长、稻盛和夫、京瓷会计学

156554395 4473

doubao-image-video

豆包图片与视频生成原生技能。适用于用户提到豆包、文生图、图生图、文生视频、图生视频、查询视频生成任务、等待任务完成或下载最终视频时,直接调用火山引擎 Ark 接口,不依赖外部 MCP 服务。

156554395 4473

zhipu-free-image-video

智谱免费图片与视频生成技能。适用于用户想用智谱生成图片、批量出图、生成短视频、查询视频任务结果、等待视频完成,或优先使用免费/低成本模型快速产出创意内容时。

156554395 4473

bigmodel-image-video

使用 BigModel (CogView/CogVideoX) API 生成高质量图片和视频。当用户需要"生成图片"、"制作视频"、"AI 绘画"、"创建封面"、"设计海报"、"视觉内容生成"、或任何需要创建图像/视频内容的场景时使用此技能。即使没有明确提到"生成",只要用户需要创建、设计或制作视觉内容(如小说封面、产品图片、宣传图、短视频等),都应该主动使用此技能。

156554395 4473

novel-writer

小说写作助手。触发词:写小说/创作小说/生成小说/帮我写个小说/小说大纲/网文创作。工作流:需求收集(类型/风格/字数)→ AI生成大纲(世界观/人物/剧情/章节规划)→ 用户确认 → 自动逐章生成 → 一章一个文件保存。支持玄幻、仙侠、都市、科幻、历史、武侠、网游、灵异、军事、竞技等主流网文类型,面向新手作者。

156554395 4473