OpenClaw 接入 UniKey 教程
本教程面向第一次使用 OpenClaw 的用户，带你在不使用 Dashboard 的情况下接入 UniKey API。UniKey 兼容 OpenAI API 格式，因此请在 OpenClaw 新手引导中选择 OpenAI-compatible Provider。
开始前，请先在 UniKey 创建 API Key。请妥善保管：不要把 Key 提交到 Git、发送到公开聊天、写入前端代码或放进截图。
需要填写的信息
| 设置项 | 值 |
|---|---|
| Provider ID | unikey |
| API 格式 | OpenAI-compatible / OpenAI Completions |
| Base URL | https://www.getunikey.ai/v1 |
| API Key | 你的 UniKey API Key |
| 推荐主模型 | gpt-5.2 |
| 可选备用模型 | claude-sonnet-4-6 |
Base URL 后面不要追加 /chat/completions。OpenClaw 会自行补充接口路径。
1. 用官方安装脚本安装 OpenClaw
请以 OpenClaw 官方文档为准，查看最新系统要求和平台说明：OpenClaw 官方安装文档。
推荐使用官方安装脚本。这是最快的方式：脚本会检测操作系统、在需要时安装 Node.js、安装 OpenClaw，并启动新手引导。因此你不需要提前手动安装 Node.js。
macOS、Linux 或 WSL2
打开终端，执行：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell
打开 PowerShell，执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
说明： Windows 桌面用户还可以安装原生 Windows Hub 配套应用，其中包括设置、托盘状态、聊天、节点模式和本地 MCP 模式。
只安装，暂不运行新手引导
仅当你确定要稍后自行配置时，才使用以下命令。安装完成后，请手动执行 openclaw onboard，再继续下一节。
macOS、Linux 或 WSL2：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows PowerShell：
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
2. 在新手引导中配置 UniKey
安装脚本通常会自动打开新手引导。如果你跳过或关闭了它，执行：
openclaw onboard
当 OpenClaw 询问模型 Provider 配置时，按下表选择或填写。不同版本的选项文字可能略有不同，请选择 OpenAI-compatible 或 custom OpenAI-compatible API，不要选择 OpenAI OAuth，也不建议使用 Dashboard 配置。
| 新手引导中的问题 | 选择或填写内容 |
|---|---|
| Provider 类型 | OpenAI-compatible / custom OpenAI-compatible |
| Provider ID 或名称 | unikey |
| Base URL | https://www.getunikey.ai/v1 |
| API Key | 你的 UniKey API Key |
| API 协议 | 如果询问，请选择 OpenAI Completions |
| 主模型 | gpt-5.5 |
| 备用模型 | 如需备用模型，填写 claude-sonnet-4-6 |
新手引导询问是否安装或启动 Gateway 时，请允许它执行。这是推荐路径，因为 OpenClaw 会按当前安装版本写入正确的配置格式。
3. 验证配置是否成功
如果提示找不到 openclaw 命令，先关闭并重新打开终端，再执行：
openclaw --version
openclaw models status
openclaw gateway status
openclaw models status 应显示 unikey/gpt-5.2 等 UniKey 模型；openclaw gateway status 应显示 Gateway 正在运行。
在你已配置的 OpenClaw 聊天渠道中发送一条测试消息，例如：
请只回复：UniKey 连接成功。
模型正常返回内容，即说明 OpenClaw 已通过 UniKey API 跑通。
常见问题
| 现象 | 处理方式 |
|---|---|
openclaw: command not found | 关闭并重新打开终端，再执行 openclaw --version；仍失败时重新运行官方安装脚本。 |
| Gateway 没有运行 | 执行 openclaw gateway restart，再执行 openclaw gateway status。 |
| 401 或 unauthorized | 重新执行 openclaw onboard 并粘贴 UniKey API Key，检查是否漏字符或多了空格。 |
| 404 或找不到模型 | 换成你的 UniKey 账户可用的模型，然后执行 openclaw models status。 |
| 429 或 Credits 不足 | 检查 UniKey 余额、用量限制和限流情况。 |
| 跳过了引导，或需要一份可直接使用的配置 | 查看 OpenClaw 手动配置参考。 |