
很多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
显示版本号=安装成功。
