【2026最新】OpenClaw 自定义中转站配置全攻略：接入 GPT、Claude、Gemini、DeepSeek 四大模型实战教程

曦和2026-03-14 16:03

在本地部署 AI 编程助手时，很多开发者都遇到过同一个问题：官方 API 访问不稳定、多模型切换繁琐、鉴权配置容易出错。OpenClaw 作为一款支持多模型调度的本地 AI Agent 工具，通过自定义中转站配置，可以将 GPT、Claude、Gemini、DeepSeek 等主流大模型统一纳入同一套工作流管理。本文记录完整的配置过程，包含每一步的配置文件示例和注意事项。

一、环境准备与安装

在开始配置之前，确保本机已安装 Node.js （建议 v18 及以上版本）。Node.js 是 OpenClaw 运行的基础依赖，可以通过 node -v 验证当前版本。

1.1 全局安装 OpenClaw

打开终端（Windows 用 PowerShell 或 CMD，macOS 用 Terminal），执行以下命令：

perl 复制代码 
# 全局安装 OpenClaw 最新版本
# -g 参数表示全局安装，安装完成后可在任意目录使用 openclaw 命令
npm install -g openclaw@latest

安装完成后，执行引导命令完成基础初始化：

bash 复制代码 
# 执行交互式引导，根据终端提示逐步完成基础设置
# 此步骤会自动生成 .openclaw 目录和默认配置文件
openclaw onboard

onboard 命令会在用户目录下创建 .openclaw 文件夹，这是后续所有配置文件的根目录。Windows 系统路径为 C:\\Users\\你的用户名\\.openclaw，macOS 系统需要在用户主目录下找到 .openclaw 文件夹（注意该目录默认隐藏，可通过 ls -a ~ 查看）。

二、核心配置：修改 openclaw.json

这是整个配置流程中最关键的一步。openclaw.json 文件负责定义模型列表、Provider 信息以及鉴权模式，配置正确与否直接决定多模型能否正常调用。

文件路径：

  • Windows：C:\\Users\\admin\\.openclaw\\openclaw.json
  • macOS：~/.openclaw/openclaw.json

2.1 配置文件结构说明

整个配置文件分为三个核心部分：

配置块 作用
agents.defaults 定义默认使用的模型、并发数等运行参数
auth.profiles 声明各 Provider 的鉴权方式（此处只声明类型，不填 Key）
models.providers 定义各 Provider 的接口地址、模型列表和参数

2.2 完整配置文件示例

将以下内容替换到 openclaw.json 中，注意 primary 字段需要与你实际使用的模型对应：

swift 复制代码 
{
  "agents": {
    "defaults": {
      "model": {
        // primary 指定默认启动时使用的模型
        // 格式为 "provider名称/模型ID"
        // 如果你主要用 GPT-5.2，改为 "api-proxy-gpt/gpt-5.2"
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      },
      "models": {
        // 以下是可在运行时快速切换的模型别名配置
        "api-proxy-gpt/gpt-5.2": {
          "alias": "GPT-5.2"
        },
        "api-proxy-claude/claude-sonnet-4-5-20250929": {
          "alias": "Claude Sonnet 4.5"
        },
        "api-proxy-google/gemini-3-pro-preview": {
          "alias": "Gemini 3 Pro"
        },
        "api-proxy-deepseek/deepseek-v3.2": {
          "alias": "Deepseek v3.2"
        }
      },
      // workspace 是 OpenClaw Agent 的工作目录，按需修改
      "workspace": "C:\\\\Users\\\\admin\\\\clawd",
      "maxConcurrent": 4,       // 主 Agent 最大并发数
      "subagents": {
        "maxConcurrent": 8      // 子 Agent 最大并发数
      }
    }
  },
  "auth": {
    "profiles": {
      // 此处只声明鉴权类型，实际 API Key 在 auth-profiles.json 中填写
      "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"
      },
      "api-proxy-deepseek:default": {
        "provider": "api-proxy-deepseek",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",  // merge 模式：将自定义 Provider 与内置模型合并
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "<https://api.88api.chat/v1>",  // 中转站接口地址
        "api": "openai-completions",              // 使用 OpenAI 兼容协议
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,  // 上下文窗口大小（Token 数）
            "maxTokens": 8192         // 单次最大输出 Token 数
          }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "<https://api.88api.chat>",
        "api": "anthropic-messages",  // Claude 使用专属的 anthropic-messages 协议
        "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,  // Claude 支持 20 万 Token 上下文
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "<https://api.88api.chat/v1>",
        "api": "google-generative-ai",  // Gemini 使用 Google 专属协议
        "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,  // Gemini 支持超长 200 万 Token 上下文
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-deepseek": {
        "baseUrl": "<https://api.88api.chat/v1>",
        "api": "openai-completions",  // DeepSeek 兼容 OpenAI 协议
        "models": [
          {
            "id": "deepseek-v3.2",
            "name": "Deepseek v3.2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 2000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

几个容易踩坑的地方：

  • api 字段不能混用 ：Claude 必须使用 anthropic-messages，Gemini 使用 google-generative-ai，其余模型使用 openai-completions，协议类型写错会导致请求格式不匹配。
  • baseUrl 末尾斜杠 ：Claude 的 baseUrl 不带 /v1，其他 Provider 需要带，这是由各自协议的路径规范决定的。
  • Windows 路径转义 ：workspace 字段在 Windows 下需要用双反斜杠 \\\\ 转义，macOS 直接用正斜杠即可。

三、鉴权配置：填写真实 API Key

openclaw.json 只声明了鉴权方式，真正的 API Key 需要单独写入 auth-profiles.json，这样做的好处是可以将配置文件和密钥文件分开管理，便于团队协作时共享配置而不泄露密钥。

文件路径：

  • Windows：C:\\Users\\admin\\.openclaw\\agents\\main\\agent\\auth-profiles.json
  • macOS：~/.openclaw/agents/main/agent/auth-profiles.json
vbnet 复制代码 
{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      // 将 sk-your-unique-gpt-key-here 替换为你从中转站获取的真实 Key
      "key": "sk-your-unique-gpt-key-here"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      // Claude 对应的 API Key，同一中转站通常使用同一个 Key
      "key": "sk-your-unique-claude-key-here"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      // Gemini 对应的 API Key
      "key": "sk-your-unique-google-key-here"
    },
    "api-proxy-deepseek:default": {
      "type": "api_key",
      "provider": "api-proxy-deepseek",
      // DeepSeek 对应的 API Key
      "key": "sk-your-unique-deepseek-key-here"
    }
  }
}

API Key 可以从你使用的大模型中转服务获取。如果你还没有统一的中转站账号，88API 支持 GPT、Claude、Gemini、DeepSeek 等多个主流模型的统一接入，获取 Key 后按上述格式填入对应字段即可。

安全提示： auth-profiles.json 包含真实密钥，不要将其提交到 Git 仓库。建议在 .gitignore 中添加 .openclaw/agents/ 路径。

四、启动与验证

两个配置文件都填写完毕后，执行以下命令启动 Gateway 服务：

bash 复制代码 
# 启动 OpenClaw Gateway，指定端口为 18789
# 端口号可按需修改，避免与本机其他服务冲突
openclaw gateway --port 18789

服务启动成功后，打开浏览器访问 http://127.0.0.1:18789/，进入 OpenClaw 控制台。

在控制台中可以验证以下几点：

  • 左侧模型列表中能否看到 GPT-5.2、Claude Sonnet 4.5、Gemini 3 Pro、Deepseek v3.2 四个模型
  • 切换模型后发送一条测试消息，观察是否正常返回
  • 检查控制台日志，确认请求走的是中转站地址而非官方直连

如果某个模型返回鉴权错误（401），优先检查 auth-profiles.json 中对应的 Key 是否填写正确，以及 Key 是否有对应模型的调用权限。

五、常见问题排查

Q：配置文件保存后，控制台看不到自定义模型？ 检查 openclaw.json 中 models.mode 是否为 "merge"，如果设置为 "replace" 会覆盖内置模型列表。

Q：Claude 调用返回 400 错误？ 确认 api-proxy-claude 的 api 字段是否为 anthropic-messages，同时检查 baseUrl 是否去掉了末尾的 /v1。

Q：macOS 找不到 .openclaw 目录？ 该目录以 . 开头，默认隐藏。在 Finder 中按 Command + Shift + . 可显示隐藏文件；终端中使用 ls -a ~ 查看。

Q：多个模型能否共用同一个 API Key？ 取决于中转站的策略。部分中转站提供统一 Key，可以在四个 Provider 的 key 字段填入相同的值；如果中转站按模型分配不同 Key，则需要分别填写。

结语

完成上述四步配置后，OpenClaw 就能通过中转站统一调度 GPT、Claude、Gemini、DeepSeek 四个模型，在不同任务场景下灵活切换，无需为每个模型单独维护一套调用逻辑。对于需要在多个大模型之间做横向对比测试的开发者来说，这套配置方式能显著降低接入和维护成本。

相关推荐
AI创界者29 分钟前
【AI音视频处理】AI视频 480p 一键修复到 1080p！FlashVSR + SeedVR2 本地超分整合包（Base免安装版）
人工智能·aigc·音视频
anda01091 小时前
A2UI 协议: AI 直接画界面，而不是只会打字
人工智能·ai编程
用户21578283966331 小时前
AI 写了 7300 行 MoonBit：编译器能验的，和验不了的
ai编程
正在走向自律2 小时前
从只写接口到独立交付前后端，飞算JavaAI能给Java后端工程师多少溢价？
java·springboot·ai编程·全栈开发·java求职·飞算javaai·金九银十
这个DBA有点耶2 小时前
数据融合平台的下一代形态：数据库内核自己就能融合，为什么还要ETL？
数据库·架构·aigc
Rocky Ding*2 小时前
Hi-DiT：一文读懂Hybrid Latent-Pixel Diffusion Transformer的本质与技术细节
论文阅读·人工智能·深度学习·机器学习·aigc·ai-native·hi-dit
我想问问天3 小时前
Jev 是做什么的？聊聊它能帮 LLM 分担哪些工作
人工智能·llm·aigc
全栈弄潮儿3 小时前
3 个能立刻复用的 AI 编程工作流
aigc·openai·ai编程
浅安的邂逅5 小时前
260926-OpenAI 急停最强模型训练：智能体借 DNS 漏洞联网，还泄露了 GitHub token
人工智能·chatgpt·开源·openai·ai日报
桃西西呀7 小时前
Laya 源码级原理拆解之二：序列打包与决策头
人工智能·llm·ai编程
热门推荐
01Telegram APK 下载安装完整指南 — 2026年最新02国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）03GitHub 镜像站点04历年考研数学一、数学二、数学三真题试卷及答案PDF052026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07给AI一张“业务概念地图“：本体如何从哲学走向企业智能08微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新09jev-ultrafast 深度解析：7 秒订机票的浏览器 Agent 是如何炼成的102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？