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

前言最近想试试 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 或 CMDMac/Linux 用终端输入以下命令验证是否安装成功node-v# 输出示例v20.11.0版本号 18 即可npm-v# 输出示例10.2.4npm 会随 Node.js 一起安装如果能正常输出版本号说明 Node.js 环境没问题可以继续下一步。二、安装 OpenClaw 并初始化第一步安装 OpenClaw确保 Node.js 安装完成后在终端执行以下两条命令全局安装 OpenClawnpminstall-gopenclawlatest执行引导初始化openclaw onboard⚠️ 初始化成功后终端会输出版本号和 “初始化成功” 的提示。如果出现command not found错误先检查 Node.js 是否安装正确或者 npm 全局路径是否添加到系统环境变量Windows 用户可重启终端再试。到这里OpenClaw 的基础框架就搭建好了接下来需要配置模型调用相关的参数。三、修改主配置文件openclaw.jsonOpenClaw 的核心配置都在openclaw.json文件里需要根据系统类型找到文件位置WindowsC:\Users\你的用户名\.openclaw\openclaw.json把 “你的用户名” 换成实际系统用户名Mac / Linux~/.openclaw/openclaw.json~代表用户根目录用记事本或 VS Code 打开文件将models和auth部分替换为以下内容直接覆盖原内容即可⚠️ 注意两个关键配置primary字段决定默认使用的模型比如想默认用 GPT-5.2就改成primary: api-proxy-gpt/gpt-5.2Mac/Linux 用户需要把workspace路径改成自己的实际目录比如/Users/你的用户名/clawdWindows 用户默认路径不用改{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.json1. 获取 API Key模型调用需要 API Key我这里直接用 88api 作为接口中转官网https://api.88api.shop主要是省去了海外账号注册和网络配置的麻烦一个 API Key 就能接入多个主流模型本地统一管理也方便。获取 Key 的步骤如下以 88api 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 填写鉴权文件找到auth-profiles.json文件路径和系统有关WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.jsonMac / 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总结到这里 OpenClaw 的安装和 88api 配置就全部完成了。核心步骤其实就三步装 Node.js、改配置文件、填 API Key整个过程不复杂主要注意路径和 Key 的对应关系。国内环境下调用 AI 模型确实容易踩坑这篇教程尽量把每个细节说清楚希望能帮你少走弯路。如果遇到其他问题欢迎在评论区留言我会尽量回复。