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

相关推荐
平行云几秒前
虚拟直播混合式2D/3D应用程序实时云渲染推流解决方案
linux·unity·云原生·ue5·图形渲染·实时云渲染·像素流送
wearegogog1231 分钟前
基于和差波束法的单脉冲测角MATLAB实现
人工智能·算法·matlab
isyangli_blog2 分钟前
openstack 下载打包整套环境
服务器·网络·openstack
陈广亮9 分钟前
一个 CLAUDE.md 文件，一周涨了 44K Star：Karpathy 的 AI 编程四原则
人工智能
三秋树10 分钟前
豆包 Agent Harness 工程师入门 | 第 5 章 Skills 技能
人工智能·agent·ai编程
一线数智11 分钟前
从数字化到数智化: AI 赋能零售/餐饮高效运营
人工智能·零售
不一样的故事12616 分钟前
禁止访问 是 SVN 标准 403 权限拒绝错误
运维·安全·自动化
甘露寺17 分钟前
【LangGraph 2026 核心原理解析】大模型 Tool Calling 机制与使用最佳实践全解
大数据·人工智能·python
云烟成雨TD23 分钟前
Spring AI Alibaba 1.x 系列【26】Skills 生命周期深度解析
java·人工智能·spring
咚咚王者25 分钟前
人工智能之知识蒸馏 第八章 知识蒸馏前沿进展与未来趋势
人工智能
热门推荐
012026年4月技术前沿：AI大模型爆发、智能体革命与量子安全新纪元02GitHub 镜像站点032026年4月AI大事件深度解读：大模型竞争进入“深水区“04近期有什么ai的新消息，新动态？ 2026.4月052026 年 AI 编程助手全面对比评测：Cursor vs Copilot vs Claude Code vs GitHub Copilot Free06AI Weekly | 2026年4月第二周 · GitHub热门项目与AI发展趋势深度解析07CC-Switch & Claude 基于 Linux 服务器安装使用指南08codex app每次打开重连5次Reconnecting问题解决09从限购到畅通：GLM-5.1 Coding Plan接入攻略10Claude Code Windows 兼容性问题：指定版本 2.1.112 可解决