当前位置：首页 > news >正文

OpenClaw+88api保姆级教程：国内直连 Claude/GPT 模型，一篇搞定环境配置（2026实测可用）

news 2026/5/28 19:47:51

前言

最近想试试 OpenClaw 这个工具，但找了一圈教程，要么是版本太旧跑不通，要么就是卡在模型调用的网络和账号问题上。作为非技术背景的人，最怕的就是对着教程一步步做，结果卡在某个配置页面动弹不得。

所以我整理了这篇从 0 到 1 的实操文，包含 Node.js 环境准备、OpenClaw 安装、配置文件修改，以及用 88api 作为接口中转来解决国内调用问题。全程亲测，跟着做基本能避开大部分坑，十几分钟就能让 AI 模型跑起来。

正文

一、准备工作：安装 Node.js

开始前必须确保本地已安装Node.js 18+，这是 OpenClaw 运行的基础环境。

如果还没安装，直接访问 Node.js 官网：https://nodejs.org，推荐下载LTS 版（建议 20.x LTS），双击安装包后一路点 “Next”（默认配置即可，不用改路径）。

安装完成后，打开终端（Windows 用 PowerShell 或 CMD，Mac/Linux 用终端），输入以下命令验证是否安装成功：

node-v# 输出示例：v20.11.0（版本号 >=18 即可）npm-v# 输出示例：10.2.4（npm 会随 Node.js 一起安装）

如果能正常输出版本号，说明 Node.js 环境没问题，可以继续下一步。

二、安装 OpenClaw 并初始化

第一步：安装 OpenClaw

确保 Node.js 安装完成后，在终端执行以下两条命令：

全局安装 OpenClaw：

npminstall-gopenclaw@latest

执行引导初始化：

openclaw onboard

⚠️ 初始化成功后，终端会输出版本号和 “初始化成功” 的提示。如果出现command not found错误，先检查 Node.js 是否安装正确，或者 npm 全局路径是否添加到系统环境变量（Windows 用户可重启终端再试）。

到这里，OpenClaw 的基础框架就搭建好了，接下来需要配置模型调用相关的参数。

三、修改主配置文件`openclaw.json`

OpenClaw 的核心配置都在openclaw.json文件里，需要根据系统类型找到文件位置：

Windows：C:\Users\你的用户名\.openclaw\openclaw.json（把 “你的用户名” 换成实际系统用户名）
Mac / Linux：~/.openclaw/openclaw.json（~代表用户根目录）

用记事本或 VS Code 打开文件，将models和auth部分替换为以下内容（直接覆盖原内容即可）：

⚠️ 注意两个关键配置：
"primary"字段决定默认使用的模型，比如想默认用 GPT-5.2，就改成"primary": "api-proxy-gpt/gpt-5.2"
Mac/Linux 用户需要把"workspace"路径改成自己的实际目录，比如"/Users/你的用户名/clawd"（Windows 用户默认路径不用改）

{"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.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":{"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 Key 才能调用模型。

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

1. 获取 API Key

模型调用需要 API Key，我这里直接用 88api 作为接口中转（官网：https://api.88api.shop），主要是省去了海外账号注册和网络配置的麻烦，一个 API Key 就能接入多个主流模型，本地统一管理也方便。

获取 Key 的步骤如下（以 88api 为例）：
获取Key的步骤：

注册并登录后，点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
1. 根据需要调用的模型选择分组
  a. claude 模型建议使用 calude code 分组、
  b. gpt 模型建议使用 codex分组
2. 可通过平台的模型广场查看不同模型支持的分组
3. 若在使用中出现上游分组饱和，请切换分组使用
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY

2. 填写鉴权文件

找到auth-profiles.json文件（路径和系统有关）：

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"// 替换成你的 GPT 分组 Key},"api-proxy-claude:default":{"type":"api_key","provider":"api-proxy-claude","key":"sk-your-unique-claude-key-here"// 替换成你的 Claude 分组 Key},"api-proxy-google:default":{"type":"api_key","provider":"api-proxy-google","key":"sk-your-unique-google-key-here"// 替换成你的 Google 分组 Key},"api-proxy-deepseek:default":{"type":"api_key","provider":"api-proxy-deepseek","key":"sk-your-unique-deepseek-key-here"// 替换成你的 Deepseek 分组 Key}}}

⚠️ 注意：Key 必须和配置文件中的模型分组对应，比如用 Claude 模型就必须填 Claude 分组的 Key，否则会调用失败。

五、启动并验证服务

1. 启动 Gateway 服务

在终端输入以下命令启动 OpenClaw 服务：

openclaw gateway--port18789

启动成功后，终端会显示类似Gateway running on http://127.0.0.1:18789的提示，说明服务已经在本地运行。

2. 访问控制台并测试

打开浏览器，访问http://127.0.0.1:18789/，会看到 OpenClaw 的 Web 控制台界面。在对话框里输入简单问题（比如 “你是谁”），如果能收到 AI 的回复，说明模型调用成功。

⚠️ 常见问题排查：
如果提示401 Unauthorized：检查auth-profiles.json里的 Key 是否填写正确，或分组是否匹配
如果提示Connection refused：确认 Gateway 服务是否在运行（终端不能关闭）
如果回复超时：可能是网络问题，或 88api 分组饱和，可尝试切换分组重新生成 Key