name: tccli
description:
腾讯云命令行工具速查手册。通过命令行方式管理和操作腾讯云 200+ 云产品资源，
支持实例查询、启动、停止、域名解析等功能。当用户提到腾讯云、tccli、CVM、
Lighthouse、DNSPod、VPC、SSL 证书等腾讯云服务操作时触发。
metadata:
openclaw:
emoji: ☁️
requires:
bins:
- tccli
TCCLI - 腾讯云命令行工具
通过命令行管理腾讯云资源
简介
TCCLI（Tencent Cloud Command Line Interface）是腾讯云官方提供的命令行工具，支持管理 200+ 云产品。
安装
pip3 install tccli
配置
# 配置密钥（只需一次）
tccli configure set secretId <your-secret-id>
tccli configure set secretKey <your-secret-key>
tccli configure set region ap-guangzhou
常用服务速查
云服务器 (CVM)
| 操作 |
命令 |
| 查看实例列表 |
tccli cvm DescribeInstances |
| 查看实例状态 |
tccli cvm DescribeInstancesStatus |
| 查看可用区 |
tccli cvm DescribeZones |
| 查看地域 |
tccli cvm DescribeRegions |
| 查看镜像 |
tccli cvm DescribeImages |
| 启动实例 |
tccli cvm StartInstances --InstanceIds '["ins-xxxxx"]' |
| 停止实例 |
tccli cvm StopInstances --InstanceIds '["ins-xxxxx"]' |
| 重启实例 |
tccli cvm RebootInstances --InstanceIds '["ins-xxxxx"]' |
轻量应用服务器 (Lighthouse)
| 操作 |
命令 |
| 查看实例列表 |
tccli lighthouse DescribeInstances |
| 查看套餐 |
tccli lighthouse DescribeBundles |
| 查看镜像 |
tccli lighthouse DescribeBlueprints |
| 查看防火墙规则 |
tccli lighthouse DescribeFirewallRules |
| 创建防火墙规则 |
tccli lighthouse CreateFirewallRules --InstanceId ins-xxxxx --FirewallRules '[{"Protocol":"TCP","Port":"80","Action":"ACCEPT"}]' |
SSL 证书
| 操作 |
命令 |
| 查看证书列表 |
tccli ssl DescribeCertificates |
| 查看证书详情 |
tccli ssl DescribeCertificate --CertificateId xxx |
| 下载证书 |
tccli ssl DownloadCertificate --CertificateId xxx |
| 部署证书 |
tccli ssl DeployCertificateInstance ... |
DNSPod (域名解析)
| 操作 |
命令 |
| 查看域名列表 |
tccli dnspod DescribeDomainList |
| 查看域名详情 |
tccli dnspod DescribeDomain --Domain example.com |
| 查看记录列表 |
tccli dnspod DescribeRecordList --Domain example.com |
| 创建记录 |
tccli dnspod CreateRecord --Domain example.com --RecordType A --RecordLine 默认 --Value 1.2.3.4 |
私有网络 (VPC)
| 操作 |
命令 |
| 查看 VPC 列表 |
tccli vpc DescribeVpcs |
| 查看子网列表 |
tccli vpc DescribeSubnets |
| 查看安全组 |
tccli vpc DescribeSecurityGroups |
| 查看安全组规则 |
tccli vpc DescribeSecurityGroupPolicies --SecurityGroupId sg-xxxxx |
域名注册
| 操作 |
命令 |
| 查看域名列表 |
tccli domain DescribeDomainNameList |
| 检查域名 |
tccli domain CheckDomain --DomainName example.com |
| 查看价格 |
tccli domain DescribeDomainPriceList |
云监控 (Monitor)
| 操作 |
命令 |
| 查看指标数据 |
tccli monitor GetMonitorData |
| 查看告警策略 |
tccli monitor DescribeAlarmPolicies |
输出格式
# JSON 格式（默认）
tccli cvm DescribeInstances
# 表格格式
tccli cvm DescribeInstances --output table
# 文本格式
tccli cvm DescribeInstances --output text
帮助命令
# 查看所有服务
tccli help
# 查看服务详情
tccli cvm help
tccli ssl help
tccli lighthouse help
# 查看具体接口
tccli cvm DescribeInstances help
常用参数
| 参数 |
说明 |
示例 |
--Region |
指定地域 |
--Region ap-shanghai |
--output |
输出格式 |
--output table |
--filter |
过滤结果 |
--filter 'Instances[0].InstanceId' |
--cli-unfold-argument |
展开参数 |
用于复杂嵌套参数 |
使用示例
获取第一个实例的公网 IP
tccli cvm DescribeInstances --filter 'Instances[0].PublicIpAddresses[0]'
查看所有运行中的实例
tccli cvm DescribeInstances --Filters '[{"Name":"instance-state","Values":["RUNNING"]}]'
批量查询多个实例
tccli cvm DescribeInstances --InstanceIds '["ins-xxx1","ins-xxx2"]' --output table
完整服务列表
TCCLI 支持 200+ 云服务，常用包括：
| 服务代码 |
服务名称 |
| cvm |
云服务器 |
| lighthouse |
轻量应用服务器 |
| vpc |
私有网络 |
| ssl |
SSL 证书 |
| dnspod |
DNS 解析 |
| domain |
域名注册 |
| cdn |
内容分发网络 |
| cls |
日志服务 |
| cos |
对象存储 |
| monitor |
云监控 |
| cam |
访问管理 |
| cdb |
云数据库 MySQL |
| redis |
云数据库 Redis |
| mongodb |
云数据库 MongoDB |
| tke |
容器服务 |
| scf |
云函数 |
安全注意事项
- 最小权限原则：配置的 API 密钥应仅授予所需的最小权限，避免使用主账号密钥
- 密钥保护：不要在共享终端、日志、截图或代码仓库中暴露 secretId / secretKey
- 写操作确认：执行变更类命令（启停实例、修改防火墙、部署证书、创建 DNS 记录等）前，务必确认目标账号、地域、资源 ID 和操作意图
- 区域确认：执行写操作前确认
--Region 参数正确，避免误操作其他地域的资源
参考文档
By