OpenClaw 接入

第 1 步：安装并准备

macOS
Windows
Linux

在 macOS 终端（Bash / Zsh）运行：

curl -fsSL https://openclaw.ai/install.sh | bash

原生 Windows 的 PowerShell 安装 CLI / Gateway：

iwr -useb https://openclaw.ai/install.ps1 | iex

也可在 WSL2 中按 Linux 栏安装；WSL2 提供更接近 Linux 的 Gateway 环境。配置和启动命令应在所选环境中执行。

在 Linux 的 Bash 终端运行（也适用于 WSL2）：

curl -fsSL https://openclaw.ai/install.sh | bash

按安装向导完成本地 Gateway 初始化；需要重新进入时运行 openclaw onboard。从 ABCRelay 开始使用准备 API Key 和当前 Key 可用的模型 ID。下文的 YOUR_ABCRELAY_API_KEY、YOUR_MODEL_ID 分别替换为这两个实际值。

第 2 步：配置 ABCRelay

完成初始化后，打开当前 Gateway 配置。下面列出默认完整路径；文件不存在时请新建此文件，文件名保持 openclaw.json。自定义的 OPENCLAW_CONFIG_PATH / 状态目录及命名 profile 见 FAQ。请在运行 Gateway 的同一用户和环境中配置。

macOS
Windows
Linux

默认完整路径：

~/.openclaw/openclaw.json

默认完整路径（资源管理器地址栏）：

%USERPROFILE%\.openclaw\openclaw.json

默认完整路径：

~/.openclaw/openclaw.json

将以下 JSON5 合并到打开的文件，保留原有 Gateway 和其他 provider；三个系统使用相同内容。

{
  agents: {
    defaults: {
      model: { primary: "abcrelay/YOUR_MODEL_ID" }
    }
  },
  models: {
    mode: "merge",
    providers: {
      abcrelay: {
        baseUrl: "https://www.abcrelay.com/v1",
        apiKey: "YOUR_ABCRELAY_API_KEY",
        api: "openai-completions",
        models: [
          { id: "YOUR_MODEL_ID", name: "ABCRelay Model" }
        ]
      }
    }
  }
}

替换 Key 和两处模型 ID。本例使用 Chat Completions，模型需支持该协议。含 Key 的文件保存在用户目录。 地址要带 /v1： 本页 api: "openai-completions" 的 baseUrl 填 https://www.abcrelay.com/v1，最终请求为 https://www.abcrelay.com/v1/chat/completions。不要把 /chat/completions 写进 baseUrl；三个系统相同。

第 3 步：发消息验证

以下命令在 macOS / Linux 终端和 Windows PowerShell 中相同：

openclaw models status
openclaw gateway status
openclaw dashboard

确认默认模型为 abcrelay/YOUR_MODEL_ID，在控制面板发送「只回复 OK」。若仍显示旧配置，按 Gateway 文档重载或重启后再试。收到回复后，到 ABCRelay 控制台核对同一时间、Key 和模型的请求记录。

常见问题与详细说明

切换协议时，地址要不要带 /v1？

models.providers.abcrelay.baseUrl 的填写规则随 api 适配器变化：

`api` 适配器	ABCRelay 基础地址	最终请求路径
`openai-completions`	`https://www.abcrelay.com/v1`	`/v1/chat/completions`
`openai-responses`	`https://www.abcrelay.com/v1`	`/v1/responses`
`anthropic-messages`	`https://www.abcrelay.com`	`/v1/messages`

只在 Key 和模型已支持对应接口时切换模式；不要把表中“最终请求路径”拼进基础地址。其他客户端的同名字段可能有不同规则，见API 地址对照表。

连接失败怎么排查？

Key 鉴权、余额或额度、网络以及通用模型错误，请先查看常见问题排查。以下列出此客户端需要额外检查的项目。

现象	检查方法
`404` / 协议错误	检查地址是否只有一个 `/v1`，并确认模型使用 Chat Completions 还是 Responses；不要无依据地反复切换适配器。
模型找不到	核对 `primary` 的 provider 前缀以及模型条目中的精确 `id`。
状态正常但聊天失败	状态不是推理测试；根据客户端错误与 ABCRelay 请求记录继续定位。
聊天正常但工具或图片失败	分别确认模型、网关转换和客户端对此能力的支持。
上下文超限或本地费用估算不准	按真实模型资料补充元数据；本地目录默认值不代表服务实际限制或价格。
配置未生效	检查实际配置文件、当前 Gateway 和 JSON5 语法；保留原有配置结构。

本页使用什么协议和客户端？

本页示例使用 OpenAI Chat Completions，基础地址为 https://www.abcrelay.com/v1，OpenClaw 适配器名称是 openai-completions。只有在当前 Key 和所选模型已确认支持 Responses API 时，才将适配器改为 openai-responses。不要因为网关基于 new-api 就推断所有模型支持相同协议。普通聊天返回也不代表文件工具、图片、推理或完整代理流程均兼容。

向导里可以直接配置吗？

若 openclaw onboard 提供 Custom Provider，填写上面的地址、Key 和模型并选择 OpenAI 兼容。CLI 的 --custom-compatibility openai 对应 Chat Completions，openai-responses 对应 Responses；它们与配置文件里的 api 名称不同。

模型能力、上下文和价格怎么填写？

reasoning、input、cost、contextWindow、maxTokens 是可选元数据，应按模型真实资料补充。省略后的默认值或发现结果不代表 ABCRelay 实际限制、价格或能力。abcrelay/ 是本地 provider 前缀，id 才是发送给 API 的模型 ID，name 只是显示名称。

状态正常就代表全部可用了吗？

models status 不带 --probe 时不是模型调用测试。聊天成功后，可在测试目录要求只读查看一个测试文件，检查真实工具请求、结果回传与流式输出；图片和其他能力分别验证。

原生 Windows、WSL2 和桌面应用有什么区别？

本页配置 CLI / Gateway。原生 Windows 使用 PowerShell 安装；WSL2 使用 Linux 安装和 Linux 用户目录。不要编辑 Windows 配置后启动 WSL 中的另一份 Gateway。Windows Hub 与 macOS 菜单栏应用是另行提供的桌面入口；Windows Hub 的本地设置还可能创建自己的 WSL Gateway。托管启动方式也不同：macOS 使用 LaunchAgent，Linux / WSL2 使用 systemd 用户服务，原生 Windows 使用计划任务或启动文件夹后备方式。自定义 OPENCLAW_CONFIG_PATH 时，以实际路径为准。

资料来源与验证范围

官方资料核对日期：2026-09-10。本页已核对 OpenClaw 官方文档及官方仓库文档；此次未在 ABCRelay 上运行客户端或推理测试。

开始使用

官方桌面应用

图形聊天

终端编程

编辑器与插件

代理系统

帮助

第 1 步：安装并准备

第 2 步：配置 ABCRelay

第 3 步：发消息验证

常见问题与详细说明

​第 1 步：安装并准备

​第 2 步：配置 ABCRelay

​第 3 步：发消息验证

​常见问题与详细说明

第 1 步：安装并准备

第 2 步：配置 ABCRelay

第 3 步：发消息验证

常见问题与详细说明