小龙虾OpenClaw安装部署的常见问题与避坑指南



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