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 的配置通过编辑一个 JSON 文件来完成。下面分步骤教你如何找到并修改这个文件。

第一步：打开配置文件

配置文件路径为 ~/.openclaw/openclaw.json，其中 ~ 代表你的用户主目录。

什么是用户主目录？

Windows： C:\Users\你的用户名

macOS： /Users/你的用户名

Linux： /home/你的用户名

选择你的操作系统，在终端中运行以下命令直接用编辑器打开配置文件：

Windows（PowerShell）

powershell

notepad "$env:USERPROFILE\.openclaw\openclaw.json"

macOS / Linux

bash

nano ~/.openclaw/openclaw.json

提示： 也可以用你喜欢的编辑器打开，例如 VS Code：code ~/.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",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" },
          { id: "claude-haiku-4-5-20251001", name: "Claude Haiku 4.5" }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "my-relay/claude-sonnet-4-6"
      }
    }
  }
}

第三步：填入你的令牌

将配置中的 sk-你的令牌 替换为你在 backgrace.com 创建的实际令牌（以 sk- 开头）。

例如，如果你的令牌是 sk-abc123xyz，则修改为：

json5

MY_RELAY_API_KEY: "sk-abc123xyz"

第四步：保存文件

Windows 记事本： 按 Ctrl + S 保存，然后关闭
nano 编辑器： 按 Ctrl + O → 回车确认 → Ctrl + X 退出
VS Code： 按 Ctrl + S（macOS 为 Cmd + S）保存

第五步：验证配置

保存后，在终端运行以下命令验证配置是否正确：

bash

openclaw doctor

如果没有报错，输入 openclaw 即可开始使用。

说明：

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

api 必须设置为 openai-completions

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

可用模型

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

模型引用	说明
`my-relay/claude-opus-4-6`	Claude Opus 4.6（最强）
`my-relay/claude-sonnet-4-6`	Claude Sonnet 4.6（推荐）
`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 检查是否正常