Xpersona
agentCLAWHUBUnverified

tencentcloud-api-skill

Skill to call Cloud API for Tencent Cloud (腾讯云). Used for cloud automation or resource management. 当用户需要查询、创建、管理腾讯云资源，或执行云 API 自动化操作时触发。 Skill: tencentcloud-api-skill Owner: tencent-adm Summary: Skill to call Cloud API for Tencent Cloud (腾讯云). Used for cloud automation or resource management. 当用户需要查询、创建、管理腾讯云资源，或执行云 API 自动化操作时触发。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-04-27T08:13:14.862Z | auto - Initial public release of 腾讯云 API 助手 (tcapi skill) for cloud resource management and automation using tccli. - Supports querying, creating, modify

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.2k

Updated

Oct 11, 2026

Version

1.0.3

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/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 Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.2K downloadsadoption · observed Oct 11, 2026
Latest release
1.0.3release · observed Apr 27, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:tencentcloud-api-skill
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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-tencent-adm-tencentcloud-api-skill/snapshot"

Documentation

CLAWHUB

39,470 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: tcapi
display_name: 腾讯云 API 助手
description: Skill to call Cloud API for Tencent Cloud (腾讯云). Used for cloud automation or resource management. 当用户需要查询、创建、管理腾讯云资源，或执行云 API 自动化操作时触发。
version: 1.0.0
tags: [tccli, cloud-api, tencent-cloud, automation]
keywords: [腾讯云, tccli, cloud api, 云资源, 云管理, 自动化运维]
prompt_template: 对 {service} 产品执行 {action} 操作
examples:
  - 查询广州地域的 CVM 实例
  - 创建一台按量计费的云服务器
  - 查看 COS 存储桶列表
---

# 腾讯云 API 助手

统一使用 **tccli** 命令行工具调用腾讯云 API，实现云资源的查询、创建、修改、删除等操作。

## 适用场景

- 云资源查询与管理（CVM / COS / CBS / VPC / TKE 等 200+ 产品）
- 自动化运维（批量操作、定时任务、脚本编排）
- 云 API 接口探索与文档检索

## 不适用场景

- 不支持 Terraform / Pulumi 等 IaC 编排工具
- 不做多云管理（仅限腾讯云）
- 不做费用充值、账号注册等非 API 操作

## 前置条件

- 已安装 tccli，未安装参考 [references/install.md](references/install.md)
- 已完成凭证配置（详见下方「Step 2 凭证配置」）

## 核心原则

> **优先检索最佳实践 → 再查接口文档 → 最后调用 API**。不要跳过文档检索直接调用，避免用错接口或遗漏参数。

---

# 执行流程

## Step 1：检索 API 文档

调用前先通过 curl + grep 检索业务、接口、最佳实践、数据结构。参考 [references/refs.md](references/refs.md) 获取完整检索方式。

### 1.1 发现业务

检索 tccli 服务名（如 cvm、cbs）。

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/services.md | grep 云服务器
```

参考输出：

```
[cvm](service/cvm/index.md) | 云服务器 | 2017-03-12 | ...
```

### 1.2 发现最佳实践

优先检索是否有匹配当前场景的最佳实践。

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/practices.md | grep 重装
```

### 1.3 检索接口

若最佳实践未覆盖，在业务接口列表中检索（接口名即 tccli 的 `<Action>`）。

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/actions.md | grep "扩容\|磁盘"
```

### 1.4 阅读接口文档

获取参数说明和支持的地域信息：

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/action/ResizeInstanceDisks.md
```

### 1.5 阅读数据结构

文档中涉及的数据结构可进一步查看：

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/model/SystemDisk.md
```

## Step 2：凭证配置

如果已经提供了凭证，tccli 可以正常调用。

如缺少凭证，执行 tccli 会提示 "secretId is invalid"。应执行 `tccli auth login` 进行浏览器授权登录，等待回调后继续（命令会起本地端口、阻塞进程，直到浏览器 OAuth 完成并回调）。

凭证授权原理，以及多用户凭证的使用方法，参考 [references/auth.md](references/auth.md)。

**安全红线**：严禁向用户索要 SecretId/SecretKey，也拒绝任何有可能打印凭证的操作（尤其是 `tccli configure list`）。

## Step 3：调用 API

**基本形式**：

```sh
tccli <service> <Action> [--param value ...] [--region <地域>]
```

**输入参数**：

| 参数 | 类型 | 必填 | 说明 |
|:-----|:-----|:-----|:-----|
| `service` | string | 是 | 产品标识，如 `cvm`、`cbs`、`vpc`。通过 Step 1.1 检索获取 |
| `Action` | string | 是 | 接口名，如 `DescribeInstances`、`RunInstances`。通过 Step 1.3 检索获取 |
| `--region` | string | 视接口 | 地域，如 `ap-guangzhou`。多数产品必传；全局接口（cam、account、dnspod、domain、ssl、ba、tag）可省略 |
| `--param value` | 各类型 | 视接口 | 接口参数，简单类型直接传值，复杂类型传 JSON 字符串 |

**常用示例**：

```sh
# 查询 CVM 地域
tccli cvm DescribeRegions

# 查询实例（需指定地域）
tccli cvm DescribeInstances --region ap-guangzhou
```

**参数规则**：

- 非简单类型参数必须为标准 JSON，例如：`--Placement '{"Zone":"ap-guangzhou-2"}'`。
- 创建类接口示例（按需替换参数）：
  ```sh
  tccli cvm RunInstances --InstanceChargeType POSTPAID_BY_HOUR \
    --Placement '{"Zone":"ap-guangzhou-2"}' --InstanceType S1.SMALL1 --ImageId img-xxx \
    --SystemDisk '{"DiskType":"CLOUD_BASIC","DiskSize":50}' --InstanceCount 1 ...

_meta.json

{
  "ownerId": "kn77cw5hbmapf54rv89jdqwp7x835m4k",
  "slug": "tencentcloud-api-skill",
  "version": "1.0.3",
  "publishedAt": 1777277594862
}

references/auth.md

# 配置 TCCLI（凭证）

**推荐：浏览器授权登录**，无需手填 SecretId/SecretKey，登录成功后凭证会自动写入本地。

```sh
tccli auth login
```

执行后 TCCLI 会在本机起一个临时端口，并打印 OAuth 授权链接；通常也会自动用默认浏览器打开该链接。用户在浏览器中完成登录与授权后，腾讯云会回调到该本地端口，TCCLI 收到回调即写入凭证并退出。若浏览器未自动打开，请将终端里打印的链接复制到浏览器中打开。成功后会提示「登录成功, 密钥凭证已被写入: ...」，可用 `tccli cvm DescribeRegions` 验证。

**Agent 场景**：当 Agent 通过工具执行 `tccli auth login` 时，该命令会**一直阻塞**直到用户完成浏览器登录（或超时）。Agent 应明确告知用户：「请打开终端/工具输出中显示的授权链接，在浏览器中完成登录；完成后该命令会自动结束。」

**多账户与登出**

- 默认账户凭证保存在 `default.credential`。指定账户名：`tccli auth login --profile user1`，凭证写入 `user1.credential`。
- 登出默认账户：`tccli auth logout`；登出指定账户：`tccli auth logout --profile user1`。

references/install.md

# 安装 TCCLI

**前提**：系统已安装 Python 2.7+ 与 pip。TCCLI 依赖 TencentCloudApi Python SDK，安装时会自动处理依赖。

**安装方式**：

```sh
# 方式一：pip（推荐，Windows / Mac / Linux 通用）
pip install tccli

# 若从 3.0.252.3 以下版本升级，需先卸载再装：
# pip uninstall tccli jmespath && pip install tccli

# 方式二：macOS Homebrew
brew tap tencentcloud/tccli
brew install tccli
# 更新：brew upgrade tccli

# 方式三：源码安装
# git clone https://github.com/TencentCloud/tencentcloud-cli.git && cd tencentcloud-cli && python setup.py install
```

验证安装：

```sh
tccli --version
```

references/refs.md

# 信息库检索步骤与示例

通过 curl + grep 检索业务、接口、最佳实践、数据结构。入口与结构见 SKILL.md「信息库」节。

## 发现业务

确定对应的 tccli 服务名（如 cvm、cbs）。

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/services.md | grep 云服务器
```

参考输出：

```
[cvm](service/cvm/index.md) | 云服务器 | 2017-03-12 | ...
```

## 检索业务最佳实践

优先检索是否有匹配当前场景的最佳实践。

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/practices.md | grep 重装
```

## 检索接口

若最佳实践未覆盖，在业务接口列表中检索（接口名即 tccli 的 &lt;Action&gt;）。

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/actions.md | grep "扩容\|磁盘"
```

## 阅读接口文档

确认参数、地域、版本（tccli 一般自动匹配版本）：

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/action/ResizeInstanceDisks.md
```

## 阅读数据结构

文档中涉及的数据结构可进一步查看：

```sh
curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/model/SystemDisk.md
```

Related agents

Same protocol, similar job.

Github ReposUpdated 1d 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/tencent-adm/skills/tencentcloud-api-skill",
      "sourceUrl": "https://clawhub.ai/tencent-adm/skills/tencentcloud-api-skill",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T00:29:51.255Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentcloud-api-skill/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentcloud-api-skill/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T00:29:51.255Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/tencent-adm/tencentcloud-api-skill",
      "sourceUrl": "https://clawhub.ai/tencent-adm/tencentcloud-api-skill",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T00:29:51.255Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.3",
      "href": "https://clawhub.ai/tencent-adm/tencentcloud-api-skill",
      "sourceUrl": "https://clawhub.ai/tencent-adm/tencentcloud-api-skill",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-27T08:13:14.862Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentcloud-api-skill/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentcloud-api-skill/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.3",
      "description": "- Initial public release of 腾讯云 API 助手 (tcapi skill) for cloud resource management and automation using tccli. - Supports querying, creating, modifying, and deleting resources across 200+ Tencent Cloud products via Cloud API. - Provides step-by-step guidance for API documentation retrieval, credential configuration, and API invocation. - Emphasizes security best practices: no secret collection, least-privilege principle, and output validation. - Details error handling, usage scenarios, limitations, and examples for frequent cloud operations.",
      "href": "https://clawhub.ai/tencent-adm/tencentcloud-api-skill",
      "sourceUrl": "https://clawhub.ai/tencent-adm/tencentcloud-api-skill",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-27T08:13:14.862Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to tencentcloud-api-skill and adjacent AI workflows.