腾讯云网站部署

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install tencentcloud-deploy-web
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 tencentcloud-deploy-web。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

此 Openclaw Skills 智能体可自动处理腾讯云网站运维实务，涵盖 DNSPod、EdgeOne CDN、SSL 证书、Lighthouse 服务器、防火墙和 TAT 远程执行。它面向非技术用户：智能体负责处理 API 工作流程，而用户通过引导式人工介入卡片完成注册、实名认证、付款、ICP备案及其他敏感的控制台任务。
此技能支持网站上线、DNS 更改、CDN 配置、服务器配置、证书管理、故障排查和持续运维。它使用跨平台 Python 标准库脚本，无需 tccli；采用严格的权限边界，在变更前验证凭证和资源，并在修改 DNS 或基础设施前创建备份。

应用场景

使用 EdgeOne 或 Lighthouse 服务器在腾讯云部署新网站。
使用 DNSPod 将域名指向现有 Pages、Vercel 或自托管源站。
选择合适的 EdgeOne 区域或香港服务器，改善中国大陆访客的网站访问体验。
配置 SSL 证书、HTTPS 源站、CDN 缓存以及部署后的缓存刷新。
检查或开放 Lighthouse 防火墙端口，并通过 TAT 执行服务器命令，无需用户提供 SSH 私钥。
诊断凭证、身份、服务权限、DNS 记录、服务器连接或部署就绪情况。
查询域名是否可用，并向用户展示由其手动完成的购买、续费、付款或 ICP 备案操作。
安全管理长期腾讯云运维，在消费、不可逆操作和敏感身份流程中要求人工批准。

工作原理

运行只读 doctor 检查，查看已存储凭证、账户身份、服务权限和下一项必需操作。
如果尚未配置腾讯云访问权限，则在浏览器中启动本地设置向导。用户私下输入凭证，向导验证后再保存。
确认账户使用合适的子用户凭证，且未使用禁止的根账户密钥。
根据访客位置、ICP备案状态、源站类型以及网站是否需要后端基础设施，选择部署路径：仅 DNS、EdgeOne 或 Lighthouse。
将所有需要人工完成的任务汇总为可执行卡片，包括注册、实名认证、付款、购买域名、ICP备案或不可逆的控制台操作。
通过腾讯云 API 执行已批准的操作；必要时为区域性 Lighthouse 和 TAT 服务明确指定区域。
在执行破坏性或修改性操作前，备份当前 DNS、EdgeOne 或服务器配置。
按需配置 DNSPod 记录、EdgeOne 区域和源站、SSL、Lighthouse 防火墙规则及服务器软件。
通过 API 响应、外部连通性检查、服务器端 curl 请求或多地点测试验证结果，而非仅依赖本地 DNS 或受 proxy 影响的结果。
以通俗语言报告结果、可访问 URL、用户待办事项和后续检查，不暴露原始机密、JSON 错误或不必要的云术语。

配置指南

此技能可在 Windows、macOS 和 Linux 上运行，使用 Python 标准库。无需 tccli。许多 macOS 和 Linux 系统使用 python3，Windows 使用 python 或 py。
如果 Windows 上没有 Python，请使用以下命令安装：
winget install -e --id Python.Python.3.12 --accept-source-agreements --accept-package-agreements
在 macOS 上，使用系统开发者工具或 Homebrew：
xcode-select --install
brew install python
首次访问
先运行只读健康检查：
python {baseDir}/scripts/doctor.py
如果尚未配置访问权限，请启动本地凭证向导：
python {baseDir}/scripts/setup.py
向导会打开本地浏览器页面，验证凭证和策略配置，并将生成的配置文件保存在本地。如果浏览器未自动打开，请向用户提供显示的 SETUP_URL。对于远程智能体环境，请参阅 references/human-cards.md 中的 C0 远程设置指南。
可选环境变量包括 TENCENTCLOUD_SECRET_ID、TENCENTCLOUD_SECRET_KEY、TENCENTCLOUD_SESSION_TOKEN 和 TC_PROFILE。默认配置文件为 agent-ops；凭证通常保存在 ~/.tccli/
.credential，绝不能打印或发送到腾讯云 API 之外的地方。
核心工具
python {baseDir}/scripts/tcapi.py Key=value Key:=JSON --region
python {baseDir}/scripts/run_on_server.py --instance ""
python {baseDir}/scripts/run_on_server.py --instance --file
字符串使用 Key=value，数字、数组或对象使用 Key:=JSON。设置工作流程要求用户自行完成付款、注册、实名认证、ICP备案及其他只能在控制台进行的操作。

数据架构

凭证和配置文件
数据 位置或格式 用途
腾讯云配置文件 ~/.tccli/
.credential 技能脚本使用的本地存储凭证
活动配置文件 TC_PROFILE，默认为 agent-ops 选择凭证和区域配置
会话令牌 可选环境变量 支持临时腾讯云凭证
区域 配置文件设置或 --region 控制区域性 Lighthouse 和 TAT API 调用；全局服务包括 DNSPod、EdgeOne、SSL 和域名 API
运维文件
scripts/setup.py：基于本地浏览器的引导、验证、策略设置和凭证存储。
scripts/doctor.py：只读诊断输出，包含服务检查和机器可读的 next 操作。
scripts/tcapi.py：通用腾讯云 API 客户端，支持字符串和 JSON 参数处理。
scripts/run_on_server.py：通过 TAT 以 root 权限执行远程命令，无需用户 SSH 私钥。
scripts/tc_error.py：将 API 失败归类为 kind 和 action 响应。
./tc-backup/.json：更改或删除 DNS 记录、EdgeOne 区域或服务器配置前必须导出的状态备份。
references/routes.md：部署路径逻辑和交付模板。
references/human-cards.md：人工介入步骤的标准化用户操作卡片。
references/agent-ops-policy.json：允许和禁止的操作边界。
references/sources.md：带日期的参考资料、测试结果和运维知识来源。
元数据分类
账户状态：引导、凭证有效性、身份、子用户状态和权限。
部署路径：R0 域名购买、R1 仅 DNS、R2 静态网站使用 EdgeOne，或 R3 后端工作负载使用 Lighthouse。
交付限制：中国大陆访客、ICP备案状态、海外加速、香港托管和源站类型。
基础设施服务：DNSPod、EdgeOne、SSL、Lighthouse、防火墙和 TAT。
安全类别：只读、可撤销更改、需要用户批准、付款相关、隐私敏感或不可逆。
验证状态：API 已确认、已进行外部测试、等待传播或需要用户完成。

高级特性

人工介入工作流卡片提供直接控制台链接、预计耗时、费用说明、明确的复选框和清晰的用户批准暂停点。
严格的最小权限边界允许 DNSPod、EdgeOne、Lighthouse、SSL 和 TAT 操作，同时拒绝付款、购买、续费、破坏性服务器操作、域名删除或转移，以及敏感的实名认证数据访问。
本地凭证引导通过浏览器向导完成，采用先验证再保存的机制、CSP 限制、无外部跟踪，并且不会通过聊天交换机密。
通用腾讯云 API 访问支持任意服务和操作、明确的区域路由、JSON 参数及结构化错误分类。
基于 TAT 的 root 命令执行无需用户 SSH 私钥，并支持内联命令和脚本文件。
修改前创建 JSON 备份，保护 DNS 记录、CDN 区域和服务器配置。
部署路由会考虑 ICP 备案、中国大陆可访问性、EdgeOne 加速区域、香港 Lighthouse 托管，以及静态或后端工作负载。
验证综合使用 API 读取、权威 DNS 记录查询、服务器端 curl 检查、防火墙检查和外部多地点测试。
EdgeOne 专项处理包括部分 CNAME 区域、在线状态轮询、HTTPS 443 源站配置、证书配置顺序、缓存刷新和刷新后的内容验证。
使用通俗语言报告，隐藏不必要的 API 和基础设施行话，同时保留诊断与自动化所需的机器可读 JSON 输出。

name: tencentcloud-deploy-web description: Turns the agent into a non-technical user's long-term Tencent Cloud ops assistant (腾讯云运维) that deploys websites and manages DNSPod records, SSL certificates, EdgeOne CDN and Lighthouse servers. Use when the user wants to put a site online on Tencent Cloud, point a domain at it, or fix slow access from mainland China. 帮不懂技术的用户在腾讯云上线网站、配置域名解析与证书、改善国内访问速度；密钥通过本机网页向导录入、不经过对话，花钱、实名、备案等操作交给用户本人完成。 homepage: https://claw-school.com