2026年OpenClaw+8API一键切换GPT、Claude、Gemini，小白可跟做（2026最新版）

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

最近在本地部署 OpenClaw 做 AI 模型统一管理，发现很多朋友卡在两个问题：

一是不知道怎么正确安装、初始化、配置 OpenClaw；

二是国内环境对接 Claude、GPT 这类模型时，需要海外账号、网络限制、支付麻烦，新手很难跑通。

这篇就把我亲测可用的完整流程从头到尾写一遍：从 Node.js 环境、OpenClaw 安装，到配置文件修改、API 对接、启动验证，一步一步照着做就能跑起来。我自己在配置时，为了绕开网络与账号问题，用了一个国内可直连的 API 中转服务，这里也一并写进配置里，方便大家直接复用。

OpenClaw 是一个很好用的本地 AI 代理 / 多模型管理工具，可以同时对接 Claude、GPT、Gemini 等模型。但直接对接官方接口，对国内用户不太友好：

需要注册 Anthropic / OpenAI 海外账号
需要海外支付方式
网络环境不稳定

所以我在配置时，直接用国内可直连的 API 中转，不用改 OpenClaw 逻辑，也不用折腾海外账号，配置完就能正常使用。

OpenClaw 依赖 Node.js 18+，先把环境装好。

打开官网：https://nodejs.org/
下载 20.x LTS 版本，一路默认安装
终端验证：

node -v # 输出示例：v20.11.0 npm -v # 输出示例：10.2.4

出现版本号就说明成功。

npm install -g openclaw@latest

openclaw onboard

出现版本与成功提示即可。如果提示 command not found，检查 Node.js 是否安装成功、环境变量是否配置。

找到配置文件：

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

把 models 和 auth 部分替换为以下内容：

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

{  "agents": {    "defaults": {      "model": {        "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"       }     },      "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": {        "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         }       ]     }   } } }

到这里最难的部分已经过了。剩下的就是填 Key 和启动。

找到鉴权文件：

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

填入你自己的 API Key：

{  "version": 1,  "profiles": {    "api-proxy-gpt:default": {      "type": "api_key",      "provider": "api-proxy-gpt",      "key": "sk-your-unique-gpt-key-here"   },    "api-proxy-claude:default": {      "type": "api_key",      "provider": "api-proxy-claude",      "key": "sk-your-unique-claude-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"   } } }

我自己使用的是 88API (https://api.88api.shop)中转平台，省掉注册海外账号和处理海外支付的麻烦，很方便。

Key 的获取方式：先去 88api.shop 注册 → 进控制台 → 点「创建密钥」→ 复制注册即可获取 Key。大家用自己可用的中转服务也行，只需要把 baseUrl 和 key 对应替换即可。

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

88api 是国内直连，不需要翻墙，不需要海外账号，我认为最好用的地方是：一个 Key 多模型，可同时接入多个主流模型，本地统一管理，切换模型只需修改一行配置，方便切换对比。

1. 启动 Gateway 服务：

openclaw gateway –port 18789

做完后终端会输出类似 Gateway running on http://127.0.0.1:18789 的信息，说明服务起来了。

2. 打开控制台：

浏览器访问 http://127.0.0.1:18789/，你会看到 OpenClaw 的 Web 界面。

3. 测试连通性：

在对话框里随便问一句，比如“你是谁”。如果 AI 正常回复，说明 Claude 已经通过 88API 接入成功了。

常见问题

401 Unauthorized：检查 auth-profiles.json 里的 Key 是否填写正确
Connection refused：确认 Gateway 服务是否还在运行
command not found：Node.js 环境变量问题

这篇就是完整的 OpenClaw 本地部署 + 多模型 API 对接教程。

对国内用户来说，最麻烦的其实是 官方接口的网络与账号门槛，我自己是直接用国内可直连的 API 中转方案解决的，配置简单、稳定性也够用。

整个流程走下来：装环境 → 安装 OpenClaw → 改两个配置文件 → 填 Key → 启动，大概 5–10 分钟就能跑通，适合想在本地统一管理 AI 模型、不想折腾海外账号的朋友直接使用。

有配置问题欢迎在评论区交流～

2026年OpenClaw+8API一键切换GPT、Claude、Gemini，小白可跟做（2026最新版）

常见问题

相关推荐