一、 背景与前置条件

在使用 OpenClaw 构建 AI Agent 时，很多开发者希望接入性价比更高的第三方中转 API（如 xingjiabiapi.org），以替代官方的 Anthropic 接口。OpenClaw 的 provider 机制完美支持这一需求，但配置时需严格遵循特定的 JSON 结构。

前置条件：

1. 已安装并运行 OpenClaw。

2. 拥有第三方服务的 baseUrl 和 apiKey。

3. 关键点：确认第三方 API 兼容 Anthropic Messages API 格式。

---

二、 核心配置详解

OpenClaw 的路由逻辑不依赖系统环境变量（如 ANTHROPIC_BASE_URL），而是完全由配置文件控制。

1. 找到配置文件

根据您的操作系统，定位到 openclaw.json 主配置文件：

• Windows: C:\Users\<用户名>\.openclaw\openclaw.json

• macOS/Linux: ~/.openclaw/openclaw.json

2. 添加自定义 Provider

在 models.providers 节点下添加第三方服务配置。

注意：api 字段必须显式设置为 "anthropic-messages"，否则 OpenClaw 无法识别协议类型。

JSON

{
  "models": {
    "mode": "merge",
    "providers": {
      "xingjiabiapi": {
        "baseUrl": "https://xingjiabiapi.org",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4" }
        ]
      }
    }
  }
}

3. 设置默认路由 (Default Model)

配置好 Provider 后，需要在 agents.defaults 中指定默认使用的模型。

易错点：模型引用格式必须为 provider名称/模型ID，例如 xingjiabiapi/claude-opus-4-5-20251101。

JSON

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "xingjiabiapi/claude-opus-4-5-20251101"
      },
      "models": {
        "xingjiabiapi/claude-opus-4-5-20251101": {}
      }
    }
  }
}

---

三、 生效与验证

1. 应用配置

OpenClaw Gateway 通常支持热重载，配置文件保存后自动生效。如果未生效，可使用命令行强制重启：

Bash

# 推荐重启方式
openclaw gateway restart

2. 验证状态

重启后，通过以下命令检查模型是否挂载成功：

Bash

openclaw models status

如果输出中包含您配置的 xingjiabiapi 及对应的模型 ID，说明配置已加载。此时可运行 openclaw agent --local 发送测试消息。

---

四、 常见问题排查 (Troubleshooting)

在实际部署中，以下三个问题最为高频，请重点关注：

Q1: 请求报错 HTTP 403 Forbidden: Request not allowed

• 原因分析：OpenClaw 将请求发送到了官方 Anthropic API 地址，而非您配置的第三方地址。

• 解决方案：检查 agents.defaults.model.primary 的值。必须包含自定义 Provider 的前缀（如 xingjiabiapi/）。如果只写模型 ID，系统会默认使用官方路由。

Q2: 环境变量 ANTHROPIC_BASE_URL 不生效

• 原因分析：OpenClaw 的架构设计不使用该环境变量进行路由。

• 解决方案：必须在 openclaw.json 的 models.providers 中显式定义 baseUrl。

Q3: Dashboard Chat 界面无响应

• 原因分析：Gateway 后端可能加载了错误的模型配置。

• 解决方案：

  1. 检查日志文件（路径通常为 \tmp\openclaw\openclaw-<日期>.log）。

  2. 搜索 agent model: 日志行，确认当前加载的模型是否为您配置的第三方模型。

---

五、 总结

通过修改 openclaw.json，我们可以灵活地将 OpenClaw 的推理后端指向任意兼容 Anthropic 协议的第三方服务。这不仅降低了使用成本，也为 Agent 的部署提供了更多网络选择。

配置字段速查表：

字段路径	关键值	说明
models.mode	"merge"	合并模式，保留默认配置的同时添加自定义配置
providers.<name>.api	"anthropic-messages"	必填，指定协议类型
defaults.model.primary	provider/modelId	核心，指定默认路由路径

 

标签： #OpenClaw #Claude #API网关 #后端开发 #人工智能