前言:一个让国内开发者头疼的老问题

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

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

一、整体方案

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

核心好处:

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

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

二、安装Node.js

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

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

推荐下载 LTS 版(建议 20.x LTS),双击安装,全部 Next(默认就行)

打开终端(Windows 用 PowerShell 或 CMD),可输入以下命令验证:

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

三、安装 OpenClaw 并初始化

3.1 全局安装

打开终端(Windows 用 PowerShell 或 CMD,回车打开),执行:

npm install -g openclaw@latest

安装完成后,运行引导初始化命令:

openclaw onboard

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

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

  • WindowsC:\\\\Users\\\\你的用户名\\\\.openclaw\\\\
  • Mac / Linux~/.openclaw/

四、配置主文件 openclaw.json

4.1 找到配置文件

  • WindowsC:\\\\Users\\\\你的用户名\\\\.openclaw\\\\openclaw.json
  • Mac / Linux~/.openclaw/openclaw.json

4.2 写入配置内容

用任意文本编辑器打开该文件,把 modelsauth 部分替换为以下内容:

⚠️ "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-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"
        }
      },
      // 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": "<https://api.88api.shop/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": {
        // Claude 使用 anthropic-messages 协议,baseUrl 不加 /v1
        "baseUrl": "<https://api.88api.shop>",
        "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.shop/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.shop/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
          }
        ]
      }
    }
  }
}

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

五、配置鉴权文件 auth-profiles.json

5.1 找到鉴权文件

  • WindowsC:\\\\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 <http://127.0.0.1:18789>

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 之间自由切换,不需要维护多套鉴权逻辑。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐