OpenClaw 接入 UniKey 小白教程
本教程从一台干净电脑开始，带你把 OpenClaw 配置为通过 UniKey OpenAI 兼容 API 调用模型。
UniKey 中转站基于 NewAPI 搭建，因此在 OpenClaw 里应按 OpenAI 兼容 Provider 配置：
Base URL: https://www.getunikey.ai/v1
API Key: 你的 UniKey API Key
Model: claude-sonnet-4-6 或 gpt-5.2
1. 安装 Node.js
OpenClaw 需要较新的 Node.js。推荐 Node.js 24，Node.js 22.14+ 也可以。
macOS
如果你使用 Homebrew：
brew install node
node -v
npm -v
Linux
使用你的发行版包管理器或 NodeSource 安装。安装后验证：
node -v
npm -v
Windows
从 Node.js 官方网站下载安装包。安装完成后打开 PowerShell 验证：
node -v
npm -v
如果提示找不到 node，关闭并重新打开 PowerShell。
2. 安装 OpenClaw
按 OpenClaw 当前官方安装方式安装。安装完成后验证 CLI：
openclaw --version
Windows PowerShell：
openclaw --version
3. 初始化 OpenClaw
运行 onboarding：
openclaw onboard --install-daemon
如果你的 OpenClaw 版本把 daemon 安装拆开了，再运行：
openclaw gateway install
openclaw gateway restart
然后检查状态：
openclaw gateway status
4. 创建 UniKey API Key
- 打开
https://www.getunikey.ai/。 - 登录账号。
- 进入 API Key 或 Token 页面。
- 创建新的 API Key。
- 复制后保存到密码管理器或本地密钥管理工具。
不要把 API Key 发到公开聊天、Git 提交、前端代码或截图里。
5. 配置 Provider
OpenClaw 本地配置文件路径如下：
| 系统 | 文件路径 |
|---|---|
| macOS | ~/.openclaw/openclaw.json |
| Linux | ~/.openclaw/openclaw.json |
| Windows | %USERPROFILE%\.openclaw\openclaw.json |
推荐使用 Dashboard 配置：
- 打开 OpenClaw Dashboard：
http://127.0.0.1:18789/。 - 进入模型或 Provider 设置区域。
- 添加 OpenAI-compatible 或 custom OpenAI Provider。
- 填入：
| 字段 | 值 |
|---|---|
| Provider name | unikey |
| Base URL | https://www.getunikey.ai/v1 |
| API key | 你的 UniKey API Key |
| Default model | claude-sonnet-4-6 或 gpt-5.2 |
保存后，OpenClaw 会把最终 JSON 结构写入 openclaw.json。
6. 重启并测试
重启 Gateway：
openclaw gateway restart
openclaw gateway status
如果你的 OpenClaw CLI 支持模型切换，可以执行：
openclaw models set unikey/claude-sonnet-4-6
再次打开 Dashboard：
http://127.0.0.1:18789/
新建一个 Agent 或 Chat 任务，发送：
Say one sentence confirming that OpenClaw is using UniKey.
如果模型正常回复，说明 OpenClaw 已经通过 UniKey API 跑通。
常见问题
| 现象 | 检查项 |
|---|---|
找不到 openclaw 命令 | 重新打开终端，确认 OpenClaw 安装路径已加入 PATH。 |
找不到 node 命令 | 重新安装 Node.js，并重新打开终端。 |
| Gateway 未安装 | 运行 openclaw gateway install，再运行 openclaw gateway restart。 |
| 401 unauthorized | 检查 UniKey API Key 是否复制完整，前后是否多了空格。 |
| 404 model not found | 通过 /v1/models 或 UniKey 模型列表选择当前账户可用模型。 |
| 429 或 Credits 不足 | 检查 UniKey 用量、限流和 AI Credits 余额。 |
| Dashboard 修改后 CLI 切换失效 | 打开 ~/.openclaw/openclaw.json 或 Windows 对应路径，确认 Dashboard 当前选中的模型。 |