【2026 实测】10 分钟配好 OpenClaw 中转站：GPT、Claude、Gemini、DeepSeek 一键切换（小白可跟做）

jike88ai

568人浏览 · 2026-04-02 15:06:18

jike88ai · 2026-04-02 15:06:18 发布

你是不是也遇到过这些问题：

官方 API 偶发不稳定，任务跑到一半中断
想切换模型时，要反复改配置、改 Key
明明照着文档配了，结果还是 400/401 报错

如果你正在本地用 OpenClaw 做 AI 编程或多模型对比，这篇就是给你的。我会用一套可复用的配置流程，带你把 GPT、Claude、Gemini、DeepSeek 统一接入到同一个 OpenClaw 工作流里。

目标很明确：一次配置、稳定调用、随时切换模型。

一、开始前：3 分钟准备清单

先确认这 4 件事，后面基本不会卡壳：

已安装 Node.js v18+
有终端权限（Windows: PowerShell/CMD；macOS: Terminal）
本机有空闲端口（示例用 18789）
已准备好中转站 API Key

先执行：

node -v
npm -v

如果能正常输出版本号，就可以继续。

二、安装 OpenClaw 并初始化

1）全局安装

npm install -g openclaw@latest

2）执行初始化引导

openclaw onboard

执行后会在用户目录生成 .openclaw 文件夹，这是后续所有配置的根目录。

常见路径：

Windows：C:\\Users\\你的用户名\\.openclaw
macOS：~/.openclaw（隐藏目录，可用 ls -a ~ 查看）

三、核心配置：openclaw.json（决定模型能不能正常跑）

这是最关键的一步。文件路径：

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

1）先备份原配置（强烈建议）

# macOS/Linux
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

Windows 可以手动复制一份改名为 openclaw.json.bak。

2）完整配置示例（四模型版）

primary 改成你最常用的模型即可。若解析报错，请去掉 JSON 内注释（部分环境不支持注释）。

{
  "agents": {
    "defaults": {
      "model": {
        "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": "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": "<https://api.88api.chat/v1>",
        "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": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "<https://api.88api.chat>",
        "api": "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,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "<https://api.88api.chat/v1>",
        "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": 2000000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-deepseek": {
        "baseUrl": "<https://api.88api.chat/v1>",
        "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": 2000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

3）三大高频坑（90% 报错都在这）

协议类型写错
- Claude 必须：anthropic-messages
- Gemini 必须：google-generative-ai
- GPT/DeepSeek 常用：openai-completions
baseUrl 路径不一致
- Claude 这里通常不带 /v1
- 其他 Provider 常见是 /v1
Windows 路径转义错误
- workspace 里反斜杠要写成 \\\\

四、鉴权配置：auth-profiles.json（填真实 Key）

openclaw.json 只声明鉴权方式，真正密钥写在这里：

Windows：C:\\Users\\admin\\.openclaw\\agents\\main\\agent\\auth-profiles.json
macOS：~/.openclaw/agents/main/agent/auth-profiles.json

{
  "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"
    }
  }
}