当前位置：首页 > news >正文

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

news 2026/7/15 0:43:35

前言

最近发现不少朋友想尝试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}}}