agentCLAWHUBUnverified
Tencent COS
腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Skill: Tencent COS Owner: ShawnMinh Summary: 腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-02-28T11:26:32.256Z | user - Added scripts/setup.sh to provide automated environment checking and credential setup. - Now supports a one-command initialization: check dependencies, prompt for Tencent Cloud creden
OpenClaw
Rank
62
Safety
84
Downloads
1.6k
Updated
Apr 15, 2026
Version
1.0.5
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 4/15/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Apr 15, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Apr 15, 2026
- Adoption signal
- 1.6K downloadsadoption · observed Apr 15, 2026
- Latest release
- 1.0.5release · observed Feb 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install kn75r0rammt45k8qe5we0sh63580c5y0:tencent-cos-skill- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cos-skill/snapshot"
Documentation
CLAWHUB
32,189 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: tencent-cloud-cos
description: >
腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件，
或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、
文档转PDF、视频智能封面生成等操作时使用此技能。
metadata:
{
"openclaw":
{
"emoji": "☁️",
"requires": {},
"install":
[
{
"id": "node-mcporter",
"kind": "node",
"package": "mcporter",
"bins": ["mcporter"],
"label": "Install mcporter (MCP CLI)",
},
{
"id": "node-cos-mcp",
"kind": "node",
"package": "cos-mcp",
"bins": ["cos-mcp"],
"label": "Install cos-mcp (COS MCP Server)",
},
{
"id": "node-cos-sdk",
"kind": "node",
"package": "cos-nodejs-sdk-v5",
"label": "Install COS Node.js SDK",
},
],
},
}
---
# 腾讯云 COS 技能
通过 cos-mcp MCP 工具 + Node.js SDK 脚本 + COSCMD 管理腾讯云对象存储和数据万象。
## 首次使用 — 自动设置
当用户首次要求操作 COS 时，按以下流程操作：
### 步骤 1：检查当前状态
```bash
{baseDir}/scripts/setup.sh --check-only
```
如果输出显示一切 OK（cos-mcp 已安装、凭证已配置），跳到「执行策略」。
### 步骤 2：如果未配置，引导用户提供凭证
告诉用户：
> 我需要你的腾讯云凭证来连接 COS 存储服务。请提供：
> 1. **SecretId** — 腾讯云 API 密钥 ID
> 2. **SecretKey** — 腾讯云 API 密钥 Key
> 3. **Region** — 存储桶区域（如 ap-guangzhou）
> 4. **Bucket** — 存储桶名称（格式 name-appid，如 mybucket-1250000000）
> 5. **DatasetName**（可选） — 数据万象数据集名称（仅智能搜索需要）
>
> 你可以在 [腾讯云控制台 > 访问管理 > API密钥管理](https://console.cloud.tencent.com/cam/capi) 获取密钥，
> 在 [COS 控制台](https://console.cloud.tencent.com/cos/bucket) 查看存储桶信息。
### 步骤 3：用户提供凭证后，运行自动设置
```bash
{baseDir}/scripts/setup.sh --secret-id "<SecretId>" --secret-key "<SecretKey>" --region "<Region>" --bucket "<Bucket>"
```
如有 DatasetName：
```bash
{baseDir}/scripts/setup.sh --secret-id "<SecretId>" --secret-key "<SecretKey>" --region "<Region>" --bucket "<Bucket>" --dataset "<DatasetName>"
```
脚本会自动：
- 检查并安装 mcporter（MCP 命令行工具）
- 检查并安装 cos-mcp 和 cos-nodejs-sdk-v5
- 创建/更新 `~/.mcporter/mcporter.json`，写入 cos-mcp 服务器配置
- 将凭证写入 shell 配置文件（`~/.zshrc` 或 `~/.bashrc`），重启后仍可用
- 配置 coscmd（如有 Python 环境）
- 验证 COS 连接
设置完成后即可开始使用。
## 执行策略
三种方式按优先级降级，确保操作始终可完成：
1. **方式一：cos-mcp MCP 工具**（优先） — 功能最全，支持存储 + 图片处理 + 智能搜索 + 文档媒体处理
2. **方式二：Node.js SDK 脚本** — 通过 `scripts/cos_node.mjs` 执行存储操作
3. **方式三：COSCMD 命令行** — 通过 shell 命令执行存储操作
```
mcporter + cos-mcp 可用？（which mcporter && 配置存在）
├─ 是 → 使用方式一 mcporter 调用（全部功能）
└─ 否 → cos-mcp MCP 工具可直接调用？（getCosConfig 返回结果）
├─ 是 → 使用方式一直接调用（全部功能）
└─ 否 → Node.js + cos-nodejs-sdk-v5 可用？
├─ 是 → 使用方式二（存储操作）
└─ 否 → coscmd 可用？（which coscmd）
├─ 是 → 使用方式三（存储操作）
└─ 否 → 运行 setup.sh 安装
```
**判断方式一(mcporter)**：`which mcporter` 且 `cat ~/.mcporter/mcporter.json | grep cos-mcp` 有输出。
**判断方式一(直接)**：尝试调用 `getCosConfig` MCP 工具，若返回结果则可用。
**判断方式二**：`node -e "require('cos-nodejs-sdk-v5')"` 成_meta.json
{
"ownerId": "kn75r0rammt45k8qe5we0sh63580c5y0",
"slug": "tencent-cos-skill",
"version": "1.0.5",
"publishedAt": 1772277992256
}references/api_reference.md
# 腾讯云 COS 操作参考 本文档记录三种操作方式的详细参数定义，供执行操作时查阅。 **环境设置**：首次使用请运行 `scripts/setup.sh`，详见 `SKILL.md` 首次使用章节。 **官方文档链接：** - cos-mcp GitHub: https://github.com/Tencent/cos-mcp - COS Node.js SDK: https://www.tencentcloud.com/zh/document/product/436/8629 - COSCMD 工具: https://www.tencentcloud.com/zh/document/product/436/10976 --- ## 方式一：cos-mcp MCP 工具参数参考 ## 存储操作工具 ### getCosConfig 获取当前 COS 配置信息。 - 参数：无 ### putObject 上传本地文件到存储桶。 - `filePath` (string, **必需**): 本地文件路径（包含文件名） - `fileName` (string, 可选): 存储桶中的文件名 - `targetDir` (string, 可选): 存储桶中的目标目录 ### putString 上传字符串内容到存储桶。 - `content` (string, **必需**): 要上传的字符串内容 - `fileName` (string, **必需**): 存储桶中的文件名 - `targetDir` (string, 可选): 目标目录 - `contentType` (string, 可选): MIME 类型，默认 `text/plain` ### putBase64 上传 base64 编码内容到存储桶。 - `base64Content` (string, **必需**): base64 编码的内容 - `fileName` (string, **必需**): 存储桶中的文件名 - `targetDir` (string, 可选): 目标目录 - `contentType` (string, 可选): MIME 类型，如 `image/png`、`application/pdf` ### putBuffer 上传 buffer 内容到存储桶。 - `content` (string, **必需**): buffer 内容字符串 - `fileName` (string, **必需**): 存储桶中的文件名 - `targetDir` (string, 可选): 目标目录 - `contentType` (string, 可选): MIME 类型，默认 `application/octet-stream` - `encoding` (string, 可选): 编码格式，枚举值: `hex` | `base64` | `utf8` | `ascii` | `binary`，默认 `utf8` ### putObjectSourceUrl 通过 URL 下载文件并上传到存储桶。 - `sourceUrl` (string, **必需**): 可下载的文件 URL - `fileName` (string, 可选): 存储桶中的文件名 - `targetDir` (string, 可选): 目标目录 ### getObject 下载存储桶内的文件。 - `objectKey` (string, **必需**): 文件在存储桶中的路径 ### getBucket 查询存储桶内的文件列表。 - `Prefix` (string, 可选): 路径前缀过滤，默认根路径 ### getObjectUrl 获取文件的带签名下载链接。 - `objectKey` (string, **必需**): 文件在存储桶中的路径 ## 图片处理工具 ### imageInfo 获取图片元数据信息。 - `objectKey` (string, **必需**): 图片在存储桶中的路径 ### assessQuality 评估图片质量分数。 - `objectKey` (string, **必需**): 图片在存储桶中的路径 ### aiSuperResolution AI 超分辨率，提升图片分辨率。 - `objectKey` (string, **必需**): 图片在存储桶中的路径 ### aiPicMatting AI 智能抠图，去除图片背景。 - `objectKey` (string, **必需**): 图片在存储桶中的路径 - `width` (string, 可选): 输出宽度 - `height` (string, 可选): 输出高度 ### aiQrcode 识别存储桶内图片中的二维码内容。 - `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/qrcode.jpg` ### waterMarkFont 生成带文字水印的图片。 - `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/photo.jpg` - `text` (string, 可选): 水印文字内容（支持中文），默认 `test` ## 智能搜索工具 ### imageSearchPic 以图搜图，从数据集中检索相似图片。 - `uri` (string, **必需**): 图片地址 ### imageSearchText 文本搜图，根据文字描述检索匹配图片。 - `text` (string, **必需**): 检索文本 ## 文档与媒体处理工具 ### createDocToPdfJob 创建文档转 PDF 处理任务。 - `objectKey` (string, **必需**): 文档在存储桶中的路径 ### describeDocProcessJob 查询文档转码任务结果。 - `jobId` (string, **必需**): 任务 ID（通过提交文档任务的响应获取） ### createMediaSmartCoverJob 创建视频智能封面任务。 - `objectKey` (string, **必需**): 视频在存储桶中的路径 ### describeMediaJob 查询智能封面任务结果。 - `jobId` (string, **必需**): 任务 ID（通过提交智能封面任务的响应获取） --- ## 方式二：scripts/cos_node.mjs 命令参考 脚本位于 `scripts/cos_node.mjs`，依赖 `cos-nodejs-sdk-v5`（`npm install cos-nodejs-sdk-v5`）。 所有凭证通过环境变量读取。输出 JSON 格式。 ### 可用操作 | 操作 | 命令 | 说明 | |------|------|------| | upload | `node scripts/cos_node.mj
references/config_template.json
{
"_description": "cos-mcp MCP 服务器配置模板，添加到客户端的 MCP 配置文件中",
"mcpServers": {
"cos-mcp": {
"_comment": "方式一：参数直接传入 args",
"command": "npx",
"args": [
"cos-mcp",
"--Region=<替换为存储桶区域，如 ap-guangzhou>",
"--Bucket=<替换为存储桶名称，格式 name-appid>",
"--SecretId=<替换为腾讯云 API 密钥 ID>",
"--SecretKey=<替换为腾讯云 API 密钥 Key>",
"--DatasetName=<替换为数据万象数据集名称，无则删除此行>",
"--connectType=stdio"
]
},
"cos-mcp-env": {
"_comment": "方式二：通过 env 传递敏感参数（推荐）",
"command": "npx",
"args": [
"cos-mcp",
"--connectType=stdio"
],
"env": {
"TENCENT_COS_SECRET_ID": "<替换为腾讯云 API 密钥 ID>",
"TENCENT_COS_SECRET_KEY": "<替换为腾讯云 API 密钥 Key>",
"TENCENT_COS_REGION": "<替换为存储桶区域，如 ap-guangzhou>",
"TENCENT_COS_BUCKET": "<替换为存储桶名称，格式 name-appid>",
"TENCENT_COS_DATASET_NAME": "<替换为数据万象数据集名称，无则删除此行>"
}
},
"cos-mcp-sse": {
"_comment": "方式三：SSE 模式（适合高频调用场景）",
"command": "npx",
"args": [
"cos-mcp",
"--connectType=sse",
"--port=3001"
],
"env": {
"TENCENT_COS_SECRET_ID": "<替换为腾讯云 API 密钥 ID>",
"TENCENT_COS_SECRET_KEY": "<替换为腾讯云 API 密钥 Key>",
"TENCENT_COS_REGION": "<替换为存储桶区域，如 ap-guangzhou>",
"TENCENT_COS_BUCKET": "<替换为存储桶名称，格式 name-appid>"
}
}
},
"_参数说明": {
"Region": "存储桶区域，如 ap-guangzhou、ap-shanghai、ap-beijing 等",
"Bucket": "存储桶名称，格式为 name-appid，如 mybucket-1250000000",
"SecretId": "腾讯云 API 密钥 ID，在 访问管理 > API密钥管理 中创建",
"SecretKey": "腾讯云 API 密钥 Key，与 SecretId 配对使用",
"DatasetName": "数据万象数据集名称（仅图片搜索等智能功能需要，无则不填）",
"connectType": "连接模式：stdio（默认，推荐）或 sse",
"port": "SSE 模式下的监听端口（默认 3001）"
}
}Github ReposUpdated 1h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceUrl": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cos-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cos-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.6K downloads",
"href": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceUrl": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.5",
"href": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceUrl": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-28T11:26:32.256Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cos-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cos-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.5",
"description": "- Added scripts/setup.sh to provide automated environment checking and credential setup. - Now supports a one-command initialization: check dependencies, prompt for Tencent Cloud credentials, auto-configure all tools. - SKILL.md updated to document the setup.sh script workflow and prioritize \"first run\" self-check and guided setup. - More precise and actionable execution/order logic—explicit instructions for when and how to use mcporter, cos-mcp, SDK or coscmd. - Expanded metadata for Openclaw integration with formal install steps and required binaries.",
"href": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceUrl": "https://clawhub.ai/ShawnMinh/tencent-cos-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-28T11:26:32.256Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.