前言这篇文章整理了我自己亲测有效的完整流程从Node.js安装到OpenClaw配置再到API接口对接每个步骤都标了关键注意点。不用海外账号国内环境就能直接跑适合想省时间少踩坑的朋友。正文一、准备工作安装Node.jsOpenClaw依赖Node.js环境首先确保本地已安装**Node.js 18**版本。如果还没安装访问Node.js官网https://nodejs.org推荐下载LTS版建议20.x LTS双击安装时全部默认Next即可。安装完成后打开终端Windows用PowerShell或CMDMac/Linux用Terminal输入以下命令验证是否安装成功node-v# 输出示例v20.11.0版本号可能因安装版本不同略有差异npm-v# 输出示例10.2.4同上看到版本号输出说明Node.js已安装就绪可以开始下一步。二、安装OpenClaw并初始化第一步安装OpenClaw确保Node.js安装成功后在终端执行以下命令全局安装OpenClawnpminstall-gopenclawlatest执行引导初始化openclaw onboard⚠️ 初始化完成后终端会输出版本号和成功提示。如果出现command not found错误先检查Node.js是否正确安装或确认npm全局路径是否已添加到系统PATH中。这一步完成后OpenClaw的基础框架就搭建好了接下来需要配置模型和API接口。第二步修改主配置文件openclaw.jsonOpenClaw的核心配置文件需要手动修改文件路径根据系统不同有所区别WindowsC:\Users\你的用户名\.openclaw\openclaw.json将“你的用户名”替换为实际系统用户名Mac / 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}]}}}}配置文件修改完成后保存并关闭接下来需要配置API鉴权信息。第三步配置鉴权文件auth-profiles.json1. 获取API Key这里需要用到API接口服务我选择88API作为中转官网https://api.88api.shop主要是为了省去海外账号注册和翻墙麻烦可调用多个主流模型且一个Key可统一管理切换模型只需改配置。当然你也可以用其他中转服务只需对应修改baseUrl和key即可。获取88API Key的步骤1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 填写鉴权文件鉴权文件路径WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.jsonMac / Linux~/.openclaw/agents/main/agent/auth-profiles.json用文本编辑器打开将从88API获取的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. 访问控制台打开浏览器访问http://127.0.0.1:18789/即可看到OpenClaw的Web控制台界面。3. 测试连通性在控制台的对话框中输入简单问题例如“你是谁”如果能收到AI的正常回复说明配置成功模型已通过88API接口接入。⚠️ 常见问题排查若提示401 Unauthorized检查auth-profiles.json中的Key是否填写正确若提示Connection refused确认Gateway服务是否已启动终端是否显示“Gateway running”。总结到这里OpenClaw的安装和88API配置就全部完成了。整个过程最关键的是配置文件的路径和API Key的填写只要注意这两点基本能一次跑通。这篇教程从Node.js准备到最终验证覆盖了所有必要步骤特别适合不想在环境配置上浪费时间的朋友。如果遇到其他问题欢迎在评论区留言交流我会尽量回复。
OpenClaw+88API实现多模型本地调用：保姆级配置步骤（亲测有效）
前言这篇文章整理了我自己亲测有效的完整流程从Node.js安装到OpenClaw配置再到API接口对接每个步骤都标了关键注意点。不用海外账号国内环境就能直接跑适合想省时间少踩坑的朋友。正文一、准备工作安装Node.jsOpenClaw依赖Node.js环境首先确保本地已安装**Node.js 18**版本。如果还没安装访问Node.js官网https://nodejs.org推荐下载LTS版建议20.x LTS双击安装时全部默认Next即可。安装完成后打开终端Windows用PowerShell或CMDMac/Linux用Terminal输入以下命令验证是否安装成功node-v# 输出示例v20.11.0版本号可能因安装版本不同略有差异npm-v# 输出示例10.2.4同上看到版本号输出说明Node.js已安装就绪可以开始下一步。二、安装OpenClaw并初始化第一步安装OpenClaw确保Node.js安装成功后在终端执行以下命令全局安装OpenClawnpminstall-gopenclawlatest执行引导初始化openclaw onboard⚠️ 初始化完成后终端会输出版本号和成功提示。如果出现command not found错误先检查Node.js是否正确安装或确认npm全局路径是否已添加到系统PATH中。这一步完成后OpenClaw的基础框架就搭建好了接下来需要配置模型和API接口。第二步修改主配置文件openclaw.jsonOpenClaw的核心配置文件需要手动修改文件路径根据系统不同有所区别WindowsC:\Users\你的用户名\.openclaw\openclaw.json将“你的用户名”替换为实际系统用户名Mac / 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}]}}}}配置文件修改完成后保存并关闭接下来需要配置API鉴权信息。第三步配置鉴权文件auth-profiles.json1. 获取API Key这里需要用到API接口服务我选择88API作为中转官网https://api.88api.shop主要是为了省去海外账号注册和翻墙麻烦可调用多个主流模型且一个Key可统一管理切换模型只需改配置。当然你也可以用其他中转服务只需对应修改baseUrl和key即可。获取88API Key的步骤1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 填写鉴权文件鉴权文件路径WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.jsonMac / Linux~/.openclaw/agents/main/agent/auth-profiles.json用文本编辑器打开将从88API获取的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. 访问控制台打开浏览器访问http://127.0.0.1:18789/即可看到OpenClaw的Web控制台界面。3. 测试连通性在控制台的对话框中输入简单问题例如“你是谁”如果能收到AI的正常回复说明配置成功模型已通过88API接口接入。⚠️ 常见问题排查若提示401 Unauthorized检查auth-profiles.json中的Key是否填写正确若提示Connection refused确认Gateway服务是否已启动终端是否显示“Gateway running”。总结到这里OpenClaw的安装和88API配置就全部完成了。整个过程最关键的是配置文件的路径和API Key的填写只要注意这两点基本能一次跑通。这篇教程从Node.js准备到最终验证覆盖了所有必要步骤特别适合不想在环境配置上浪费时间的朋友。如果遇到其他问题欢迎在评论区留言交流我会尽量回复。
