OpenClaw配置总踩坑？2026手把手教程：从Node.js安装到多模型API对接（亲测跑通）

前言最近发现不少朋友想尝试OpenClaw这类AI工具但总卡在环境配置上——不是Node版本不对就是API对接失败教程东拼西凑还不一定能用。作为踩过坑的过来人我整理了这篇从0到1的完整实操文带你一步步装好OpenClaw并接入多模型接口尽量让每个步骤都清晰可复制避免来回折腾。正文一、准备工作安装Node.jsOpenClaw依赖Node.js环境首先确保本地已安装Node.js 18。如果尚未安装访问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一起安装二、安装OpenClaw并初始化第一步安装OpenClaw确保Node.js安装成功后在终端执行以下命令全局安装OpenClawnpminstall-gopenclawlatest执行引导初始化openclaw onboard⚠️ 初始化成功后终端会输出版本号和成功提示。如果出现command not found检查Node.js是否正确安装或npm全局路径是否在系统PATH中可重启终端再试。第二步修改主配置文件openclaw.json初始化完成后需要修改核心配置文件添加模型和API信息。配置文件路径WindowsC:\Users\你的用户名\.openclaw\openclaw.jsonMac / Linux~/.openclaw/openclaw.json用文本编辑器打开文件将models和auth部分替换为以下内容完整配置代码⚠️ 注意primary字段决定默认模型例如想默认用GPT-5.2可改为primary: api-proxy-gpt/gpt-5.2Mac用户需将workspace路径改为自己的工作目录如/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}]}}}}第三步配置鉴权文件auth-profiles.json这一步需要填入API Key实现模型接口的鉴权。1. 获取API Key我这里用的是 API中转服务来简化多模型接入网址https://api.88api.shop主要是为了减少环境配置和账号管理的麻烦可以试试或者大家也可以用自己熟悉的。具体步骤1.访问88apihttps://api.88api.shop注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。2. 编辑鉴权文件鉴权文件路径WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.jsonMac / Linux~/.openclaw/agents/main/agent/auth-profiles.json打开文件将获取到的API Key填入对应模型的key字段{version:1,profiles:{api-proxy-gpt:default:{type:api_key,provider:api-proxy-gpt,key:sk-your-unique-gpt-key-here// 替换为你的API Key},api-proxy-claude:default:{type:api_key,provider:api-proxy-claude,key:sk-your-unique-claude-key-here// 替换为你的API Key},api-proxy-google:default:{type:api_key,provider:api-proxy-google,key:sk-your-unique-google-key-here// 替换为你的API Key},api-proxy-deepseek:default:{type:api_key,provider:api-proxy-deepseek,key:sk-your-unique-deepseek-key-here// 替换为你的API 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中的API Key是否填写正确。若提示Connection refused确认Gateway服务是否正常运行终端是否显示服务启动中。总结到这里OpenClaw的安装、配置和模型接入就完成了。核心步骤是Node.js环境准备、OpenClaw初始化、配置文件修改和API Key填入只要按步骤操作基本能避免大部分常见问题。如果启动或调用时遇到其他报错欢迎在评论区留言我们一起排查解决。