腾讯云COS技能 ☁️

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

✨ 核心功能

🗂️ 云存储操作

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

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

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

🔍 智能搜索

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

📄 文档处理

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

🔧 安装配置

1. 安装依赖

bash

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

2. 配置环境变量

bash

# 设置腾讯云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 中添加:

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"
        }
      }
    }
  }
}

📖 使用指南

基础文件操作

code

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

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

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

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

图片处理

code

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

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

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

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

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

智能搜索

code

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

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

文档处理

code

# 文档转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: 批量上传图片并处理

code

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

示例2: 智能图片库管理

code

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

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

code

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

⚙️ 高级配置

自定义MCP服务器配置

json

{
  "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
  }
}

多环境支持

bash

# 开发环境
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. 数据安全

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

🐛 故障排除

常见问题

•
认证失败
- •检查SecretId和SecretKey是否正确
- •确认密钥是否有对应存储桶的权限
- •验证密钥是否过期
•
连接超时
- •检查网络连接
- •确认区域配置是否正确
- •增加超时时间设置
•
权限不足
- •检查存储桶权限设置
- •确认操作是否在允许范围内
- •使用具有足够权限的密钥

调试模式

bash

# 启用详细日志
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

问题反馈

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

贡献指南

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

•Fork项目仓库
•创建功能分支
•提交更改
•创建Pull Request

📄 许可证

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

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