Openclaw一键安装部署（2026年4月最新）

阔别六年CSDN我又回来啦~话不多说开干^_^……1、安装nodejsnode-v25.8.0-x64.msi1安装包下载百度云网盘链接打开下载https://pan.baidu.com/s/1xSF0w1teCnyCxJhJyEKulA?pwd20262安装点击一键安装按默认推荐点击“NEXT”即可注意如下步骤勾选。3验证win r打开cmd输入node -v输入npm -v2、安装GitGit-2.53.0-64-bit.exe1安装包下载百度云网盘链接打开下载https://pan.baidu.com/s/1dv-nlGXE4V8cWFpX6Zif9Q?pwd20262安装点击一键安装按默认推荐点击“NEXT”即可。3验证win r打开cmd输入git -v3、安装openclaw1管理员方式打开CMD2配置NPM国内镜像在CMD中输入命令npm config set registry https://registry.npmmirror.com3执行安装命令在CMD中输入命令npm i -g openclaw4出现如下命令即表示安装成功added 659 packages in 6m127 packages are looking for fundingrun npm fund for details4、openclaw初始配置1管理员方式打开CMD2风险告知输入openclaw onboard通过电脑的左右键选择“Yes”3选择 QuickStart 模式4配置 AI 模型 API KeyModel选择“Z.AIGLM 4.7”method选择API key输入自己的 API KeyOpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费token国外模型成本高门槛也高可选择国内的智谱的 GLM 4.7。如果没有智谱的API Key点击官方地址自己注册账号获取API keyhttps://www.bigmodel.cn/glm-coding?icRBSKXMPNJP智谱的 Key 通常在用户中心里管理登录后进入 API Keys 页面创建即可。访问下面页面https://open.bigmodel.cn/usercenter/apikeys没有登录的先登录注册即可然后点击API Key 创建即可。5选择 AI 模型这里我选择默认的GLM 4.7也是智普当前的旗舰模型。6连接即时通讯平台7选择Skills这里也选择No暂不配置后面通过UI界面进行配置8是否开启Hooks操作步骤先敲空格表示选中当前项再敲回车键此时它会自动再打开一个命令窗口来启动服务9打开Web UI界面浏览器自动打开Web UI界面可以测试输入一下内容5、openclaw使用1启动网关winr打开cmd输入openclaw gateway2将第一次浏览器打开的网页地址保存直接打开刷新即可3如果未保存网址可通过命令行打开winr打开cmd输入openclaw dashboard复制网址浏览器打开即可使用6、FAQ1openclaw模型更换2一、Node.js 安装相关错误1. 安装后命令行无法识别 node / npm错误表现在 CMD 中输入 node -v 或 npm -v提示node不是内部或外部命令原因分析Node.js 安装时未勾选Add to PATH选项或环境变量未正确配置解决方案方法一重新运行 node-vxx.xx-x64.msi 安装包选择Modify勾选Add to PATH选项方法二手动添加环境变量- 右键此电脑 → 属性 → 高级系统设置 → 环境变量- 在系统变量中找到Path双击编辑- 添加路径C:\Program Files\nodejs\- 重启 CMD 后验证node -v2. Node.js 版本不兼容错误表现npm install 报错提示某些原生模块编译失败或版本不支持原因分析OpenClaw 对 Node.js 版本有要求建议使用 Node.js 18 或 LTS 版本解决方案推荐安装 Node.js 18 LTS 或 20 LTS 版本下载地址https://nodejs.org/验证版本node -v3、npm 安装相关错误1. npm install 报错 permission denied / EACCES错误表现npm i -g openclaw 报错提示权限拒绝或 EACCES 错误原因分析Linux/macOS 系统下全局安装需要 sudo 权限Windows 下可能因杀毒软件阻止解决方案Windows以管理员身份运行 CMDmacOS/Linux使用 sudo npm i -g openclaw或配置 npm 全局目录到用户目录npm config set prefix ~/.npm-global2. npm install 报错 registry error / ETIMEDOUT错误表现npm install 失败提示连接 registry.npmjs.org 超时原因分析网络问题访问 npm 官方源速度慢或被防火墙拦截解决方案配置国内镜像源推荐npm config set registry https://registry.npmmirror.com配置完成后重新执行安装命令3. npm install 报错 EINTEGRITY / checksum 对不上错误表现npm install 报错提示 EINTEGRITY 或 checksum 校验失败原因分析npm 缓存损坏或网络传输导致文件损坏解决方案清理 npm 缓存npm cache clean --force删除 node_modules如有和 package-lock.json重新执行 npm install4、OpenClaw 特定错误1. openclaw command not found错误表现安装成功后输入 openclaw 命令提示找不到命令原因分析Node.js 全局 bin 目录未加入 PATH 环境变量解决方案重新运行 Node.js 安装程序勾选Add to PATH或手动添加 npm 全局 bin 路径到环境变量- 获取 npm 全局路径npm config get prefix- 将得到的路径下的 bin 目录添加到 PATH2. openclaw onboard 报错 / 无响应错误表现输入 openclaw onboard 后程序无响应或报错退出原因分析可能是 API Key 配置问题、网络连接问题或配置文件损坏解决方案检查 API Key 是否正确配置确保网络可以正常访问 AI 模型服务商删除配置文件后重新运行 openclaw onboard- 配置文件位置~/.openclaw/config.json3. 启动网关报错 openclaw gateway错误表现输入 openclaw gateway 后报错或闪退原因分析端口被占用、配置文件错误或权限不足解决方案检查端口占用netstat -ano | findstr :18792如端口被占用修改 OpenClaw 配置文件中的端口以管理员身份运行 CMD检查配置文件~/.openclaw/config.json4. Web UI 无法打开 / 空白页面错误表现浏览器打开 OpenClaw Web UI 地址显示空白或连接失败原因分析网关未启动、防火墙拦截或浏览器缓存问题解决方案确保 OpenClaw 网关已启动openclaw gateway检查防火墙设置允许 openclaw 相关的程序通过清除浏览器缓存或使用无痕模式尝试尝试其他浏览器Chrome / Edge / Firefox5、AI 模型配置相关错误1. API Key 无效 / 认证失败错误表现OpenClaw 连接 AI 模型时报错提示 API Key 无效或认证失败原因分析API Key 填写错误、Key 已过期或账户余额不足解决方案登录 AI 模型服务商后台检查 API Key 是否正确确认账户有足够余额或套餐额度重新生成 API Key 并更新到 OpenClaw 配置中2. 模型调用超时 / 请求失败错误表现AI 模型响应慢或提示请求失败原因分析网络问题、模型服务端负载过高或触发了限流解决方案检查网络连接是否稳定等待一段时间后重试避免限流触发考虑更换其他 AI 模型服务商6、Windows 系统特定问题1. npm install 报 ENOENT 错误错误表现npm install 报错提示 ENOENT: no such file or directory原因分析路径过长、临时文件夹权限问题或磁盘空间不足解决方案清理临时文件夹%TEMP%确保磁盘有足够空间建议至少 5GB 可用空间将项目目录移动到更短的路径下2. 杀毒软件误报拦截错误表现npm install 或 openclaw 相关程序被杀毒软件拦截删除原因分析部分杀毒软件对 Node.js 相关工具存在误报解决方案临时关闭杀毒软件后重新安装将 Node.js 和 npm 添加到杀毒软件白名单安装完成后恢复杀毒软件7、通用排查流程1. 检查 Node.js 版本node -vnpm -v2. 检查网络连接ping npmjs.org3. 清理缓存后重试npm cache clean --force4. 以管理员身份运行 CMD5. 查看详细错误日志npm install --verbose6. 查看 OpenClaw 官方文档或社区获取帮助