跳到主要内容

OpenClaw 手动配置参考

仅当你跳过了新手引导、新手引导没有保存 UniKey Provider，或需要恢复一份确认可用的配置时使用本页。新安装用户请优先查看 OpenClaw 接入 UniKey 教程。

本页提供完整、可复制粘贴的 openclaw.json 标准文件内容。你只需要把 PASTE_YOUR_UNIKEY_API_KEY_HERE 替换成真实的 UniKey API Key。

1. 找到 openclaw.json​

系统路径
macOS~/.openclaw/openclaw.json
Linux~/.openclaw/openclaw.json
Windows%USERPROFILE%\.openclaw\openclaw.json

~ 表示当前用户主目录。例如 macOS 中的 ~/.openclaw/openclaw.json 等于 /Users/你的用户名/.openclaw/openclaw.json。

2. 先手动备份原文件​

修改前必须先备份。这样配置出错时，可以立即恢复到之前可用的状态。

macOS、Linux 或 WSL2：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

Windows PowerShell：

Copy-Item "$env:USERPROFILE\.openclaw\openclaw.json" "$env:USERPROFILE\.openclaw\openclaw.json.bak"

3. 替换原文件内容​

打开原始 openclaw.json，全选并替换为以下标准配置。只替换 PASTE_YOUR_UNIKEY_API_KEY_HERE，并保留它两侧的英文双引号。

{
  "models": {
    "mode": "merge",
    "providers": {
      "unikey": {
        "baseUrl": "https://www.getunikey.ai/v1",
        "apiKey": "PASTE_YOUR_UNIKEY_API_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.5",
            "name": "GPT-5.5"
          },
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "unikey/gpt-5.5",
        "fallbacks": [
          "unikey/claude-sonnet-4-6"
        ]
      }
    }
  }
}

保存文件。Base URL 后面不要追加 /chat/completions，OpenClaw 会自动补充。

4. 重启并检查 OpenClaw​

执行：

openclaw gateway restart
openclaw gateway status
openclaw models status

模型状态中应包含 unikey/gpt-5.2。随后在 OpenClaw 聊天中发送一条简短消息，确认模型可以正常回复。

如果配置出错​

  1. 恢复第 2 步创建的备份文件。

    macOS、Linux 或 WSL2：

    cp ~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json

    Windows PowerShell：

    Copy-Item "$env:USERPROFILE\.openclaw\openclaw.json.bak" "$env:USERPROFILE\.openclaw\openclaw.json" -Force

  2. 重启 Gateway：

    openclaw gateway restart
    openclaw gateway status

  3. 如果问题仍然存在，请把报错信息和配置文件发给 UniKey 支持人员，但必须先把 apiKey 的值替换为 REDACTED。任何情况下都不要发送真实 API Key。

直接测试 UniKey API​

如果配置看起来正确，但 OpenClaw 仍然无法回复，请先直接检查 UniKey API Key 和模型是否可用。

macOS、Linux 或 WSL2：

export UNIKEY_API_KEY="PASTE_YOUR_UNIKEY_API_KEY_HERE"

curl https://www.getunikey.ai/v1/chat/completions \
  -H "Authorization: Bearer $UNIKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Reply with OK."}]
  }'

Windows PowerShell：

$env:UNIKEY_API_KEY = "PASTE_YOUR_UNIKEY_API_KEY_HERE"

curl.exe https://www.getunikey.ai/v1/chat/completions `
  -H "Authorization: Bearer $env:UNIKEY_API_KEY" `
  -H "Content-Type: application/json" `
  -d "{\"model\":\"gpt-5.2\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with OK.\"}]}"

如果该命令成功但 OpenClaw 仍然失败，请重新核对上方 JSON，并执行 openclaw models status。如果该命令也失败，请检查 API Key、模型权限、余额和网络连接。