2026年10 分钟搞定！OpenClaw+API 中转实现 Claude／GPT 国内稳定调用（2026 最新教程）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

相信不少开发者都遇到过这样的困境：想用 Claude、GPT 或 Gemini 这类顶级大模型做开发，却卡在"注册海外账号 → 绑定境外信用卡 → 配置代理访问"这一套繁琐流程上。更麻烦的是，即便账号注册成功，API 调用时的网络稳定性也难以保证，动不动就超时或断连，严重影响开发效率。

本文将手把手教你通过 OpenClaw + API 中转完整接入 Claude 等主流大模型 API，国内直连、无需翻墙、无需海外账号，实现从零到跑通的完整配置流程（含配置文件和代码示例），可直接复用。

本人用的是 88API (https://api.88api.shop)做 API 中转，省掉注册 Anthropic 账号和处理海外支付的麻烦。

核心好处：

国内直连：不需要翻墙，不需要海外账号
协议兼容：Claude 原生协议完整映射，OpenClaw 无感接入
一个 Key 多模型：同一个平台还能调 GPT、Gemini、DeepSeek，方便切换对比

这套方案的优势在于：一个 Key 可同时接入多个主流模型，本地统一管理，切换模型只需修改一行配置。

开始之前，请确认本地已安装 Node.js 18+。

如果尚未安装，打开官网：https://nodejs.org

推荐下载 LTS 版（建议 20.x LTS），双击安装，全部 Next（默认就行）

打开终端（Windows 用 PowerShell 或 CMD），可输入以下命令验证：

node -v

输出示例：v20.11.0

npm -v

输出示例：10.2.4

3.1 全局安装

打开终端（Windows 用 PowerShell 或 CMD，回车打开），执行：

npm install -g openclaw@latest

安装完成后，运行引导初始化命令：

openclaw onboard

说明：初始化完成后，终端会输出版本号和成功提示。如果提示 command not found，需要检查 Node.js 是否正确安装，以及 npm 全局路径是否已加入系统 PATH 环境变量。

初始化完成后，OpenClaw 会在用户目录下自动生成配置文件夹：

Windows：C:\Users\你的用户名\.openclaw\
Mac / Linux：~/.openclaw/

4.1 找到配置文件

Windows：C:\Users\你的用户名\.openclaw\openclaw.json
Mac / Linux：~/.openclaw/openclaw.json

4.2 写入配置内容

用任意文本编辑器打开该文件，把 models 和 auth 部分替换为以下内容：

⚠️ “primary” 字段决定默认模型。如果你想默认用 GPT-5.2，改成 “primary”: “api-proxy-gpt/gpt-5.2”；Mac 用户记得把 workspace 路径改成自己的工作目录，比如 “/Users/你的用户名/clawd”。

下述配置同时注册了 Claude、GPT、Gemini 和 DeepSeek 四个 Provider，可按需保留：

{ “agents”: {

"defaults": { "model": { // primary 字段决定默认使用的模型 // 如需默认使用 GPT，改为 "api-proxy-gpt/gpt-5.2" "primary": "api-proxy-claude/claude-sonnet-4-5-" }, "models": { "api-proxy-gpt/gpt-5.2": { "alias": "GPT-5.2" }, "api-proxy-claude/claude-sonnet-4-5-": { "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" } }, // Windows 用户修改为自己的工作目录路径 // Mac/Linux 示例："/Users/你的用户名/clawd" "workspace": "C:\\\\Users\\\\admin\\\\clawd", "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } }

}, “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" }, "api-proxy-deepseek:default": { "provider": "api-proxy-deepseek", "mode": "api_key" } }

}, “models”: {

"mode": "merge", "providers": { "api-proxy-gpt": { "baseUrl": " 
  
    
    
      ", "api": "openai-completions", "models": [ { "id": "gpt-5.2", "name": "GPT-5.2", "reasoning": false, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": , "maxTokens": 8192 } ] }, "api-proxy-claude": { // Claude 使用 anthropic-messages 协议，baseUrl 不加 /v1 "baseUrl": " 
     
       ", "api": "anthropic-messages", "models": [ { "id": "claude-sonnet-4-5-", "name": "Claude Sonnet 4.5", "reasoning": false, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": , "maxTokens": 8192 } ] }, "api-proxy-google": { "baseUrl": " 
      
        ", "api": "google-generative-ai", "models": [ { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "reasoning": false, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": , "maxTokens": 8192 } ] }, "api-proxy-deepseek": { "baseUrl": " 
       
         ", "api": "openai-completions", "models": [ { "id": "deepseek-v3.2", "name": "Deepseek v3.2", "reasoning": false, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": , "maxTokens": 8192 } ] } }

} }

注意：api-proxy-claude 的 baseUrl 不带 /v1 后缀，这是 Anthropic Messages 协议的特殊要求，其他 Provider 均需加 /v1。

5.1 找到鉴权文件

Windows：C:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.json
Mac / Linux：~/.openclaw/agents/main/agent/auth-profiles.json

5.2 填入 API Key

将以下内容写入文件，并将占位符替换为你实际获取的 Key：

{ “version”: 1, “profiles”: {

// 只用 Claude 的话，只填这一项即可，其余留空不影响启动 "api-proxy-claude:default": { "type": "api_key", "provider": "api-proxy-claude", "key": "sk-your-unique-claude-key-here" }, "api-proxy-gpt:default": { "type": "api_key", "provider": "api-proxy-gpt", "key": "sk-your-unique-gpt-key-here" }, "api-proxy-google:default": { "type": "api_key", "provider": "api-proxy-google", "key": "sk-your-unique-google-key-here" }, "api-proxy-deepseek:default": { "type": "api_key", "provider": "api-proxy-deepseek", "key": "sk-your-unique-deepseek-key-here" }

} }

Key 获取方式：使用https://api.88api.shop，注册账号→ 进控制台 → 点「创建密钥」→ 复制生成的 sk- 开头的字符串，填入上述对应字段即可。该平台支持国内直连，无需海外支付方式。

⚠️ 如果你只用 Claude，只填 api-proxy-claude:default 这一项就够了，其他的可以先留空。

6.1 启动 Gateway

配置完成后，在终端执行：

openclaw gateway –port 18789

看到如下输出说明服务启动成功：

Gateway running on

6.2 打开 Web 控制台

浏览器访问 http://127.0.0.1:18789/，即可看到 OpenClaw 的 Web 界面，支持直接在页面上进行对话测试。

6.3 测试连通性

在对话框输入“你是谁”，如果 AI 正常回复，说明 Claude 已通过 API 中转成功接入。

常见报错处理：

报错信息原因解决方式 401 Unauthorized Key 填写有误或已失效检查 auth-profiles.json 中的 Key 是否正确 Connection refused Gateway 服务未运行重新执行 openclaw gateway –port 18789 command not found OpenClaw 未正确安装检查 npm 全局路径是否在 PATH 中

配置完成后，切换模型只需修改 openclaw.json 中的 primary 字段：

// 切换为 DeepSeek “primary”: “api-proxy-deepseek/deepseek-v3.2”

// 切换为 Gemini “primary”: “api-proxy-google/gemini-3-pro-preview”

对于需要并行处理多任务的场景，可调整并发参数：

“maxConcurrent”: 4, // 主 Agent 最大并发数 “subagents”: { “maxConcurrent”: 8 // 子 Agent 最大并发数，适合复杂任务拆解 }

整套方案的核心是用本地 Gateway + API 中转的组合，绕开了国内开发者接入海外大模型时最常遇到的网络和支付障碍。OpenClaw 负责统一管理多模型路由，API 中转服务负责保障国内直连的稳定性，两者配合下来，整个接入流程可以控制在 15 分钟以内。

对于需要在多个模型之间做横向对比测试的开发者，这套配置同样适用——改一行 primary 字段，就能在 Claude、GPT、Gemini、DeepSeek 之间自由切换，不需要维护多套鉴权逻辑。