OpenClaw安装失败/卡住不动怎么办？常见报错汇总+解决方案

OpenClaw交流
, , ,
1

装OpenClaw卡在npm install这步快20分钟了，进度条不动……是不是挂了？

有没有人遇到过类似情况？各种安装报错怎么解决？

2

npm install慢大概率是网络问题，换淘宝源：npm config set registry https://registry.npmmirror.com 然后重试。

3

常见安装问题汇总：

1. npm install卡住/超时

  • 原因：npmjs.org在国内访问慢
  • 解决：换淘宝镜像源

2. node-gyp编译失败

  • 原因：缺少C++编译工具
  • Windows解决：安装Visual Studio Build Tools
  • Mac解决：xcode-select --install
  • Linux解决：sudo apt install build-essential

3. Python not found

  • 原因：Python没加入PATH
  • 解决：重装Python，勾选Add to PATH

4. 版本不兼容

  • Node版本太低（需要18+）
  • Python版本太低（需要3.10+）
  • 解决：更新到最新LTS版本

5. 权限错误（EACCES）

  • 原因：npm全局安装需要权限
  • 解决：Linux/Mac用 sudo，或者配置npm全局路径到用户目录
4

Windows上最常见的坑是杀毒软件拦截——有些杀软会把npm下载的二进制文件标记为可疑并删除，导致安装失败。

解决：安装时临时关闭杀毒软件，或者把OpenClaw目录加入白名单。

5

如果实在装不上，最简单的方案：直接用Molili。当贝做的中文版OpenClaw，下载安装包双击就能用，不需要npm、不需要Python、不需要命令行。我就是被原版安装劝退了才转的Molili​:sweat_smile:

6

我的报错是 ERR_SOCKET_TIMEOUT，换了淘宝源之后秒装完！感谢:tada: