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

HuaCode2026-04-06 12:49

阔别六年，CSDN，我又回来啦~

话不多说，开干^_^......

1 、安装nodejs（node-v25.8.0-x64.msi）

（1）安装包下载：百度云网盘链接打开下载

https://pan.baidu.com/s/1xSF0w1teCnyCxJhJyEKulA?pwd=2026

（2）安装：点击一键安装

按默认推荐点击"NEXT"即可，注意如下步骤勾选。

（3）验证：win + r打开cmd

输入node -v

输入npm -v

2 、安装Git（Git-2.53.0-64-bit.exe）

（1）安装包下载：百度云网盘链接打开下载

https://pan.baidu.com/s/1dv-nlGXE4V8cWFpX6Zif9Q?pwd=2026

（2）安装：点击一键安装

按默认推荐点击"NEXT"即可。

（3）验证：win + r打开cmd

输入git -v

3 、安装openclaw

（1）管理员方式打开CMD

（2）配置NPM国内镜像（在CMD中输入命令）

npm config set registry https://registry.npmmirror.com

（3）执行安装命令（在CMD中输入命令）

npm i -g openclaw

（4）出现如下命令即表示安装成功

added 659 packages in 6m

127 packages are looking for funding

run `npm fund` for details

4 、openclaw初始配置

（1）管理员方式打开CMD

（2）风险告知

输入openclaw onboard，通过电脑的左右键选择"Yes"

（3）选择 QuickStart 模式

（4）配置 AI 模型 API Key

Model选择"Z.AI（GLM 4.7）"，method选择API key

输入自己的 API Key：

  • OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费token，国外模型成本高，门槛也高，可选择国内的智谱的 GLM 4.7。
  • 如果没有智谱的API Key，点击官方地址自己注册账号获取API key：https://www.bigmodel.cn/glm-coding?ic=RBSKXMPNJP
  • 智谱的 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）启动网关（win+r打开cmd）

输入openclaw gateway

（2）将第一次浏览器打开的网页地址保存，直接打开刷新即可

（3）如果未保存网址，可通过命令行打开（win+r打开cmd）

输入openclaw dashboard，复制网址浏览器打开即可使用

6 、FAQ

（1）openclaw模型更换

**（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 -v

2. Node.js 版本不兼容

**错误表现：**npm install 报错，提示某些原生模块编译失败或版本不支持

**原因分析：**OpenClaw 对 Node.js 版本有要求，建议使用 Node.js 18+ 或 LTS 版本

解决方案：

  • 推荐安装 Node.js 18 LTS 或 20 LTS 版本
  • 下载地址：https://nodejs.org/
  • 验证版本：node -v

（3）、npm 安装相关错误

1. npm install 报错 permission denied / EACCES

**错误表现：**npm i -g openclaw 报错，提示权限拒绝或 EACCES 错误

**原因分析：**Linux/macOS 系统下，全局安装需要 sudo 权限；Windows 下可能因杀毒软件阻止

解决方案：

  • Windows：以管理员身份运行 CMD
  • macOS/Linux：使用 sudo npm i -g openclaw
  • 或配置 npm 全局目录到用户目录

npm config set prefix "~/.npm-global"

2. npm install 报错 registry error / ETIMEDOUT

**错误表现：**npm install 失败，提示连接 registry.npmjs.org 超时

**原因分析：**网络问题，访问 npm 官方源速度慢或被防火墙拦截

解决方案：

3. npm install 报错 EINTEGRITY / checksum 对不上

**错误表现：**npm install 报错，提示 EINTEGRITY 或 checksum 校验失败

**原因分析：**npm 缓存损坏或网络传输导致文件损坏

解决方案：

  • 清理 npm 缓存：npm cache clean --force
  • 删除 node_modules（如有）和 package-lock.json
  • 重新执行 npm install

（4）、OpenClaw 特定错误

1. openclaw command not found

**错误表现：**安装成功后，输入 openclaw 命令提示找不到命令

**原因分析：**Node.js 全局 bin 目录未加入 PATH 环境变量

解决方案：

  • 重新运行 Node.js 安装程序，勾选"Add to PATH"
  • 或手动添加 npm 全局 bin 路径到环境变量
    • 获取 npm 全局路径：npm config get prefix
    • 将得到的路径下的 bin 目录添加到 PATH

2. openclaw onboard 报错 / 无响应

**错误表现：**输入 openclaw onboard 后程序无响应或报错退出

**原因分析：**可能是 API Key 配置问题、网络连接问题或配置文件损坏

解决方案：

  • 检查 API Key 是否正确配置
  • 确保网络可以正常访问 AI 模型服务商
  • 删除配置文件后重新运行 openclaw onboard
    • 配置文件位置：~/.openclaw/config.json

3. 启动网关报错 openclaw gateway

**错误表现：**输入 openclaw gateway 后报错或闪退

**原因分析：**端口被占用、配置文件错误或权限不足

解决方案：

  • 检查端口占用：netstat -ano | findstr :18792
  • 如端口被占用，修改 OpenClaw 配置文件中的端口
  • 以管理员身份运行 CMD
  • 检查配置文件：~/.openclaw/config.json

4. Web UI 无法打开 / 空白页面

**错误表现：**浏览器打开 OpenClaw Web UI 地址，显示空白或连接失败

**原因分析：**网关未启动、防火墙拦截或浏览器缓存问题

解决方案：

  • 确保 OpenClaw 网关已启动：openclaw gateway
  • 检查防火墙设置，允许 openclaw 相关的程序通过
  • 清除浏览器缓存或使用无痕模式尝试
  • 尝试其他浏览器（Chrome / Edge / Firefox）

（5）、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 -v，npm -v

  2. 检查网络连接：ping npmjs.org

  3. 清理缓存后重试：npm cache clean --force

  4. 以管理员身份运行 CMD

  5. 查看详细错误日志：npm install --verbose

  6. 查看 OpenClaw 官方文档或社区获取帮助

相关推荐
m0_738120722 小时前
网络安全编程——开发一个TCP代理Python实现（二）
python·tcp/ip·web安全
Ulyanov2 小时前
卡尔曼滤波技术博客系列：第四篇：多目标跟踪：数据关联与航迹管理
python·目标跟踪·系统仿真·雷达电子战·仿真引擎
Three～stone3 小时前
MATLAB vs Python 两者区别和安装教程
开发语言·python·matlab
懒猫gg3 小时前
OpenClaw概述
openclaw
soragui3 小时前
【Python】第 1 章：Python 解释器原理
开发语言·python
Ulyanov3 小时前
卡尔曼滤波技术博客系列：第三篇 雷达目标跟踪：运动模型与坐标转换
python·目标跟踪·系统仿真·雷达电子战
nimadan123 小时前
生成剧本杀软件2025推荐，创新剧情设计工具引领潮流
人工智能·python
极光代码工作室3 小时前
基于深度学习的智能垃圾分类系统
python·深度学习·神经网络·机器学习·ai
MediaTea3 小时前
Pandas 操作指南（二）：数据选取与条件筛选
人工智能·python·机器学习·数据挖掘·pandas
热门推荐
01GitHub 镜像站点02Qwen3.5-Omni与Qwen3.6模型全面解析（含测评/案例/使用教程）03OpenClaw 请求超时 llm request timed out 怎么解决？3 种方案实测，附完整排查流程04VMware Workstation Pro 17 虚拟机完整安装教程（2026最新）05【技术干货】Gemma 4 上手深度指南：本地多模态大模型的新基线06最新更新版本，OpenClaw v2026.4.2 深度解读剖析：Task Flow 重磅回归与安全架构的全面硬化07AI 编程效率翻倍：Superpowers Skills 上手清单 + 完整指南08纯 HTML/CSS/JS 实现的高颜值登录页，还会眨眼睛！少女心爆棚！092026年3月AI领域大事件：DeepSeek引领开源风暴10UV安装并设置国内源