OpenClaw 中转站配置完全指南

Maynor9962026-02-14 14:08

OpenClaw 中转站配置教程

前言

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

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

第一步：安装与初始化

1. 安装 OpenClaw

bash 复制代码 
npm install -g openclaw

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

2. 执行初始化

bash 复制代码 
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:

bash 复制代码 
# 如果在 .clawdbot 目录
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.bak

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

Windows:

cmd 复制代码 
copy %USERPROFILE%\.clawdbot\clawdbot.json %USERPROFILE%\.clawdbot\clawdbot.json.bak

步骤 2：编辑配置文件

macOS/Linux:

bash 复制代码 
# 如果在 .clawdbot 目录
nano ~/.clawdbot/clawdbot.json

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

Windows:

cmd 复制代码 
notepad %USERPROFILE%\.clawdbot\clawdbot.json

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

json 复制代码 
{
  "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:

bash 复制代码 
# 如果在 .clawdbot 目录
nano ~/.clawdbot/agents/main/agent/auth-profiles.json

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

Windows:

cmd 复制代码 
notepad %USERPROFILE%\.clawdbot\agents\main\agent\auth-profiles.json

复制以下内容

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

bash 复制代码 
openclaw doctor

2. 启动 Gateway 服务

bash 复制代码 
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（新窗口）

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

bash 复制代码 
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 未配置或配置错误

解决步骤：

  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. 测试网络连接：

bash 复制代码 
curl -I https://apipro.maynor1024.live
  1. 查看 Gateway 日志查找错误

问题 3: 端口被占用

错误信息： Port 18789 already in use

Windows 解决：

cmd 复制代码 
netstat -ano | findstr :18789
taskkill /PID <PID> /F

macOS/Linux 解决：

bash 复制代码 
lsof -i :18789
kill -9 <PID>

问题 4: 找不到配置文件

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

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

Windows:

cmd 复制代码 
mkdir %USERPROFILE%\.clawdbot\agents\main\agent

macOS/Linux:

bash 复制代码 
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:

bash 复制代码 
find ~ -name "clawdbot.json" 2>/dev/null

Windows (PowerShell):

powershell 复制代码 
Get-ChildItem -Path $env:USERPROFILE -Filter "clawdbot.json" -Recurse -ErrorAction SilentlyContinue

配置要点总结

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

    • config.json 的 models.providers[].apiKey
    • auth-profiles.json 的 profiles[].key

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

  3. ✅ baseUrl 必须正确：

    • GPT 需要 /v1 后缀
    • Claude 不需要后缀
    • Gemini 需要 /v1beta 后缀

  4. ✅ 不支持环境变量配置

  5. ✅ 配置完成后需要重启 Gateway

总结

配置步骤：

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

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

相关推荐
Eric2232 小时前
CLI-Agent-Manager：面向 Vibe Coding 的多 Agent 统一管理面板
人工智能·后端·开源
如若1232 小时前
SoftGroup训练FORinstance森林点云数据集——从零到AP=0.506完整复现
人工智能·python·深度学习·神经网络·计算机视觉
InternLM2 小时前
LMDeploy重磅更新：从支撑模型到被模型反哺，推理引擎迈入协同进化时代！
人工智能·大模型·多模态大模型·大模型推理·书生大模型
Tinyundg2 小时前
Linux中的文件权限
linux·运维·服务器
AI周红伟2 小时前
周红伟老师《企业级 RAG+Agent+Skills+OpenClaw 智能体实战内训》的完整课程大纲（5 天 / 40 小时）
人工智能
网云工程师手记2 小时前
防火墙接口配置与运维实战（通用版）
运维·服务器·网络·网络协议·网络安全
FoldWinCard2 小时前
Python 第五次作业
linux·windows·python
hit56实验室2 小时前
【易经系列】《蒙卦》六五：童蒙，吉。
人工智能
AI浩2 小时前
VISION KAN：基于Kan的无注意力视觉骨干网络
人工智能·目标检测
热门推荐
01GitHub 镜像站点02Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services03爬虫逆向之观安（观镜WEB应用安全防护系统）04openClaw安装飞书插件｜核心踩坑：spawn EINVAL 错误终极解决指南05UV安装并设置国内源06HTB 赛季10 - Pterodactyl - user07BongoCat - 跨平台键盘猫动画工具08243 行 microGPT：把“训练 + 推理”拆到骨头里09AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南10openclaw配置教程（linux+局域网ollama）