tencentcloud-cos-skill – OpenClaw Skill

---

name: tencentcloud-cos-skill description: 腾讯云对象存储(COS)和数据万象(CI)集成 - 基于官方MCP服务器的Clawdbot技能 metadata: { "openclaw": { "emoji": "☁️", "homepage": "https://github.com/Tencent/cos-mcp", "requires": { "bins": ["node", "npx"], "env": ["TENCENT_COS_SECRET_ID", "TENCENT_COS_SECRET_KEY"], "config": ["tencent-cos.enabled"] }, "primaryEnv": "TENCENT_COS_SECRET_ID", "install": [ { "id": "npm", "kind": "node", "package": "cos-mcp", "bins": ["cos-mcp"], "label": "安装腾讯云COS MCP服务器 (npm)" } ] } }

腾讯云COS技能 ☁️

基于腾讯云官方 cos-mcp MCP服务器的Clawdbot技能，提供完整的腾讯云对象存储(COS)和数据万象(CI)能力。

✨ 核心功能

🗂️ 云存储操作

• 文件上传: 上传本地文件到COS存储桶
• 文件下载: 从COS下载文件到本地
• 文件列表: 查看存储桶中的文件
• 文件管理: 删除、复制、移动文件

🖼️ 图片处理 (数据万象CI)

• 图片信息: 获取图片元数据
• 质量评估: 评估图片质量分数
• 超分辨率: AI提升图片分辨率
• 智能抠图: 自动去除图片背景
• 二维码识别: 识别图片中的二维码
• 文字水印: 添加文字水印到图片

🔍 智能搜索

• 以图搜图: 上传图片搜索相似图片
• 文本搜图: 用文字描述搜索相关图片

📄 文档处理

• 文档转换: 支持多种格式转PDF
• 视频处理: 视频封面生成、截帧

🔧 安装配置

1. 安装依赖

# 安装腾讯云COS MCP服务器
npm install -g cos-mcp@latest

2. 配置环境变量

# 设置腾讯云COS认证信息
export TENCENT_COS_SECRET_ID="AKIDxxxxxxxxxxxxxxxxxxxxxxxx"
export TENCENT_COS_SECRET_KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TENCENT_COS_REGION="ap-guangzhou"
export TENCENT_COS_BUCKET="your-bucket-name-123456"

3. Clawdbot配置

在 ~/.openclaw/openclaw.json 中添加:

{
  "skills": {
    "entries": {
      "tencent-cos": {
        "enabled": true,
        "env": {
          "TENCENT_COS_SECRET_ID": "AKIDxxxxxxxxxxxxxxxxxxxxxxxx",
          "TENCENT_COS_SECRET_KEY": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "TENCENT_COS_REGION": "ap-guangzhou",
          "TENCENT_COS_BUCKET": "your-bucket-name-123456"
        }
      }
    }
  }
}

📖 使用指南

基础文件操作

# 上传文件到COS
上传文件到腾讯云COS: /path/to/local/file.jpg

# 从COS下载文件
从腾讯云COS下载文件: cos-file-key.jpg

# 列出COS文件
列出腾讯云COS存储桶中的文件

# 获取文件信息
获取COS文件信息: file-key.jpg

图片处理

# 评估图片质量
评估图片质量: image.jpg

# 提升图片分辨率
提升图片分辨率: low-res-image.jpg

# 去除图片背景
去除图片背景: portrait.jpg

# 识别二维码
识别二维码图片: qrcode.jpg

# 添加文字水印
添加水印到图片: original.jpg 文字: "公司机密"

智能搜索

# 文本搜索图片
搜索相关图片: 风景照片

# 图片搜索相似图片
搜索相似图片: reference.jpg

文档处理

# 文档转PDF
转换文档为PDF: document.docx

# 生成视频封面
生成视频封面: video.mp4

🛠️ 工具列表

存储操作工具

工具名	描述	参数示例
cos_upload	上传文件到COS	local_path, cos_key
cos_download	从COS下载文件	cos_key, local_path
cos_list	列出COS文件	prefix, max_keys
cos_delete	删除COS文件	cos_key
cos_get_url	获取文件URL	cos_key, expires

图片处理工具

工具名	描述	参数示例
cos_image_info	获取图片信息	cos_key
cos_assess_quality	评估图片质量	cos_key
cos_super_resolution	超分辨率处理	cos_key
cos_remove_background	去除背景	cos_key
cos_detect_qrcode	识别二维码	cos_key
cos_add_watermark	添加文字水印	cos_key, text

搜索工具

工具名	描述	参数示例
cos_search_by_image	以图搜图	cos_key
cos_search_by_text	文本搜图	text

文档工具

工具名	描述	参数示例
cos_convert_to_pdf	文档转PDF	cos_key
cos_generate_video_cover	生成视频封面	cos_key

🚀 快速开始示例

示例1: 批量上传图片并处理

1. 上传图片文件夹到COS
2. 对每张图片进行质量评估
3. 自动优化低质量图片
4. 添加统一水印
5. 生成处理报告

示例2: 智能图片库管理

1. 上传新图片到COS
2. 自动提取图片特征
3. 建立智能索引
4. 支持自然语言搜索
5. 按需生成不同尺寸

示例3: 文档自动化流水线

1. 接收各种格式文档
2. 统一转换为PDF
3. 存储到COS指定目录
4. 生成访问链接
5. 发送处理通知

⚙️ 高级配置

自定义MCP服务器配置

{
  "tencent_cos": {
    "mcp_server": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--Region=${TENCENT_COS_REGION}",
        "--Bucket=${TENCENT_COS_BUCKET}",
        "--SecretId=${TENCENT_COS_SECRET_ID}",
        "--SecretKey=${TENCENT_COS_SECRET_KEY}",
        "--connectType=stdio"
      ]
    },
    "timeout": 30000,
    "retry_attempts": 3
  }
}

多环境支持

# 开发环境
export TENCENT_COS_ENV="development"
export TENCENT_COS_BUCKET="dev-bucket-123456"

# 生产环境  
export TENCENT_COS_ENV="production"
export TENCENT_COS_BUCKET="prod-bucket-123456"

🔒 安全最佳实践

1. 密钥管理

• 使用环境变量存储密钥，不要硬编码
• 定期轮换访问密钥
• 使用子账号密钥，遵循最小权限原则

2. 访问控制

• 设置存储桶访问权限
• 使用临时密钥进行敏感操作
• 启用操作日志审计

3. 数据安全

• 启用服务器端加密
• 敏感数据单独存储
• 定期备份重要数据

🐛 故障排除

常见问题

1. 认证失败

   • 检查SecretId和SecretKey是否正确
   • 确认密钥是否有对应存储桶的权限
   • 验证密钥是否过期

2. 连接超时

   • 检查网络连接
   • 确认区域配置是否正确
   • 增加超时时间设置

3. 权限不足

   • 检查存储桶权限设置
   • 确认操作是否在允许范围内
   • 使用具有足够权限的密钥

调试模式

# 启用详细日志
export TENCENT_COS_DEBUG="true"

# 查看MCP服务器日志
cos-mcp --Region=ap-guangzhou --Bucket=test --SecretId=test --SecretKey=test --connectType=sse --port=3001

📞 支持与贡献

官方资源

• 腾讯云COS文档: https://cloud.tencent.com/document/product/436
• cos-mcp GitHub: https://github.com/Tencent/cos-mcp
• MCP协议文档: https://modelcontextprotocol.io

问题反馈

1. 技能使用问题: 在Clawdbot社区反馈
2. COS功能问题: 联系腾讯云技术支持
3. MCP协议问题: 查看MCP官方文档

贡献指南

欢迎提交Pull Request改进这个技能：

1. Fork项目仓库
2. 创建功能分支
3. 提交更改
4. 创建Pull Request

📄 许可证

本技能基于腾讯云cos-mcp项目，遵循BSD-3许可证。

---

最后更新: 2026-02-02 版本: 1.0.0

腾讯云COS Clawdbot技能 ☁️

基于腾讯云官方 cos-mcp MCP服务器的Clawdbot技能，提供完整的腾讯云对象存储(COS)和数据万象(CI)能力集成。

✨ 特性

🗂️ 核心功能

• 文件管理: 上传、下载、列出、删除COS文件
• 图片处理: 质量评估、超分辨率、智能抠图、二维码识别
• 智能搜索: 以图搜图、文本搜图
• 文档处理: 文档转PDF、视频封面生成
• 批量操作: 支持批量上传、下载、处理

🚀 技术优势

• 官方集成: 基于腾讯云官方cos-mcp MCP服务器
• 标准协议: 完全兼容MCP (Model Context Protocol)
• 易于使用: 简单的配置和直观的命令
• 安全可靠: 支持环境变量加密和访问控制
• 高性能: 支持大文件分片上传和并发处理

📦 安装

快速安装

# 1. 克隆或下载本技能
git clone <repository-url>
cd tencent-cos

# 2. 运行安装脚本
chmod +x install.sh
./install.sh

手动安装

# 1. 安装腾讯云COS MCP服务器
npm install -g cos-mcp@latest

# 2. 配置环境变量
cp config/env.template .env
# 编辑 .env 文件，填入您的腾讯云COS配置

# 3. 配置Clawdbot
# 将 config/clawdbot_config.json 合并到 ~/.openclaw/openclaw.json

⚙️ 配置

环境变量配置

在 .env 文件中配置：

# 腾讯云COS配置
export TENCENT_COS_REGION="ap-guangzhou"
export TENCENT_COS_BUCKET="your-bucket-name-123456"
export TENCENT_COS_SECRET_ID="AKIDxxxxxxxxxxxxxxxxxxxxxxxx"
export TENCENT_COS_SECRET_KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TENCENT_COS_DATASET_NAME="your-dataset"  # 可选，用于智能搜索
export TENCENT_COS_DEBUG="false"

Clawdbot配置

在 ~/.openclaw/openclaw.json 中添加：

{
  "skills": {
    "entries": {
      "tencent-cos": {
        "enabled": true,
        "env": {
          "TENCENT_COS_REGION": "ap-guangzhou",
          "TENCENT_COS_BUCKET": "your-bucket-name-123456",
          "TENCENT_COS_SECRET_ID": "AKIDxxxxxxxxxxxxxxxxxxxxxxxx",
          "TENCENT_COS_SECRET_KEY": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      }
    }
  }
}

📖 使用指南

基础命令

在Clawdbot中直接使用自然语言命令：

# 文件操作
上传文件到腾讯云COS: /path/to/local/file.jpg
从腾讯云COS下载文件: cos-file-key.jpg
列出腾讯云COS存储桶中的文件
删除COS文件: file-to-delete.jpg

# 图片处理
评估图片质量: image.jpg
提升图片分辨率: low-res-image.jpg
去除图片背景: portrait.jpg
识别二维码: qrcode-image.jpg
添加水印到图片: original.jpg 文字: "公司机密"

# 智能搜索
搜索相关图片: 风景照片
搜索相似图片: reference-image.jpg

# 文档处理
转换文档为PDF: document.docx
生成视频封面: video.mp4

Python API

from scripts.cos_wrapper import TencentCOSWrapper

# 初始化
cos = TencentCOSWrapper()

# 上传文件
result = cos.upload_file('local.jpg', 'remote/key.jpg')

# 下载文件
result = cos.download_file('remote/key.jpg', 'local_copy.jpg')

# 列出文件
result = cos.list_files(prefix='images/')

# 图片处理
result = cos.assess_image_quality('image.jpg')
result = cos.enhance_image_resolution('image.jpg')
result = cos.remove_image_background('portrait.jpg')

# 智能搜索
result = cos.search_by_text('风景照片')
result = cos.search_by_image('reference.jpg')

命令行工具

# 上传文件
python3 scripts/cos_wrapper.py --action upload --local-path file.jpg --cos-key remote/key.jpg

# 下载文件
python3 scripts/cos_wrapper.py --action download --cos-key remote/key.jpg --local-path local.jpg

# 列出文件
python3 scripts/cos_wrapper.py --action list --prefix images/

# 搜索图片
python3 scripts/cos_wrapper.py --action search-text --text "风景照片"

🎯 使用场景

场景1: 自动化文件备份

# 自动备份工作目录到COS
import os
from scripts.cos_wrapper import TencentCOSWrapper

cos = TencentCOSWrapper()
backup_dir = '/path/to/backup'

for file in os.listdir(backup_dir):
    if file.endswith('.txt') or file.endswith('.pdf'):
        local_path = os.path.join(backup_dir, file)
        cos_key = f'backups/{file}'
        cos.upload_file(local_path, cos_key)
        print(f"已备份: {file}")

场景2: 图片处理流水线

# 批量处理产品图片
cos = TencentCOSWrapper()

# 1. 上传原始图片
cos.upload_file('product.jpg', 'raw/product.jpg')

# 2. 评估质量
quality = cos.assess_image_quality('raw/product.jpg')

# 3. 提升分辨率（如果质量较低）
if quality.get('score', 0) < 80:
    cos.enhance_image_resolution('raw/product.jpg')

# 4. 添加水印
cos.add_text_watermark('raw/product.jpg', '品牌名称')

# 5. 存储到最终位置
print("图片处理完成")

场景3: 智能图片库

# 建立智能图片搜索系统
cos = TencentCOSWrapper()

# 上传新图片
cos.upload_file('new_photo.jpg', 'gallery/photo1.jpg')

# 建立搜索索引（自动通过MCP服务器完成）
# 用户可以通过自然语言搜索
search_results = cos.search_by_text('蓝天白云')
print(f"找到 {len(search_results.get('results', []))} 张相关图片")

🏗️ 架构设计

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Clawdbot      │    │   本技能        │    │ 腾讯云COS MCP   │
│                 │    │                 │    │   服务器        │
│  ┌───────────┐  │    │  ┌───────────┐  │    │  ┌───────────┐  │
│  │  用户命令  │──┼───▶│  │ Python    │──┼───▶│  │  cos-mcp  │  │
│  │           │  │    │  │ 包装器     │  │    │  │  进程     │  │
│  └───────────┘  │    │  └───────────┘  │    │  └───────────┘  │
│                 │    │                 │    │        │        │
└─────────────────┘    └─────────────────┘    └────────┼────────┘
                                                       │
                                                ┌──────▼──────┐
                                                │  腾讯云COS  │
                                                │    API      │
                                                └─────────────┘

🔧 开发指南

项目结构

tencent-cos/
├── SKILL.md                 # 技能主文档
├── README.md               # 项目README
├── install.sh              # 安装脚本
├── scripts/
│   └── cos_wrapper.py      # Python包装器
├── examples/
│   └── basic_usage.py      # 使用示例
├── config/
│   ├── template.json       # 配置模板
│   └── env.template        # 环境变量模板
└── LICENSE                 # 许可证文件

扩展功能

要添加新功能，可以：

1. 扩展Python包装器:

   class TencentCOSWrapper:
       def new_feature(self, params):
           # 实现新功能
           return self._call_mcp_tool('newTool', params)
   

2. 添加新的MCP工具: 需要修改cos-mcp服务器配置，添加新的工具定义

3. 创建新的使用示例: 在examples目录中添加新的示例文件

📊 性能优化

大文件处理

• 支持分片上传（默认5MB分片）
• 并发上传/下载
• 断点续传

缓存策略

• 本地文件缓存
• URL签名缓存
• 搜索结果缓存

错误处理

• 自动重试机制
• 详细的错误日志
• 优雅降级

🔒 安全建议

密钥管理

• 使用环境变量存储密钥
• 定期轮换访问密钥
• 使用子账号密钥，遵循最小权限原则

访问控制

• 设置存储桶访问权限
• 使用临时密钥进行敏感操作
• 启用操作日志审计

数据安全

• 启用服务器端加密
• 敏感数据单独存储
• 定期备份重要数据

🐛 故障排除

常见问题

1. 认证失败

   错误: 检查SecretId和SecretKey是否正确
   解决方案: 重新生成密钥并更新配置
   

2. 网络连接问题

   错误: 连接超时或网络错误
   解决方案: 检查网络连接，确认区域配置正确
   

3. 权限不足

   错误: 操作被拒绝
   解决方案: 检查存储桶权限和密钥权限
   

调试模式

# 启用详细日志
export TENCENT_COS_DEBUG="true"

# 查看MCP服务器日志
cos-mcp --Region=ap-guangzhou --Bucket=test --SecretId=test --SecretKey=test --connectType=sse --port=3001

🤝 贡献指南

欢迎贡献代码、报告问题或提出建议！

贡献流程

1. Fork本仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启Pull Request

开发环境

# 设置开发环境
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 运行测试
python3 -m pytest tests/

📄 许可证

本项目基于BSD-3许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 腾讯云COS团队: 提供优秀的对象存储服务
• cos-mcp开发者: 创建了优秀的MCP服务器
• OpenClaw社区: 提供了优秀的AI助手平台
• 所有贡献者: 感谢你们的支持和贡献

📞 支持

• 问题反馈: 在GitHub Issues中报告问题
• 功能请求: 在GitHub Discussions中提出建议
• 文档问题: 提交Pull Request修复文档

---

最后更新: 2026-02-02 | 版本: 1.0.0

享受腾讯云COS带来的便捷存储体验吧！ 🚀