一、前置条件
·开通腾讯云账号，详见 注册腾讯云。
·可使用账号正常登录和使用 TI-ONE 控制台 进行操作。
二、步骤1：安装 Skill
1. 搜索 Skill
在 SkillHub 中，搜索 Skill：tencentcloud-tione-skill。
2. 选择安装方式
方式1: SkillHub 自动安装，选择“我是 Agent” 使用自然语言交互，或选择"我是 Human" 使用 CLI 交互。
·Agent 安装：
请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装 SkillHub 商店，并只安装 CLI，然后安装 tencentcloud-tione-skill 技能。
若已安装，则直接安装 tencentcloud-tione-skill 技能。
·CLI 安装：
# CLI 安装curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s — –no-skillsskillhub install tencentcloud-tione-skill
三、Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64Runtime Version: GNU bash, version 5.2.21(1)-release (x86_64-pc-linux-gnu)
·方式2: 通过 ClawHub 下载 ZIP 包，手动安装。
通过聊天上传 ZIP 文件，并@OpenClaw 助手“安装 tencentcloud-tione-skill”。
ClawHub 下载地址：Tencent Cloud TIONE – ClawHub
四、获取腾讯云 API 密钥
1. 登录 腾讯云控制台。
2. 进入 访问管理 > API 密钥管理。
3. 创建或查看 SecretId 和 SecretKey。
五、通过对话配置密钥
直接告诉 OpenClaw 助手你的 API 密钥，助手会自动配置。
@OpenClaw 助手 帮我配置 TI-ONE 的 API 凭证
TENCENTCLOUD_SECRET_ID=AKIDxxxxxxxxxxxx
TENCENTCLOUD_SECRET_KEY=xxxxxxxxxxxxxxxx
六、验证配置
在上述步骤后，助手提示配置成功。也可以 “@OpenClaw 助手 检查 TI-ONE API 凭证配置”。 助手会告知配置状态(已配置/未配置)，但不会显示密钥内容（安全保护）。
七、步骤3：使用 Skill（对话方式）
安装完成后，直接通过自然语言与助手对话即可：
| 任务类型 | 推荐的自然语言对话 |
| 查询资源组 | 帮我查一下上海地域有哪些资源组可用查询资源组 tione-test 的详细信息 |
| 查询训练任务 | 查看正在运行的训练任务查询最近创建的3个训练任务训练任务 train-xxx 的状态是什么 |
| 查询开发机 | 查看运行中的开发机开发机 nb-xxx 的 SSH 连接信息 |
| 查询在线推理服务 | 查看异常的在线服务服务组 ms-xxx 的调用统计 |
| 生成控制台链接 | 生成训练任务 train-xxx 的控制台链接给我最新创建的资源的跳转链接 |
| 查询日志和事件 | 查看训练任务 train-xxx 的日志开发机 nb-xxx 最近有什么事件 |
八、支持的地域和接口功能
支持的地域如下：
| 地域代码 | 地域名称 |
| ap-shanghai | 上海 (默认) |
| ap-beijing | 北京 |
| ap-guangzhou | 广州 |
| ap-nanjing | 南京 |
| ap-zhongwei | 中卫 |
| ap-shanghai-adc | 上海自动驾驶云 |
如需修改默认地域，可以直接通过对话告知 OpenClaw 助手地域代码或地域名称修改，例如“@OpenClaw 助手 修改 TI-ONE 默认地域为北京”或“@OpenClaw 助手 修改 TI-ONE 默认地域为 ap-beijing”；如果需查询其他地域，也可以在请求中指定地域，例如“@OpenClaw 助手 查询北京地域的训练任务”。
支持的接口功能请参见 TI-ONE Skill 接口功能列表。
九、说明与注意
1. 只读权限：此 Skill 仅支持查询操作，不支持创建/修改/删除。
2. 凭证安全：
·助手会安全保存你的 API 密钥。
·不会在对话中显示密钥内容。
·不要在公开渠道分享你的密钥。
3. 地域默认值：如未指定地域，默认使用 ap-shanghai。
4. 状态过滤：查询时优先使用状态过滤，避免全量查询。
5. 如需删除凭证：@OpenClaw 助手 删除 TI-ONE API 凭证。
十、问题1: API 调用失败 “AuthFailure”
·问题描述：查询时提示认证失败或权限错误。
·可能原因：API 凭证未配置或配置错误。
·解决方案：
@OpenClaw 助手 检查 TI-ONE API 凭证配置
如果未配置或配置错误，重新配置凭证:
@OpenClaw 助手 帮我配置 TI-ONE 的 API 凭证
TENCENTCLOUD_SECRET_ID=AKIDxxxxxxxxxxxx
TENCENTCLOUD_SECRET_KEY=xxxxxxxxxxxxxxxx
十一、问题2: 提示 “tccli: command not found” (个人环境)
·问题描述：脚本执行时提示找不到 tccli 命令。
·可能原因：环境中未安装腾讯云 CLI 工具。
注意：说明：
注意：OpenClaw 沙箱环境已预装 tccli，个人环境或自建容器可能需要手动安装。
·解决方案:
方式1: 手动安装：pip3 install tccli
方式2: 让助手帮你安装：@OpenClaw 助手 安装 tccli
十二、问题3: 提示 “jq: command not found” (个人环境)
·问题描述：脚本执行时提示找不到 jq 命令。
·可能原因：环境中未安装 JSON 解析工具。
注意：说明：
注意：OpenClaw 沙箱环境已预装 jq，个人环境或自建容器可能需要手动安装。
·解决方案：根据你使用的操作系统，选择以下命令安装：
Ubuntu/Debian：apt install jq
macOS：brew install jq
或者让助手帮你安装：@OpenClaw 助手 安装 jq 工具。