10 分钟搞定!OpenClaw+88API 中转实现 Claude/GPT 稳定调用(附2026 最新教程)
前言:一个让国内开发者头疼的老问题
相信不少开发者都遇到过这样的困境:想用 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 会在用户目录下自动生成配置文件夹:
- Windows:
C:\\\\Users\\\\你的用户名\\\\.openclaw\\\\ - Mac / Linux:
~/.openclaw/
四、配置主文件 openclaw.json
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-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-claude的baseUrl不带/v1后缀,这是 Anthropic Messages 协议的特殊要求,其他 Provider 均需加/v1。
五、配置鉴权文件 auth-profiles.json
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 <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 之间自由切换,不需要维护多套鉴权逻辑。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)