小龙虾OpenClaw安装部署的常见问题与避坑指南
整理了部署过程中最常见的5个问题,附详细解决方法:
- 问题1:Windows提示“脚本无法运行”“禁止执行脚本” 解决方法:管理员PowerShell中输入
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser,弹出提示后输入Y回车,再重新执行安装脚本。 - 问题2:终端提示“openclaw 不是内部或外部命令” 原因:Node.js环境变量未生效 解决方法:重启电脑,重新打开管理员PowerShell,输入
node -v,若能显示版本号,再执行openclaw相关命令。 - 问题3:安装到一半卡住、下载失败 原因:网络波动或国内网络访问官方源较慢 解决方法:关闭终端重新执行安装命令,或替换为国内加速脚本(Windows加速命令见方案一);暂时关闭防火墙、杀毒软件,避免拦截下载。
- 问题4:中文用户名导致路径乱码、报错 解决方法:修改npm路径至纯英文目录,例如D盘:
npm config set prefix "D:\npm-global"npm config set cache "D:\npm-cache" - 问题5:启动后无法打开管理面板(端口被占用) 解决方法:管理员PowerShell/终端输入
netstat -ano | findstr :18789,查看最后一列的PID(进程编号),再输入taskkill /f /pid 数字(替换“数字”为实际PID),关闭占用端口的进程后,重新执行openclaw start。