从0到1搞定OpenClaw！88api中转配置全流程，小白也能照着做（附完整代码）

前言这篇文章我把OpenClaw自己踩过的坑整理成了实操步骤从Node.js安装到88api接口对接每个配置文件怎么改、Key填哪里都写清楚了跟着做基本不用额外查资料。正文一、准备工作安装Node.jsOpenClaw依赖Node.js 18环境先确认本地是否已安装。1. 下载安装Node.js如果没安装访问Node.js官网推荐下载LTS版建议20.x LTS。双击安装包后一路Next默认配置即可无需额外勾选。2. 验证安装打开终端Windows用PowerShell/CMDMac/Linux用Terminal输入以下命令检查版本node-v# 输出示例v20.11.0版本18即可npm-v# 输出示例10.2.4npm版本会随Node.js自动安装二、安装OpenClaw并初始化Node.js就绪后开始安装OpenClaw并搭建基础框架。第一步安装OpenClaw终端执行以下命令# 全局安装最新版npminstall-gopenclawlatest# 执行引导初始化openclaw onboard⚠️ 成功后终端会输出版本号和初始化成功提示。如果报command not found检查Node.js是否安装正确或npm全局路径是否加入系统环境变量可重启终端再试。第二步修改主配置文件openclaw.json初始化后需要配置模型列表和基础参数配置文件路径WindowsC:\Users\你的用户名\.openclaw\openclaw.jsonMac/Linux~/.openclaw/openclaw.json用文本编辑器打开将models和auth部分替换为以下内容完整配置已包含GPT、Claude、Gemini等模型{agents:{defaults:{model:{primary:api-proxy-claude/claude-sonnet-4-5-20250929// 默认模型可改为其他模型ID},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,// Windows路径Mac/Linux需改为/Users/你的用户名/clawdmaxConcurrent: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,// 88api接口地址api:openai-completions,models:[{id:gpt-5.2,name:GPT-5.2,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,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,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,contextWindow:2000000,maxTokens:8192}]}}}}⚠️ 重点修改primary默认模型想优先用GPT-5.2就改成api-proxy-gpt/gpt-5.2workspace工作目录路径Mac/Linux用户需替换为自己的目录如/Users/xxx/clawd第三步配置鉴权文件auth-profiles.json模型接口需要API Key才能调用这里用88api(官网https://api.88api.shop)作为中转国内直连无需海外账号 。有额度大家可以试试或者大家也可以用自己的。1. 获取88api的API Key注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交点击复制按钮复制API令牌也就是API KEY2. 填写鉴权文件鉴权文件路径WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.jsonMac/Linux~/.openclaw/agents/main/agent/auth-profiles.json打开文件将复制的Key填入对应模型的key字段{version:1,profiles:{api-proxy-gpt:default:{type:api_key,provider:api-proxy-gpt,key:sk-your-gpt-key},api-proxy-claude:default:{type:api_key,provider:api-proxy-claude,key:sk-your-claude-key},api-proxy-google:default:{type:api_key,provider:api-proxy-google,key:sk-your-google-key},api-proxy-deepseek:default:{type:api_key,provider:api-proxy-deepseek,key:sk-your-deepseek-key}}}⚠️ 如果只需要某一个模型比如Claude其他模型的key可以留空不影响使用。第四步启动并验证配置完成后启动服务并测试是否正常工作。1. 启动Gateway服务终端执行命令openclaw gateway--port18789# 指定端口18789可自定义成功启动后终端会显示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服务是否在运行终端不要关闭总结OpenClaw配置其实不难核心就三步装好Node.js基础环境、改对配置文件尤其是模型路径和工作目录、填对API Key。用88api中转主要是图个方便国内直连不用折腾网络一个Key管理多个模型也省事儿。如果启动后遇到模型调用失败先检查配置文件的baseUrl是否正确就是https://api.88api.shop那行再核对Key有没有复制全。按步骤走下来基本10分钟就能跑通。有问题欢迎留言我看到会回复~