前言最近想上手OpenClaw却被环境配置劝退不少朋友反馈要么是Node.js版本不对要么是配置文件改半天还是连不上模型尤其国内环境下找靠谱的API接入方案更是头疼。其实核心问题就两个一是步骤不完整二是API对接太绕。这篇文章我会把自己从安装到成功调用Claude/GPT的全过程拆解开每个配置文件怎么改、Key怎么填、启动后怎么验证都尽量写清楚希望能帮你少踩点坑。正文一、准备工作安装Node.js开始前必须确保本地已安装Node.js 18这是OpenClaw运行的基础环境。如果还没安装直接访问Node.js官网https://nodejs.org推荐下载LTS版建议20.x LTS双击安装时一路默认Next即可无需额外配置。安装完成后打开终端Windows用PowerShell或CMDMac/Linux用Terminal输入以下命令验证是否安装成功node-v# 输出示例v20.11.0版本号需≥18.0.0npm-v# 输出示例10.2.4npm会随Node.js自动安装如果能正常输出版本号说明Node.js环境没问题可以进入下一步。二、安装OpenClaw并初始化第一步安装OpenClaw确认Node.js就绪后在终端执行以下命令全局安装OpenClawnpminstall-gopenclawlatest安装完成后运行初始化命令openclaw onboard⚠️ 执行成功后终端会输出版本号和初始化成功的提示。如果出现command not found错误先检查Node.js是否安装正确或尝试重启终端npm全局路径可能未及时加载。这一步会帮我们搭建好OpenClaw的基础框架接下来需要配置模型和API信息。第二步修改主配置文件openclaw.jsonOpenClaw的核心配置文件需要手动修改路径根据系统不同WindowsC:\Users\你的用户名\.openclaw\openclaw.json把你的用户名替换成实际系统用户名Mac / Linux~/.openclaw/openclaw.json~代表用户根目录用文本编辑器打开文件将models和auth部分替换为以下内容直接覆盖原内容即可{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}]}}}}⚠️ 注意两个细节primary字段决定默认模型比如想默认用GPT-5.2改成primary: api-proxy-gpt/gpt-5.2即可Mac用户需要把workspace路径改成自己的目录例如/Users/你的用户名/clawdWindows用户保持默认路径即可。第三步配置鉴权文件auth-profiles.json这一步需要填入API Key才能调用模型我这里使用88API作为中转服务官网https://api.88api.shop主要是为了省去海外账号注册和翻墙的麻烦国内直连即可且一个Key能管理多个模型配置起来更方便。推荐大家可以试试或者大家也可以用自己的。1. 获取API Key以88api为例获取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用文本编辑器打开将获取到的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// 替换成你的Gemini模型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服务openclaw gateway--port18789启动成功后终端会显示Gateway running on http://127.0.0.1:18789说明服务已正常运行不要关闭终端否则服务会停止。2. 访问Web控制台打开浏览器输入http://127.0.0.1:18789/即可看到OpenClaw的Web操作界面。3. 验证模型连通性在Web界面的对话框中输入简单问题例如你是谁如果能收到AI回复说明配置成功。⚠️ 常见问题排查若提示401 Unauthorized检查auth-profiles.json中的Key是否填错或过期若提示Connection refused确认Gateway服务是否在运行终端是否保持打开状态。总结到这里OpenClaw的安装和88api配置就完成了。核心步骤其实就四个装Node.js、装OpenClaw、改配置文件、填Key启动。最容易卡壳的地方是配置文件路径和Key的填写只要按步骤核对路径、替换占位符基本都能跑通。如果过程中遇到其他问题欢迎在评论区留言我会尽量回复。希望这篇教程能帮你少走点弯路顺利用上OpenClaw~
别再到处拼教程了！OpenClaw+88api一站式配置指南（手把手教你改配置、填Key、验连通）
发布时间：2026/5/27 19:03:24
前言最近想上手OpenClaw却被环境配置劝退不少朋友反馈要么是Node.js版本不对要么是配置文件改半天还是连不上模型尤其国内环境下找靠谱的API接入方案更是头疼。其实核心问题就两个一是步骤不完整二是API对接太绕。这篇文章我会把自己从安装到成功调用Claude/GPT的全过程拆解开每个配置文件怎么改、Key怎么填、启动后怎么验证都尽量写清楚希望能帮你少踩点坑。正文一、准备工作安装Node.js开始前必须确保本地已安装Node.js 18这是OpenClaw运行的基础环境。如果还没安装直接访问Node.js官网https://nodejs.org推荐下载LTS版建议20.x LTS双击安装时一路默认Next即可无需额外配置。安装完成后打开终端Windows用PowerShell或CMDMac/Linux用Terminal输入以下命令验证是否安装成功node-v# 输出示例v20.11.0版本号需≥18.0.0npm-v# 输出示例10.2.4npm会随Node.js自动安装如果能正常输出版本号说明Node.js环境没问题可以进入下一步。二、安装OpenClaw并初始化第一步安装OpenClaw确认Node.js就绪后在终端执行以下命令全局安装OpenClawnpminstall-gopenclawlatest安装完成后运行初始化命令openclaw onboard⚠️ 执行成功后终端会输出版本号和初始化成功的提示。如果出现command not found错误先检查Node.js是否安装正确或尝试重启终端npm全局路径可能未及时加载。这一步会帮我们搭建好OpenClaw的基础框架接下来需要配置模型和API信息。第二步修改主配置文件openclaw.jsonOpenClaw的核心配置文件需要手动修改路径根据系统不同WindowsC:\Users\你的用户名\.openclaw\openclaw.json把你的用户名替换成实际系统用户名Mac / Linux~/.openclaw/openclaw.json~代表用户根目录用文本编辑器打开文件将models和auth部分替换为以下内容直接覆盖原内容即可{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}]}}}}⚠️ 注意两个细节primary字段决定默认模型比如想默认用GPT-5.2改成primary: api-proxy-gpt/gpt-5.2即可Mac用户需要把workspace路径改成自己的目录例如/Users/你的用户名/clawdWindows用户保持默认路径即可。第三步配置鉴权文件auth-profiles.json这一步需要填入API Key才能调用模型我这里使用88API作为中转服务官网https://api.88api.shop主要是为了省去海外账号注册和翻墙的麻烦国内直连即可且一个Key能管理多个模型配置起来更方便。推荐大家可以试试或者大家也可以用自己的。1. 获取API Key以88api为例获取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用文本编辑器打开将获取到的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// 替换成你的Gemini模型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服务openclaw gateway--port18789启动成功后终端会显示Gateway running on http://127.0.0.1:18789说明服务已正常运行不要关闭终端否则服务会停止。2. 访问Web控制台打开浏览器输入http://127.0.0.1:18789/即可看到OpenClaw的Web操作界面。3. 验证模型连通性在Web界面的对话框中输入简单问题例如你是谁如果能收到AI回复说明配置成功。⚠️ 常见问题排查若提示401 Unauthorized检查auth-profiles.json中的Key是否填错或过期若提示Connection refused确认Gateway服务是否在运行终端是否保持打开状态。总结到这里OpenClaw的安装和88api配置就完成了。核心步骤其实就四个装Node.js、装OpenClaw、改配置文件、填Key启动。最容易卡壳的地方是配置文件路径和Key的填写只要按步骤核对路径、替换占位符基本都能跑通。如果过程中遇到其他问题欢迎在评论区留言我会尽量回复。希望这篇教程能帮你少走点弯路顺利用上OpenClaw~
