OpenClaw中转站配置权威教程（2024版）

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：复制以下配置内容

把下面的 JSON 整个替换进文件。这里以三个常见模型为例：GPT-4o、Claude Sonnet 4.5、Gemini 3 Pro。中转站地址用的是 apipro.maynor1024.live，如果你有自己的中转，把 baseUrl 改掉就行。

{
  "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，这一步漏掉后面肯定连不上。

第三步：配置鉴权文件

除了主配置文件，还得再改一个鉴权文件。这两个文件里的 API Key 必须保持一致，否则会报 (no output) 之类的错误。

鉴权文件位置

编辑鉴权文件

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 a vailable at http://127.0.0.1:18789
✨ Gateway ready!

保持这个窗口打开！ 关掉 Gateway 就无法连接了。

3. 启动 TUI（新窗口）

再开一个终端窗口，运行：

openclaw tui

如果这一步报错说端口占用，看后面的常见问题处理。

4. 测试对话

在 TUI 里输入：

你好

如果 AI 正常回复，恭喜，配置成功！如果不回复，多半是 API Key 或 baseUrl 有问题。

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 是否完整——不同服务商的地址后缀不一样：

   • GPT: https://apipro.maynor1024.live/v1
   • Claude: https://apipro.maynor1024.live
   • Gemini: https://apipro.maynor1024.live/v1beta

2. 用 curl 测试中转站连通性：

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

3. 查看 Gateway 的日志输出，搜索 "error" 或 "fetch" 关键词，多半能定位到问题。

问题 3: 端口被占用

错误信息： Port 18789 already in use

Windows 解决：

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

macOS/Linux 解决：

lsof -i :18789
kill -9 

杀掉占用进程后重新启动 Gateway 即可。

问题 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

配置要点总结

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

总结

整个流程简单概括就是五步：

1. 安装 OpenClaw
2. 修改 config.json（填上 apiKey 和 baseUrl）
3. 修改 auth-profiles.json（填上 key）
4. 启动 Gateway 和 TUI
5. 开始对话

照着做基本上一次就能跑通。如果卡在某个环节，回头检查 API Key 是否一致、baseUrl 后缀是否正确，这两项占九成的问题。

来源：互联网