OpenClaw 手动配置参考

当 Dashboard 配置向导不可用，或你需要直接检查本地配置文件时，使用本页。

配置文件路径

系统	路径
macOS	/Users/<your-name>/.openclaw/openclaw.json
Linux	/home/<your-name>/.openclaw/openclaw.json
Windows	C:\Users\<your-name>\.openclaw\openclaw.json

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

填入 OpenClaw 的值

无论 OpenClaw 要求填写 Provider、Base URL、Key 还是模型，都使用以下值：

设置项	值
Provider type	OpenAI-compatible
Provider name	unikey
Base URL	https://www.getunikey.ai/v1
API key	你的 UniKey API Key
Default model	claude-sonnet-4-6
Backup model	gpt-5.2

Base URL 不要追加 /chat/completions。OpenClaw 或其 OpenAI 兼容客户端会自动追加 /chat/completions。

安全手动编辑流程

1. 停止 Gateway：

openclaw gateway stop

2. 备份配置文件。

macOS/Linux：

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。

4. 将 UniKey provider 的值改成上表内容。

5. 保存文件。

6. 重启：

openclaw gateway restart
openclaw gateway status

用 curl 先测试 UniKey API

排查 OpenClaw 前，先用 curl 确认 UniKey API Key 和模型可用。

macOS/Linux：

export UNIKEY_API_KEY="sk-..."

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

Windows PowerShell：

$env:UNIKEY_API_KEY = "sk-..."

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.\"}]}"

如果 curl 成功但 OpenClaw 失败，问题通常在 OpenClaw Provider 配置。如果 curl 也失败，请先检查 API Key、模型权限、Credits 余额和网络。