一、安装方式
你需要根据实际环境类型安装 OpenClaw，详情请参见 OpenClaw 安装方式。如果已安装 OpenClaw，可以跳过这一步。
二、获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
注意：在设置可访问范围时，如果选择“限定范围”，则需要确保勾选 Hy3。
2. 创建完成后，请你务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
三、onboard 引导
通过 OpenClaw 的 onboard 向导完成接入，适合首次配置。向导会自动完成模型注册与密钥写入。
四、1. 将模型接入 OpenClaw
打开终端，运行以下命令。
openclaw onboard –auth-choice tokenhub-api-key
根据终端显示的提示信息，依次完成相关配置，配置信息参考如下。
基础配置
| 终端提示信息 | 配置内容 |
| I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? | 选择 Yes |
| Setup mode | 选择 QuickStart注意：若你之前已配置过 OpenClaw，选择 QuickStart 后，可能会触发如下的 “Existing config detected”。请根据需求选择：沿用原有配置：选择 Use existing values 继续即可；更换或新增模型：改选 Reset，配置你想要的默认模型。 |
完成后终端信息呈现如下：
模型配置
| 终端提示信息 | 配置内容 |
| Enter Tencent TokenHub API key | 填写获取的 API Key |
| Default model | 设置为 tencent-tokenhub/hy3说明：若要配置其他模型，请将 hy3 替换为你实际要使用的模型 ID。 |
功能配置
| 终端提示信息 | 配置内容 |
| Select channel (QuickStart) | 选择 Skip for now，可以后续再进行配置。 |
| Configure skills now? (recommended) | 选择 No，可以后续再进行配置。 |
| Enable hooks? | 首次体验推荐选 Skip for now，如需记录命令审计、自动执行启动脚本等高级能力，可按 ↑/↓ 选择对应 hook 后按空格勾选。 |
| How do you want to hatch your agent? | 选择 Hatch in Terminal。 |
验证模型是否可用
完成配置后，可在终端运行以下命令，验证模型是否可用：
openclaw models list –provider tencent-tokenhub
终端输出如下信息，即配置成功，你即可以在 OpenClaw 中使用 Hy3 模型。
五、2. 非交互式快速接入
打开终端，运行以下命令（注意将 YOUR_API_KEY 修改为你的 API Key）。
注意：说明：
注意：以下命令以 macOS/Linux 为例。Windows 用户请删除所有行尾 \\ 后写在一行执行，或使用 ^ 代替 \\ 作为续行符。
openclaw onboard –non-interactive \\ –mode local \\ –auth-choice tokenhub-api-key \\ –tokenhub-api-key "YOUR_API_KEY" \\ –skip-health \\ –accept-risk
六、直接编辑配置文件
如果你不希望使用 onboard 向导（例如已有自定义配置），可直接编辑 OpenClaw 配置文件完成接入。
七、1. 打开配置文件
使用文本编辑器打开 openclaw.json 文件（若文件不存在，新建即可，内容需用 {} 包裹）。
八、2. 增加 models.providers 配置
在 openclaw.json 中增加 models.providers 配置：
·baseUrl：TokenHub 兼容 OpenAI 接口协议的 Base URL，固定为 https://tokenhub.tencentmaas.com/v1。
·<USER_API_KEY>：替换为你的 API Key。
"models": { "mode": "merge", "providers": { "tencent-tokenhub": { "baseUrl": "https://tokenhub.tencentmaas.com/v1", "apiKey": "<USER_API_KEY>", "api": "openai-completions", "models": [ { "id": "hy3", "name": "Hy3", "reasoning": true, "input": ["text"], "contextWindow": 262144, "contextTokens": 196608, "maxTokens": 131072 } ] } } }
九、3. 配置默认模型
在 openclaw.json 中修改 agents.defaults，指定默认模型 hy3。
"agents": { "defaults": { "model": { "primary": "tencent-tokenhub/hy3" }, "models": { "tencent-tokenhub/hy3": {} } } }
十、4. 使配置生效
保存文件后，OpenClaw Gateway 会自动热加载配置；如未生效，请重启 OpenClaw Gateway。
注意：说明：
十一、5. 验证
执行以下命令确认模型已注册：
openclaw models list –provider tencent-tokenhub
终端输出 Hy3 模型信息，即表示配置成功。
注意：OpenClaw 对配置文件执行严格校验，字段名或类型错误会导致 Gateway 启动失败。若配置后出现异常，可执行 openclaw doctor 查看具体问题，或执行 openclaw doctor –fix 自动修复。更多字段说明请参见 OpenClaw 配置文档。
十二、1. 思考模式
Hy3 模型支持通过 reasoning_effort 参数控制推理深度。OpenClaw 的思考级别会自动按下表映射：
| OpenClaw 思考级别 | 传入给 API 的值 | 说明 |
| off | 不传该参数 | 不启用思考，极速响应（no_think） |
| minimal | low | 快速思考（low） |
| low | low | 快速思考（low） |
| medium | low | 快速思考（low） |
| high | high | 深度推理（high） |
| xhigh | high | 深度推理（high） |
在 OpenClaw 的聊天中使用 /think low 或 /think high 指令即可切换思考模式。
十三、2. 高级配置-环境和守护进程设置
如果 Gateway 以守护进程（launchd/systemd）方式运行，请确保 YOUR_API_KEY 对该进程可用（例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供）。
自定义 Provider 方式下，API Key 直接写在配置文件里，守护进程会自动读取，具体配置方式请参见上文 配置 OpenClaw（直接编辑配置文件）。
十四、3. 相关参考文档
OpenClaw 配置文档