OpenClaw 中转站配置详细教程

发布时间：2026-03-02 11:50:29 作者：秒懂AI+

本文介绍了如何在Windows、macOS和Linux系统上配置OpenClaw使用自定义API中转站,通过安装OpenClaw、初始化配置文件、编辑主配置文件和鉴权文件,以及启动Gateway和TUI,本文提供常见问题的解决方法和配置要点总结,帮助用户顺利完成配置，感兴趣的朋友跟随小编一起看看吧

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 来配置。

配置文件位置

系统	配置文件路径
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:

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

Windows:

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

步骤 2：编辑配置文件

macOS/Linux:

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

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:

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

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. 运行健康检查（可选）

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 登录。

常用命令

命令	说明
`/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
测试网络连接：

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

查看 Gateway 日志查找错误

问题 3: 端口被占用

错误信息： Port 18789 already in use

Windows 解决：

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

macOS/Linux 解决：

lsof -i :18789
kill -9 <PID>

问题 4: 找不到配置文件

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

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

Windows:

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

macOS/Linux:

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

配置文件完整路径速查

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:

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

总结

配置步骤：

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

到此这篇关于OpenClaw 中转站配置完全指南的文章就介绍到这了,更多相关OpenClaw 中转站配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

Tag：中转 OpenClaw 配置

飞书怎么接入OpenClaw OpenClaw接入飞书保姆级教程
本教程专为零基础用户量身打造，系统梳理OpenClaw部署全流程，细致拆解接入飞书的实操步骤,从环境搭建到功能适配，每一步都清晰易懂、可落地，助力新手快速掌握核心要领，
2026-03-04
OpenClaw删除开机自启动的实战指南
OpenClaw通过引导程序初始化配置时，回触发开机自启动服务，但是很多时候，我们需要手动管理，一下内容，为具体的操作方法,感兴趣的小伙伴可以跟随小编一起学习一下
2026-03-03
钉钉怎么接入OpenClaw OpenClaw接入钉钉保姆级指南
本教程为OpenClaw接入钉钉的保姆级指南，涵盖服务器部署、核心凭证获取、钉钉应用配置等全流程,无需编程基础，提供一键部署方案，适配2026年最新规则，助用户快速实现AI助
2026-03-03
OpenClaw 部署保姆级教程之部署你的第一只大龙虾(ClawdBot/Moltbot)
OpenClaw（曾用名 ClawdBot/Moltbot）是 2026 年最火的开源 AI Agent 项目，GitHub 已获得超过 68,000 星标，下面给大家分享保姆级教程 OpenClaw 部署你的第一只大龙虾，感
2026-03-03
Windows下OpenClaw的安装与Debug配置教程最终版(MiniPC i3-N305 / 无 G
这篇文章主要介绍了Windows下OpenClaw的安装与Debug配置,机器是MiniPC i3-N305 / 无 GPU，需要的朋友可以参考一下，有条件的尽量用mac系统简单快捷，一次通过的成功率高
2026-03-03
零基础入门OpenClaw 完整安装配置实战指南(完全流程)
OpenClaw就是一个可以让 AI 住进你的 Telegram、管理你的电脑或服务器、帮你写代码的开源框架，下面给大家分享整个安装过程，感兴趣的朋友跟随小编一起看看吧
2026-03-03
OpenClaw进化指南120小时实测避坑
OpenClaw是一个强大的自动化工具,可以自动运行日常任务,如生成日报、资产配置和MarkWave创作,下面给大家分享OpenClaw跑了120小时，踩了无数坑总结出的5条必做，这些坑你千
2026-03-03
OpenClaw安装及正确用法总结指南
OpenClaw作为GitHub 10万+星的开源AI助手平台，近期在国内AI圈备受关注,但部署难度和用法让很多用户望而却步,这篇文章主要介绍了OpenClaw安装及正确用法的相关资料,需要的
2026-03-03
手把手教你给OpenClaw装上无限免费算力
本文介绍了通过FreeRide技能为OpenClaw配置免费AI算力,实现零成本使用AI助手，文中通过示例代码介绍的非常详细，需要的朋友们下面随着小编来一起学习学习吧
2026-03-03
OpenClaw第三方开源汉化中文发行版部署全指南以及常见问题解决方法
本文为大家带来了OpenClaw（Clawdbot/Moltbot）第三方开源汉化中文发行版部署全指南：一键脚本/Docker/npm 三模式安装+Ubuntu 环境配置+中文汉化界面适配开源版，需要的朋
2026-03-03