前言最近AI工具更新太快很多朋友想试试OpenClaw这类本地代理工具但总卡在环境配置上——不是Node.js版本不对就是模型接口连不通尤其国内用户还得折腾海外账号和网络。其实关键是缺一篇能从头到尾走通的实操文。我花了两天整理出这份教程从Node.js安装到88api接口配置每步都附了实际操作截图和配置代码。用88api做中转是个省心选择国内直连不用翻墙一个Key就能接GPT、Claude等多个模型本地切换模型只改一行配置。如果你也想少踩坑跟着做应该能一次跑通。正文一、准备工作安装Node.jsOpenClaw依赖Node.js环境先确保本地已安装Node.js 18。如果没装去官网 https://nodejs.org 下载LTS版推荐20.x LTS双击安装时一路点Next默认配置就行。安装完成后打开终端Windows用PowerShell/CMDMac/Linux用Terminal输入以下命令验证node-v# 输出示例v20.11.0版本18即可npm-v# 输出示例10.2.4npm版本会随Node.js一起安装二、安装OpenClaw并初始化第一步安装OpenClawNode.js没问题的话终端执行以下两条命令全局安装OpenClawnpminstall-gopenclawlatest执行引导初始化openclaw onboard⚠️ 成功后终端会输出版本号和“初始化成功”提示。如果报command not found检查Node.js是否装对或npm全局路径是否在系统PATH里可重启终端再试。这步完成后OpenClaw的基础框架就搭好了接下来配置模型接口。第二步修改主配置文件openclaw.json配置文件位置WindowsC:\Users\你的用户名\.openclaw\openclaw.jsonMac/Linux~/.openclaw/openclaw.json用记事本或VS Code打开把models和auth部分替换为以下代码直接覆盖原内容⚠️ 注意两个关键配置primary字段是默认模型想默认用GPT-5.2就改成primary: api-proxy-gpt/gpt-5.2Mac用户把workspace: C:\\Users\\admin\\clawd改成自己的目录比如/Users/你的用户名/clawd。{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}]}}}}保存文件这步是核心配置决定了OpenClaw能调用哪些模型。第三步配置鉴权文件auth-profiles.json1. 获取API Key这里用88apihttps://api.88api.shop作为模型接口中转你也可以用其他中转服务替换对应baseUrl和Key即可。它的好处是国内直连不用翻墙一个Key能接多个主流模型省掉注册多个海外账号的麻烦。下面以88 API 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 填写鉴权文件鉴权文件位置WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.jsonMac/Linux~/.openclaw/agents/main/agent/auth-profiles.json打开文件把从88api获取的Key填入对应模型的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}}}⚠️ 如果暂时只用某个模型比如Claude只填对应Key即可其他留空不影响。第四步启动并验证1. 启动Gateway服务终端执行命令openclaw gateway--port18789成功启动后终端会显示Gateway running on http://127.0.0.1:18789保持终端窗口打开不要关闭。2. 访问Web控制台浏览器打开http://127.0.0.1:18789/会看到OpenClaw的Web界面。3. 测试模型连通性在对话框输入问题比如“你是谁”如果AI正常回复说明配置成功。⚠️ 常见问题排查报401 Unauthorized检查auth-profiles.json里的Key是否填对或分组是否匹配模型报Connection refused确认Gateway服务是否在运行终端窗口是否关闭。总结到这里OpenClaw88api的配置就完成了。核心步骤是Node.js环境准备、OpenClaw初始化、配置文件替换和鉴权Key填写重点注意openclaw.json里的默认模型和工作目录以及auth-profiles.json的Key对应关系。国内用户用中转服务确实能省不少事不用折腾海外账号和网络一个Key管理多个模型也方便。如果启动时遇到其他问题欢迎在评论区留言我会尽量回复。