# Send Tencent Cloud CVM to your agent
Use the source page and any available docs to guide the install because the item requires authentication or permission before the package can be fetched.
## Fast path
- Open the source page via Open source page.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item requires authentication or permission before the package can be fetched. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item requires authentication or permission before the package can be fetched. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tencentcloud-cvm-skill",
    "name": "Tencent Cloud CVM",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/GardenChan/tencentcloud-cvm-skill",
    "canonicalUrl": "https://clawhub.ai/GardenChan/tencentcloud-cvm-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/tencentcloud-cvm-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tencentcloud-cvm-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "assets/create-instance-template.json",
      "scripts/common.sh",
      "scripts/query/describe-images.sh",
      "scripts/query/describe-zones.sh",
      "scripts/query/describe-instances.sh"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "tencentcloud-cvm-skill",
      "status": "auth_required",
      "reason": "login_required",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-09T20:59:52.336Z",
      "expiresAt": "2026-05-12T20:59:52.336Z",
      "httpStatus": 403,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tencentcloud-cvm-skill",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tencentcloud-cvm-skill",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "tencentcloud-cvm-skill"
      },
      "scope": "item",
      "summary": "Item requires authentication.",
      "detail": "This item appears to require sign-in or permission before the package can be fetched. Open the source page and confirm access manually.",
      "primaryActionLabel": "Open source page",
      "primaryActionHref": "https://clawhub.ai/GardenChan/tencentcloud-cvm-skill"
    },
    "validation": {
      "installChecklist": [
        "Sign in or confirm the required access before retrying the download.",
        "Review SKILL.md after authentication succeeds.",
        "Treat this source as manual setup until the package can be fetched directly."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tencentcloud-cvm-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/tencentcloud-cvm-skill",
    "agentUrl": "https://openagent3.xyz/skills/tencentcloud-cvm-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tencentcloud-cvm-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tencentcloud-cvm-skill/agent.md"
  }
}
```
## Documentation

### 腾讯云 CVM 运维工具

基于 Bash + tccli 的腾讯云 CVM 云服务器运维工具集，支持实例创建、资源查询、服务器运维三大核心功能。

### 1. 安装依赖

# tccli（腾讯云命令行工具）
pip3 install tccli

# jq（JSON 解析）
brew install jq        # macOS
apt install jq         # Ubuntu

# sshpass（SSH 密码认证，运维操作需要）
brew install hudochenkov/sshpass/sshpass   # macOS
apt install sshpass                         # Ubuntu

### 2. 配置凭证

export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"

### 3. 典型工作流

# 1. 查询资源准备创建实例
./scripts/query/describe-zones.sh                    # 查可用区
./scripts/query/describe-images.sh --platform Ubuntu # 查镜像
./scripts/query/describe-vpcs.sh                     # 查 VPC

# 2. 创建实例（密码自动保存）
./scripts/lifecycle/create-instance.sh \\
  --zone ap-guangzhou-3 \\
  --instance-type S5.MEDIUM2 \\
  --image-id img-xxx \\
  --vpc-id vpc-xxx \\
  --subnet-id subnet-xxx \\
  --sg-id sg-xxx

# 3. 更新实例 IP
./scripts/utils/update-instance-ip.sh --instance-id ins-xxx --auto

# 4. 运维操作（只需 instance-id）
./scripts/ops/ssh-connect.sh --instance-id ins-xxx
./scripts/ops/system-info.sh --instance-id ins-xxx

### 功能模块

scripts/
├── lifecycle/    # 实例生命周期：创建、启动、停止、重启、销毁
├── query/        # 资源查询：实例、镜像、VPC、子网、安全组、可用区
├── ops/          # 服务器运维：SSH、远程执行、系统信息、磁盘、进程、服务、日志、安全、传输、网络
├── utils/        # 辅助工具：密码管理、IP 更新、配置查看
└── common.sh     # 公共函数库

### 实例生命周期

脚本功能示例recommend-instance.sh场景推荐创建--scene blog-smallcreate-instance.sh手动创建实例--zone ap-guangzhou-3 --instance-type S5.MEDIUM2start-instance.sh启动实例--instance-id ins-xxxstop-instance.sh停止实例--instance-id ins-xxx [--force]reboot-instance.sh重启实例--instance-id ins-xxxterminate-instance.sh销毁实例--instance-id ins-xxx

场景推荐

根据使用场景自动推荐配置：

./scripts/lifecycle/recommend-instance.sh --scene blog-small    # 个人博客
./scripts/lifecycle/recommend-instance.sh --scene web-medium    # 中型Web应用
./scripts/lifecycle/recommend-instance.sh --list-scenes         # 查看所有场景

场景适用配置blog-small个人博客 (日PV<5K)1核1Gblog-medium中型博客 (日PV 5K-50K)2核4Gweb-small小型Web (日PV<10K)2核2Gweb-medium中型Web (日PV 10K-100K)4核8Gapi-small小型API (QPS<100)2核4Gdev开发测试2核2Gdatabase-small小型数据库2核4G + 50G数据盘

### 资源查询

脚本功能常用参数describe-regions.sh查询地域--availabledescribe-instances.sh查询实例--instance-id, --namedescribe-zones.sh查询可用区--regiondescribe-instance-types.sh查询机型--zone, --family, --typedescribe-images.sh查询镜像--instance-type, --platformdescribe-vpcs.sh查询 VPC--vpc-iddescribe-subnets.sh查询子网--vpc-id, --zonedescribe-security-groups.sh查询安全组--sg-id, --name

### 服务器运维

优先级策略：运维操作优先使用 ops 脚本（SSH + 密码直连执行），仅在脚本无法满足需求时才使用 tccli 接口调用。
安全限制：ops 目录仅使用已有的预定义脚本，不支持动态生成新脚本。
重要原则：运维写操作（如停止、重启、销毁实例，服务管理，文件传输等）需要人工确认后执行。
所有运维脚本只需 --instance-id 即可自动获取密码和 IP

脚本功能特殊参数ssh-connect.shSSH 连接--portremote-exec.sh远程命令（仅支持预定义安全命令）--cmd <command>system-info.sh系统信息-disk-usage.sh磁盘检查--threshold <n>process-monitor.sh进程监控--top <n>, --filterservice-manage.sh服务管理--service, --actionlog-viewer.sh日志查看--file, --lines, --followsecurity-check.sh安全检查-file-transfer.sh文件传输--upload/--download, --local, --remotenetwork-check.sh网络检查--target

remote-exec 安全命令集

remote-exec.sh 仅支持以下预定义的只读命令或 ops 目录下的脚本：

分类命令用途系统信息uptime系统运行时间和负载uname -a内核和系统信息hostname主机名cat /etc/os-release操作系统版本date系统时间timedatectl时区和时间同步状态CPUcat /proc/loadavg系统负载top -bn1 | head -20CPU 和进程概览mpstatCPU 使用统计nprocCPU 核数lscpuCPU 详细信息内存free -h内存使用情况cat /proc/meminfo内存详细信息vmstat虚拟内存统计磁盘df -h磁盘使用情况df -iinode 使用情况lsblk块设备列表fdisk -l磁盘分区信息du -sh <path>目录大小进程ps aux进程列表ps aux | head -20前 20 个进程pgrep <name>按名称查找进程pidof <name>获取进程 PID网络ip addr网络接口信息ip route路由表netstat -tlnpTCP 端口监听ss -tlnp套接字统计ping -c 4 <host>网络连通性测试curl -I <url>HTTP 头信息dig <domain>DNS 解析traceroute <host>路由追踪服务systemctl status <service>服务状态systemctl is-active <service>服务是否运行systemctl list-units --type=service服务列表日志tail -n 100 <logfile>查看日志末尾head -n 100 <logfile>查看日志开头journalctl -u <service> -n 100服务日志dmesg | tail -50内核日志安全who当前登录用户w用户活动last -n 20登录历史cat /etc/passwd用户列表cat /etc/group用户组列表其他env环境变量crontab -l定时任务列表docker psDocker 容器列表docker imagesDocker 镜像列表scripts/ops/*.shops 目录下的预定义运维脚本

### 辅助工具

脚本功能show-defaults.sh查看当前配置get-password.sh获取实例密码update-instance-ip.sh更新实例 IPmanage-passwords.sh管理密码存储

### 环境变量

变量说明默认值TENCENTCLOUD_SECRET_IDAPI 密钥 ID必需TENCENTCLOUD_SECRET_KEYAPI 密钥 Key必需TENCENT_CVM_DEFAULT_REGION默认地域ap-guangzhouTENCENT_CVM_DEFAULT_ZONE默认可用区-TENCENT_CVM_DEFAULT_INSTANCE_TYPE默认机型-TENCENT_CVM_DEFAULT_IMAGE_ID默认镜像-TENCENT_CVM_DEFAULT_VPC_ID默认 VPC-TENCENT_CVM_DEFAULT_SUBNET_ID默认子网-TENCENT_CVM_DEFAULT_SG_ID默认安全组-TENCENT_CVM_DEFAULT_DISK_SIZE系统盘大小20TENCENT_CVM_DEFAULT_CHARGE_TYPE计费类型POSTPAID_BY_HOUR

### 支持的地域

ap-beijing | ap-shanghai | ap-guangzhou | ap-chengdu | ap-nanjing | ap-hongkong

### 支持的镜像平台

TencentOS | CentOS | Ubuntu | Debian

### SSH 登录用户名

系统默认用户名示例Ubuntuubuntussh ubuntu@<ip>其他 Linux (TencentOS, CentOS, Debian)rootssh root@<ip>

### 密码存储

创建实例时自动生成密码并保存到 ~/.tencent_cvm_passwords（权限 600）：

{
  "ins-xxx": {
    "password": "aB3#xK9$mN2@pQ",
    "host": "1.2.3.4",
    "region": "ap-guangzhou",
    "created_at": "2026-02-06 15:30:00"
  }
}

管理命令：

./scripts/utils/manage-passwords.sh --list              # 列出所有
./scripts/utils/manage-passwords.sh --show ins-xxx      # 查看详情
./scripts/utils/manage-passwords.sh --delete ins-xxx    # 删除记录

### 安全说明

本工具集设计用于可信环境下的服务器运维，遵循以下安全原则：

预定义脚本：仅执行 scripts/ 目录下已审核的预定义脚本，禁止动态生成或执行任意代码
人工确认：所有写操作（停止、重启、销毁、文件传输等）必须经人工确认后执行
凭证安全：密码文件 ~/.tencent_cvm_passwords 权限为 600，仅限本地用户访问
操作审计：所有操作均有日志输出，便于追溯
使用场景：适用于开发测试环境，生产环境建议配合堡垒机使用

### 参考

腾讯云 CVM API 文档
tccli 使用指南
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: GardenChan
- Version: 1.0.2
## Source health
- Status: auth_required
- Item requires authentication.
- This item appears to require sign-in or permission before the package can be fetched. Open the source page and confirm access manually.
- Health scope: item
- Reason: login_required
- Checked at: 2026-05-09T20:59:52.336Z
- Expires at: 2026-05-12T20:59:52.336Z
- Recommended action: Open source page
## Links
- [Detail page](https://openagent3.xyz/skills/tencentcloud-cvm-skill)
- [Send to Agent page](https://openagent3.xyz/skills/tencentcloud-cvm-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/tencentcloud-cvm-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/tencentcloud-cvm-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/tencentcloud-cvm-skill)