OpenClaw 中转 Claude API 配置教程

Base URL： https://backgrace.com/

本教程将指导你如何在 OpenClaw 中配置中转 Claude API。

1. 安装 OpenClaw

前置要求

Node.js >= 22（访问 https://nodejs.org/ 下载 LTS 版本）

安装命令

bash

npm install -g openclaw@latest

初始化引导

bash

openclaw onboard --install-daemon

按照引导向导完成基本配置。

2. 配置中转 API

配置文件方式

编辑配置文件 ~/.openclaw/openclaw.json，添加自定义提供商：

json5

{
  env: {
    MY_RELAY_API_KEY: "sk-你的令牌"
  },
  models: {
    providers: {
      "my-relay": {
        baseUrl: "https://backgrace.com/v1",
        apiKey: "${MY_RELAY_API_KEY}",
        api: "openai-completions"
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "my-relay/claude-sonnet-4-5-20250929"
      }
    }
  }
}

说明：

baseUrl 必须加 /v1 后缀（OpenAI 兼容协议要求）

api 必须设置为 openai-completions

primary 字段格式为 提供商名/模型名

可用模型

在 primary 字段中可选择以下模型：

模型引用	说明
`my-relay/claude-opus-4-6`	Claude Opus 4.6（最强）
`my-relay/claude-sonnet-4-5-20250929`	Claude Sonnet 4.5（推荐）
`my-relay/claude-haiku-4-5-20251001`	Claude Haiku 4.5（轻量）

3. 配置文件说明

配置文件路径

文件	路径
主配置文件	`~/.openclaw/openclaw.json`
环境变量文件	`~/.openclaw/.env`

环境变量加载优先级（从高到低）

进程环境变量（Process environment）
当前目录的 .env 文件
全局 .env：~/.openclaw/.env
配置文件中的 env 块

提示： 建议将 API Key 等敏感信息放在 .env 文件中，通过 ${VAR_NAME} 格式在配置文件中引用。

4. 常用命令

命令	说明
`openclaw onboard`	引导向导，配置网关和提供商
`openclaw doctor`	检查配置问题和安全风险
`openclaw models status`	查看当前模型和认证状态
`/model`	在聊天中切换模型
`/status`	在聊天中查看当前模型和 token 使用情况

5. 注意事项

Node.js 版本：OpenClaw 要求 Node.js >= 22，请确保版本符合要求
模型引用格式：统一使用 提供商名/模型名 的格式，如 my-relay/claude-opus-4-6
Base URL 必须加 /v1：中转站使用 OpenAI 兼容协议，baseUrl 必须设为 https://backgrace.com/v1
验证配置：配置完成后运行 openclaw doctor 检查是否正常