Windows装OpenClaw总失败的解决办法

发布者:智慧产业学院发布时间:2026-03-24浏览次数:390

很多Windows用户在安装OpenClaw时都会遇到同样的问题:按照官方教程用PowerShell执行一键脚本,要么报错、要么卡住、要么装完不能用。反复折腾几小时,最后还是失败。

   其实问题不在你,也不在OpenClaw,而是PowerShell在Windows上的权限、执行策略、网络兼容性天生不友好。

为什么PowerShell装OpenClaw必翻车?

  跟着官方教程走,一到PowerShell就出问题,常见这4类:

1. 执行策略被阻止:系统禁止运行远程脚本,直接报错无法继续。

2. 权限异常:普通权限不够,管理员权限又容易导致目录冲突。

3. 网络问题:国外源下载慢、超时、丢包,安装到一半失败。

4. 环境冲突:旧版Node、缓存、中文路径、杀毒软件拦截,导致安装不完整。

PowerShell是为系统管理设计的,不是为开发工具安装优化的。换一个更兼容的终端,问题直接解决一大半。

替换方案:用Windows终端+国内源,稳定不报错。

用Windows自带的命令提示符CMD或Windows Terminal,配合国内镜像,不走官方PowerShell脚本,全程手动但更稳、更快、更可控。

 第一步:安装正确版本的Node.js(必做)

OpenClaw对Node版本要求严格,必须≥22.x,这是90%的人失败的根源。

   安装完成后,打开CMD(Win+R 输入cmd回车)

输入检查命令:

node -v

npm -v

出现v22.x.x说明成功。

切换国内npm镜像(提速防失败)

CMD里输入下面两行,解决下载慢、超时问题:

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

npm cache clean --force

全局安装OpenClaw(核心步骤)

在CMD里直接输入:

npm install -g openclaw@latest

等待1-3分钟,出现added字样就是成功。

初始化配置

CMD输入:

openclaw onboard

按提示回车即可,新手直接默认配置就能用。

第五步:验证是否可用

输入:

openclaw --version

显示版本号=安装成功。