📦 1 — 技能工具

v1.0.0

Skill to call Cloud API for Tencent Cloud (腾讯云). Used for cloud automation or resource management.

0· 109·0 当前·0 累计
by @2513483494 (Tencent CloudQ Team)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/9
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
This skill is an instruction-only helper for the Tencent Cloud CLI (tccli); its requirements and instructions match the stated purpose and do not request unrelated credentials or privileged system access.
评估建议
This skill is an instructions-only helper for the official Tencent Cloud CLI and appears coherent. Before installing or running anything: (1) verify you really want to install tccli and inspect the tccli PyPI/GitHub project and version referenced; (2) run pip/homebrew install commands as a non-root user and review what will be installed; (3) be aware `tccli auth login` launches a local port and requires you to complete a browser OAuth flow—do not paste secrets into chat or into the agent; (4) co...
详细分析 ▾
用途与能力
The name/description indicate a Tencent Cloud CLI helper and the SKILL.md only instructs using tccli, installing it, and using its auth flow. There are no unrelated required env vars, binaries, or config paths requested.
指令范围
Runtime instructions are limited to installing/using tccli, calling Tencent Cloud APIs, and consulting documentation via curl. The skill explicitly warns not to ask users for SecretId/SecretKey and describes the browser OAuth flow (tccli auth login). It does not instruct reading unrelated files or exfiltrating data to unexpected endpoints.
安装机制
There is no automated install spec in the bundle (instruction-only). SKILL.md recommends installing tccli via pip, Homebrew, or from GitHub. These are expected for a CLI helper, but pip/Homebrew will download and install code on the host—verify package origin/version and avoid running installs as root when possible.
凭证需求
The skill declares no required environment variables or primary credential. It relies on tccli's normal credential files (e.g., default.credential) written by tccli auth login, which is appropriate for this purpose.
持久化与权限
The skill does not request always:true and is user-invocable. The only persistent effect described is tccli writing credential files via its normal auth flow, which is expected and scoped to Tencent Cloud credentials.
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/9

- Initial release of the "tcapi" skill for interacting with Tencent Cloud APIs via tccli. - Added reference documentation files: references/auth.md, references/install.md, references/refs.md. - Removed obsolete script: scripts/ensue-api.sh. - Provides guidance for installation, authentication, API usage, and secure practices. - Includes examples for command syntax, parameter formatting, and API documentation lookup. - Emphasizes security: never request or expose user credentials.

无害

安装命令

点击复制
官方npx clawhub@latest install 1123
镜像加速npx clawhub@latest install 1123 --registry https://cn.longxiaskill.com

技能文档

统一使用 tccli 调用腾讯云 API,如 tccli 未安装,参考 references/install.md 进行安装。

# 调用 API

基本形式

tccli   [--param value ...] [--region <地域>]

常用示例

# 查询 CVM 地域
tccli cvm DescribeRegions

# 查询实例(需指定地域) tccli cvm DescribeInstances --region ap-guangzhou

地域:多数产品需传 --region(如 ap-guangzhou);全局接口(如 cam、account、dnspod、domain、ssl、ba、tag)可省略。

参数规则

  • 非简单类型参数必须为标准 JSON,例如:--Placement '{"Zone":"ap-guangzhou-2"}'
  • 创建类接口示例(按需替换参数):
  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 ...
  

避免并行调用

tccli 当前并行调用存在配置文件竞争问题,导致会导致响应失败。当前请先一个个接口调用。

# 用户凭证

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

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

凭证授权原理,以及多用户凭证的使用方法,参考 references/auth.md

安全红线:严禁向用户索要 SecretId/SecretKey,也拒绝任何有可能打印凭证的操作(尤其是 tccli configure list)。

# 获取 API 帮助信息

通过 curl + grep 检索业务、接口、最佳实践、数据结构。

发现业务

检索 tccli 服务名(如 cvm、cbs)。

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

参考输出:

cvm | 云服务器 | 2017-03-12 | ...

发现最佳实践

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

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

检索接口

若最佳实践未覆盖,在业务接口列表中检索(接口名即 tccli 的 <Action>)。

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

阅读接口文档

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

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

阅读数据结构

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

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

数据来源ClawHub ↗ · 中文优化:龙虾技能库