前言
最近发现不少朋友想尝试OpenClaw这类AI工具，但总卡在环境配置上——不是Node版本不对，就是API对接失败，教程东拼西凑还不一定能用。
作为踩过坑的过来人，我整理了这篇从0到1的完整实操文，带你一步步装好OpenClaw并接入多模型接口，尽量让每个步骤都清晰可复制，避免来回折腾。
正文
一、准备工作：安装Node.js
OpenClaw依赖Node.js环境，首先确保本地已安装Node.js 18+。
如果尚未安装，访问Node.js官网：https://nodejs.org，推荐下载LTS版（建议20.x LTS），双击安装时全部默认Next即可。
安装完成后，打开终端（Windows用PowerShell或CMD，Mac/Linux用终端），输入以下命令验证：
node-v# 输出示例：v20.11.0（版本18+即可）npm-v# 输出示例：10.2.4（npm会随Node.js一起安装）二、安装OpenClaw并初始化
第一步：安装OpenClaw
确保Node.js安装成功后，在终端执行以下命令：
全局安装OpenClaw：
npminstall-gopenclaw@latest执行引导初始化：
openclaw onboard⚠️ 初始化成功后，终端会输出版本号和成功提示。如果出现
command not found，检查Node.js是否正确安装，或npm全局路径是否在系统PATH中（可重启终端再试）。
第二步：修改主配置文件openclaw.json
初始化完成后，需要修改核心配置文件，添加模型和API信息。
配置文件路径：
- Windows：
C:\Users\你的用户名\.openclaw\openclaw.json - Mac / Linux：
~/.openclaw/openclaw.json
用文本编辑器打开文件，将models和auth部分替换为以下内容（完整配置代码）：
⚠️ 注意
"primary"字段决定默认模型，例如想默认用GPT-5.2，可改为"primary": "api-proxy-gpt/gpt-5.2"；Mac用户需将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.访问88api（https://api.88api.shop），注册登录后，点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写，没有含义，直接点击提交即可。
- 获取 API KEY
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。
- 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
2. 编辑鉴权文件
鉴权文件路径：
- Windows：
C:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.json - Mac / 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填入，只要按步骤操作，基本能避免大部分常见问题。如果启动或调用时遇到其他报错，欢迎在评论区留言，我们一起排查解决。