OpenClaw 中转站配置教程

前言

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

适用系统： Windows / macOS / Linux
预计时间： 10 分钟

第一步：安装与初始化

1. 安装 OpenClaw

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

2. 执行初始化

按提示完成基础设置。

第二步：修改主配置文件

⚠️ 重要提示

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

配置文件位置

系统	配置文件路径
Windows	`C:\Users\你的用户名\.clawdbot\clawdbot.json`
macOS	`~/.clawdbot/clawdbot.json` 或 `~/openclaw/clawdbot.json`
Linux	`~/.clawdbot/clawdbot.json` 或 `~/openclaw/clawdbot.json`

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

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

macOS/Linux:

Windows:

copy %USERPROFILE%\.clawdbot\clawdbot.json %USERPROFILE%\.clawdbot\clawdbot.json.bak

步骤 2：编辑配置文件

macOS/Linux:

Windows:

notepad %USERPROFILE%\.clawdbot\clawdbot.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"
      }
    }
  }
}

关键配置说明

字段	说明	必需
`baseUrl`	自定义 API 端点地址	✅
`apiKey`	你的 API 密钥（直接写在这里）	✅
`api`	API 类型	✅
`models`	模型列表配置	✅

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

第三步：配置鉴权文件

配置文件位置

系统	鉴权文件路径
Windows	`C:\Users\你的用户名\.clawdbot\agents\main\agent\auth-profiles.json`
macOS	`~/.clawdbot/agents/main/agent/auth-profiles.json` 或 `~/openclaw/agents/main/agent/auth-profiles.json`
Linux	`~/.clawdbot/agents/main/agent/auth-profiles.json` 或 `~/openclaw/agents/main/agent/auth-profiles.json`

编辑鉴权文件

macOS/Linux:

Windows:

notepad %USERPROFILE%\.clawdbot\agents\main\agent\auth-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. 运行健康检查（可选）

2. 启动 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（新窗口）

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

4. 测试对话

在 TUI 中输入：

你好

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

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

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

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

常用命令

命令	说明
`/models`	查看所有可用模型
`/model api-proxy-gpt/gpt-4o`	切换到 GPT-4o
`/model api-proxy-claude/claude-sonnet-4-5-20250929`	切换到 Claude Sonnet 4.5
`/model api-proxy-google/gemini-3-pro-preview`	切换到 Gemini 3 Pro
`/model status`	查看当前模型状态
`/clear`	清空对话历史
`/save`	保存当前会话
`/quit`	退出 TUI

常见问题

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

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

解决步骤：

检查 clawdbot.json 中的 apiKey 字段

检查 auth-profiles.json 中的 key 字段

确认两个文件中的 API Key 一致

确认没有拼写错误和多余空格

重启 Gateway 和 TUI

问题 2: fetch failed - 请求失败

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

解决步骤：

检查 baseUrl 是否正确：

GPT: https://apipro.maynor1024.live/v1

Claude: https://apipro.maynor1024.live

Gemini: https://apipro.maynor1024.live/v1beta

测试网络连接：

查看 Gateway 日志查找错误

问题 3: 端口被占用

错误信息： Port 18789 already in use

Windows 解决：

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

macOS/Linux 解决：

问题 4: 找不到配置文件

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

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

Windows:

mkdir %USERPROFILE%\.clawdbot\agents\main\agent

macOS/Linux:

配置文件完整路径速查

Windows

主配置文件：
C:\Users\你的用户名\.clawdbot\clawdbot.json

鉴权文件：
C:\Users\你的用户名\.clawdbot\agents\main\agent\auth-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:

Windows (PowerShell):

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

配置要点总结

✅ 配置文件名是 clawdbot.json 不是 config.json

✅ 配置文件可能在两个位置：

~/.clawdbot/clawdbot.json

~/openclaw/clawdbot.json

✅ API Key 需要配置在两个地方：

clawdbot.json 的 models.providers[].apiKey

auth-profiles.json 的 profiles[].key

✅ 两个文件中的 API Key 必须一致

✅ baseUrl 必须正确：

GPT 需要 /v1 后缀

Claude 不需要后缀

Gemini 需要 /v1beta 后缀

✅ 不支持环境变量配置

✅ 配置完成后需要重启 Gateway

总结

配置步骤：

✅ 安装 OpenClaw

✅ 修改 clawdbot.json（包含 apiKey）

✅ 修改 auth-profiles.json（包含 key）

✅ 启动 Gateway 和 TUI

✅ 开始使用

重要提醒：

配置文件名是 clawdbot.json，不是 config.json

配置文件可能在 ~/.clawdbot/ 或 ~/openclaw/ 目录

使用 find 命令查找配置文件位置

更新日期： 2026-02-10
版本： v2.1

OpenClaw Clawdbot 自定义中转站配置教程

OpenClaw 中转站配置教程#

前言#

第一步：安装与初始化#

1. 安装 OpenClaw#

2. 执行初始化#

第二步：修改主配置文件#

⚠️ 重要提示#

配置文件位置#

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

步骤 2：编辑配置文件#

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

关键配置说明#

第三步：配置鉴权文件#

配置文件位置#

编辑鉴权文件#

复制以下内容#

第四步：检查并启动#

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

2. 启动 Gateway 服务#

3. 启动 TUI（新窗口）#

4. 测试对话#

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

常用命令#

常见问题#

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

问题 2: fetch failed - 请求失败#

问题 3: 端口被占用#

问题 4: 找不到配置文件#

配置文件完整路径速查#

Windows#

macOS/Linux#

配置要点总结#

总结#

OpenClaw 中转站配置教程

前言

第一步：安装与初始化

1. 安装 OpenClaw

2. 执行初始化

第二步：修改主配置文件

⚠️ 重要提示

配置文件位置

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

步骤 2：编辑配置文件

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

关键配置说明

第三步：配置鉴权文件

配置文件位置

编辑鉴权文件

复制以下内容

第四步：检查并启动

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

2. 启动 Gateway 服务

3. 启动 TUI（新窗口）

4. 测试对话

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

常用命令

常见问题

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

问题 2: fetch failed - 请求失败

问题 3: 端口被占用

问题 4: 找不到配置文件

配置文件完整路径速查

Windows

macOS/Linux

配置要点总结

总结