OpenClaw 中转站配置详细操作步骤

OpenClaw 中转站配置详细操作步骤需要先看清适用场景和关键步骤，避免只记结论却忽略实际限制。

OpenClaw 中转站配置教程

前言

本教程教你如何配置 OpenClaw 使用自定义 API 中转站。

适用系统： Windows / macOS / Linux

预计时间： 10 分钟

第一步：安装与初始化

1. 安装 OpenClaw

npm install -g openclaw

注意：Windows 用户如果提示 openclaw 不是命令，可以使用 clawdbot 代替。

2. 执行初始化

openclaw onboard

按提示完成基础设置。

第二步：修改主配置文件

⚠️ 重要提示

OpenClaw 不支持通过环境变量 ANTHROPIC_BASE_URL 来设置自定义 API 端点。必须通过配置文件的 models.providers 来配置。

配置文件位置

注意： 配置文件可能在 .clawdbot 或 openclaw 目录，取决于你的安装方式。

步骤 1：备份配置文件（可选）

macOS/Linux:

# 如果在 .clawdbot 目录cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.bak# 或者在 openclaw 目录cp ~/openclaw/clawdbot.json ~/openclaw/clawdbot.json.bak

Windows:

copy %USERPROFILE%.clawdbotclawdbot.json %USERPROFILE%.clawdbotclawdbot.json.bak

步骤 2：编辑配置文件

macOS/Linux:

# 如果在 .clawdbot 目录nano ~/.clawdbot/clawdbot.json# 或者在 openclaw 目录nano ~/openclaw/clawdbot.json

Windows:

notepad %USERPROFILE%.clawdbotclawdbot.json

步骤 3：复制以下配置内容

{  "models": {    "mode": "merge",    "providers": {      "api-proxy-gpt": {        "baseUrl": "https://apipro.maynor1024.live/v1",        "api": "openai-completions",        "apiKey": "sk-你的API密钥",        "models": [          {            "id": "gpt-4o",            "name": "GPT-4o",            "reasoning": false,            "input": ["text"],            "cost": {              "input": 0,              "output": 0,              "cacheRead": 0,              "cacheWrite": 0            },            "contextWindow": 128000,            "maxTokens": 8192          }        ]      },      "api-proxy-claude": {        "baseUrl": "https://apipro.maynor1024.live",        "api": "anthropic-messages",        "apiKey": "sk-你的API密钥",        "models": [          {            "id": "claude-sonnet-4-5-20250929",            "name": "Claude Sonnet 4.5",            "reasoning": false,            "input": ["text"],            "cost": {              "input": 0,              "output": 0,              "cacheRead": 0,              "cacheWrite": 0            },            "contextWindow": 200000,            "maxTokens": 8192          }        ]      },      "api-proxy-google": {        "baseUrl": "https://apipro.maynor1024.live/v1beta",        "api": "google-generative-ai",        "apiKey": "sk-你的API密钥",        "models": [          {            "id": "gemini-3-pro-preview",            "name": "Gemini 3 Pro",            "reasoning": false,            "input": ["text"],            "cost": {              "input": 0,              "output": 0,              "cacheRead": 0,              "cacheWrite": 0            },            "contextWindow": 2000000,            "maxTokens": 8192          }        ]      }    }  },  "agents": {    "defaults": {      "model": {        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"      },      "models": {        "api-proxy-gpt/gpt-4o": {          "alias": "GPT-4o"        },        "api-proxy-claude/claude-sonnet-4-5-20250929": {          "alias": "Claude Sonnet 4.5"        },        "api-proxy-google/gemini-3-pro-preview": {          "alias": "Gemini 3 Pro"        }      }    }  },  "auth": {    "profiles": {      "api-proxy-gpt:default": {        "provider": "api-proxy-gpt",        "mode": "api_key"      },      "api-proxy-claude:default": {        "provider": "api-proxy-claude",        "mode": "api_key"      },      "api-proxy-google:default": {        "provider": "api-proxy-google",        "mode": "api_key"      }    }  }}

关键配置说明

? 重要：将所有 sk-你的API密钥 替换为你的真实 API Key！

第三步：配置鉴权文件

配置文件位置

编辑鉴权文件

macOS/Linux:

# 如果在 .clawdbot 目录nano ~/.clawdbot/agents/main/agent/auth-profiles.json# 或者在 openclaw 目录nano ~/openclaw/agents/main/agent/auth-profiles.json

Windows:

notepad %USERPROFILE%.clawdbotagentsmainagentauth-profiles.json

复制以下内容

{  "version": 1,  "profiles": {    "api-proxy-gpt:default": {      "type": "api_key",      "provider": "api-proxy-gpt",      "key": "sk-你的API密钥"    },    "api-proxy-claude:default": {      "type": "api_key",      "provider": "api-proxy-claude",      "key": "sk-你的API密钥"    },    "api-proxy-google:default": {      "type": "api_key",      "provider": "api-proxy-google",      "key": "sk-你的API密钥"    }  },  "lastGood": {    "api-proxy-gpt": "api-proxy-gpt:default",    "api-proxy-claude": "api-proxy-claude:default",    "api-proxy-google": "api-proxy-google:default"  }}

? 重要：将所有 sk-你的API密钥 替换为你的真实 API Key！

第四步：检查并启动

1. 运行健康检查（可选）

openclaw doctor

2. 启动 Gateway 服务

openclaw gateway

预期输出：

? OpenClaw Gateway starting...? WebSocket server listening on ws://127.0.0.1:18789? Web interface available at http://127.0.0.1:18789✨ Gateway ready!

保持这个窗口打开！

3. 启动 TUI（新窗口）

打开新的终端窗口，运行：

openclaw tui

4. 测试对话

在 TUI 中输入：

你好

如果 AI 正常回复，配置成功！?

5. 访问 Web 控制台（可选）

打开浏览器访问：http://127.0.0.1:18789/

使用 openclaw onboard 结尾输出的 Token 登录。

常用命令

常见问题

问题 1: (no output) - 没有响应

原因： API Key 未配置或配置错误

解决步骤：

1. 检查 clawdbot.json 中的 apiKey 字段
2. 检查 auth-profiles.json 中的 key 字段
3. 确认两个文件中的 API Key 一致
4. 确认没有拼写错误和多余空格
5. 重启 Gateway 和 TUI

问题 2: fetch failed - 请求失败

原因： 网络连接问题或 API 地址错误

解决步骤：

1. 检查 baseUrl 是否正确：

   1. GPT: https://apipro.maynor1024.live/v1
   2. Claude: https://apipro.maynor1024.live
   3. Gemini: https://apipro.maynor1024.live/v1beta

2. 测试网络连接：

curl -I https://apipro.maynor1024.live

3. 查看 Gateway 日志查找错误

问题 3: 端口被占用

错误信息：Port 18789 already in use

Windows 解决：

netstat -ano | findstr :18789taskkill /PID  /F

macOS/Linux 解决：

lsof -i :18789kill -9 

问题 4: 找不到配置文件

解决： 确保已经运行过 openclaw onboard 初始化

如果配置目录不存在，手动创建：

Windows:

mkdir %USERPROFILE%.clawdbotagentsmainagent

macOS/Linux:

mkdir -p ~/.clawdbot/agents/main/agent# 或者mkdir -p ~/openclaw/agents/main/agent

配置文件完整路径速查

Windows

主配置文件：C:Users你的用户名.clawdbotclawdbot.json鉴权文件：C:Users你的用户名.clawdbotagentsmainagentauth-profiles.json

macOS/Linux

主配置文件：~/.clawdbot/clawdbot.json或~/openclaw/clawdbot.json鉴权文件：~/.clawdbot/agents/main/agent/auth-profiles.json或~/openclaw/agents/main/agent/auth-profiles.json

提示： 使用以下命令查找配置文件位置：

macOS/Linux:

find ~ -name "clawdbot.json" 2>/dev/null

Windows (PowerShell):

Get-ChildItem -Path $env:USERPROFILE -Filter "clawdbot.json" -Recurse -ErrorAction SilentlyContinue

配置要点总结

1. ✅ API Key 需要配置在两个地方：
   1. config.json 的 models.providers[].apiKey
   2. auth-profiles.json 的 profiles[].key
2. ✅ 两个文件中的 API Key 必须一致
3. ✅ baseUrl 必须正确：
   1. GPT 需要 /v1 后缀
   2. Claude 不需要后缀
   3. Gemini 需要 /v1beta 后缀
4. ✅ 不支持环境变量配置
5. ✅ 配置完成后需要重启 Gateway

总结

配置步骤：

1. ✅ 安装 OpenClaw
2. ✅ 修改 config.json（包含 apiKey）
3. ✅ 修改 auth-profiles.json（包含 key）
4. ✅ 启动 Gateway 和 TUI
5. ✅ 开始使用