云 API 云 API Skill 使用说明

什么是云 API Skill
云 API Skill 是面向腾讯云 API 的智能技能（Skill），可运行于支持 Agent Skills 规范 的各类 AI 智能体中。安装该 Skill 后，您可以通过自然语言对话完成腾讯云资源的查询与管理，无需记忆 API 名称和参数格式。
Skill 是智能体按需加载的指令与资料集合。当您向智能体描述一个云资源操作需求时，智能体会自动匹配并加载云 API Skill，检索对应的 API 文档，构造正确的调用命令并执行。整个过程对您透明，您只需用自然语言表达意图即可。
核心能力
能力
说明
全产品覆盖
支持腾讯云全部已接入 API 的云产品，包括 CVM、CBS、VPC 等。
自动 API 检索
根据自然语言描述，自动定位云产品、检索接口、读取参数文档。
各类操作均支持
支持查询、创建、修改、删除等全部操作类型。
注意：
涉及资源创建、修改、删除等操作可能产生费用或数据丢失，建议在执行前仔细确认操作内容。
准备工作
使用云 API Skill 前，需要完成 TCCLI（腾讯云命令行工具）的安装与凭证配置。
1. 安装 TCCLI
TCCLI 是腾讯云官方命令行工具，云 API Skill 通过它执行所有 API 调用。
快速安装（pip）：
pip install tccli
安装完成后，执行以下命令验证：
tccli --version
更多安装方式（Homebrew、源码安装等）及详细说明，请参考 安装 TCCLI。
2. 配置凭证
TCCLI 需要腾讯云账号授权才能调用 API。推荐使用浏览器授权登录，安全便捷，无需手动填写密钥：
tccli auth login
执行后，终端会输出授权链接并自动打开浏览器。在浏览器中完成腾讯云账号登录和授权后，凭证将自动写入本地。若浏览器未自动打开，请手动复制终端中的链接到浏览器打开。验证凭证是否生效：
tccli cvm DescribeRegions
如果返回了地域列表，说明配置成功。更多凭证配置方式，请参考以下文档：
﻿TCCLI 配置方法：交互模式、命令行模式、环境变量等多种配置方式。
﻿通过浏览器授权获取凭证：浏览器登录授权的详细操作流程。
﻿凭证管理：永久密钥、临时密钥、实例角色等多种凭证类型说明。
说明：
请勿在对话中直接向智能体提供密钥，统一使用浏览器授权登录或其他安全方式配置凭证。更多安全建议请参考下方 注意事项。
安装 Skill
云 API Skill 遵循 Agent Skills 规范，支持在各类兼容的 AI 智能体中安装使用。
下载地址
Skill 主页： tencentcloud-api-skill﻿
安装方式
方式一：命令行一键安装（推荐）
使用 ClawHub CLI 在终端中一键安装：
# NPX（无需提前安装）
npx clawhub@latest install tencentcloud-api-skill
﻿
# 或使用 PNPM
pnpm dlx clawhub@latest install tencentcloud-api-skill
﻿
# 或使用 Bun
bunx clawhub@latest install tencentcloud-api-skill
如果您已安装 OpenClaw CLI，也可以使用：
openclaw skills install tencentcloud-api-skill
方式二：OpenClaw Prompt Flow 引导安装
将以下提示词粘贴到 OpenClaw 中，按引导完成安装：
Install the skill "tencentcloud-api-skill" (tencent-adm/tencentcloud-api-skill) from ClawHub.
Skill page: https://clawhub.ai/tencent-adm/tencentcloud-api-skill
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.
方式三：直接下载
如果以上方式不适用，可在 Skill 主页直接下载 Skill 文件，并将文件放到您所使用智能体平台约定的 Skills 目录下即可完成安装。常见平台的目录约定如下：
平台
Skills 目录
WorkBuddy
.workbuddy/skills/
CodeBuddy
.codebuddy/skills/
Cursor
.cursor/skills/
Claude Code
.claude/skills/
使用方式
安装并配置完成后，您可以直接用自然语言向智能体描述云资源操作需求。以下是典型使用场景。
场景一：查询云服务器实例
描述：帮我看看广州地域有哪些云服务器
智能体会自动调用 CVM 的 DescribeInstances 接口，返回广州地域的实例列表，包括实例 ID、名称、规格、IP 地址、运行状态等信息。
场景二：查询可用地域
描述：查看所有可用地域
智能体会调用 DescribeRegions 接口，返回当前账号可使用的地域列表。
更多对话示例
您的描述
匹配的云产品与接口
查看我的云硬盘列表
CBS — DescribeDisks
查看 SSL 证书列表
SSL — DescribeCertificates
列出所有 CAM 子用户
CAM — ListUsers
说明：
如果您不确定某个需求对应哪个云产品或接口，直接用自然语言描述即可，智能体会自动检索匹配。
注意事项
项目
说明
操作风险
创建操作可能产生费用，修改和删除操作可能导致数据丢失或服务中断，且部分操作不可撤销（例如按量付费实例的销毁是立即生效且不可恢复的）。建议操作前先通过查询接口确认目标资源状态，高风险操作（如批量删除、销毁实例）建议明确要求智能体先列出方案再执行
凭证安全
Skill 不会索要、存储或泄露您的 SecretId / SecretKey。请勿在对话中直接向智能体提供密钥，统一使用浏览器授权登录或其他安全方式配置凭证。建议使用权限最小化的子账号凭证，避免使用主账号
地域参数
大多数云产品 API 需要指定地域（如 ap-guangzhou、ap-shanghai）。CAM、Account、DNSPod 等全局类产品可省略
参数格式
复合类型参数使用标准 JSON 格式，如 --Placement '{"Zone":"ap-guangzhou-6"}'，智能体会自动处理

能力	说明
全产品覆盖	支持腾讯云全部已接入 API 的云产品，包括 CVM、CBS、VPC 等。
自动 API 检索	根据自然语言描述，自动定位云产品、检索接口、读取参数文档。
各类操作均支持	支持查询、创建、修改、删除等全部操作类型。

平台	Skills 目录
WorkBuddy	`.workbuddy/skills/`
CodeBuddy	`.codebuddy/skills/`
Cursor	`.cursor/skills/`
Claude Code	`.claude/skills/`

您的描述	匹配的云产品与接口
查看我的云硬盘列表	CBS — DescribeDisks
查看 SSL 证书列表	SSL — DescribeCertificates
列出所有 CAM 子用户	CAM — ListUsers

项目	说明
操作风险	创建操作可能产生费用，修改和删除操作可能导致数据丢失或服务中断，且部分操作不可撤销（例如按量付费实例的销毁是立即生效且不可恢复的）。建议操作前先通过查询接口确认目标资源状态，高风险操作（如批量删除、销毁实例）建议明确要求智能体先列出方案再执行
凭证安全	Skill 不会索要、存储或泄露您的 SecretId / SecretKey。请勿在对话中直接向智能体提供密钥，统一使用浏览器授权登录或其他安全方式配置凭证。建议使用权限最小化的子账号凭证，避免使用主账号
地域参数	大多数云产品 API 需要指定地域（如 `ap-guangzhou`、`ap-shanghai`）。CAM、Account、DNSPod 等全局类产品可省略
参数格式	复合类型参数使用标准 JSON 格式，如 `--Placement '{"Zone":"ap-guangzhou-6"}'`，智能体会自动处理

云 API Skill 使用说明

本页目录：

什么是云 API Skill

核心能力

准备工作

1. 安装 TCCLI

2. 配置凭证

安装 Skill

下载地址

安装方式

方式一：命令行一键安装（推荐）

方式二：OpenClaw Prompt Flow 引导安装

方式三：直接下载

使用方式

场景一：查询云服务器实例

场景二：查询可用地域

更多对话示例

注意事项