在使用一键脚本安装 OpenClaw 时遇到问题核心解决思路是先定位报错类型再按 “基础排查→针对性修复→替代方案” 的顺序解决下面我会把新手最常遇到的问题、原因和具体解决方法都列出来你可以对照排查。一、先做 3 步基础排查90% 的简单问题能解决不管遇到什么报错先执行这 3 步排除最基础的环境问题检查网络与权限权限不足最常见Windows必须以管理员身份打开 PowerShell/CMD右键→以管理员身份运行。macOS/Linux在脚本前加 sudo比如 sudo curl -fsSL https://openclaw.ai/install.sh | bash。网络问题确认能正常访问外网OpenClaw 依赖 npm 源、GitHub 资源如果是企业内网需配置代理。临时切换国内 npm 源bash运行macOS/Linuxnpmconfigsetregistry https://registry.npmmirror.comWindows PowerShellnpmconfigsetregistry https://registry.npmmirror.com重新执行安装脚本一键脚本偶尔会因网络波动中断删除残留文件后重新执行macOS/Linuxbash运行删除残留rm-rf~/.openclaw重新安装curl-fsSLhttps://openclaw.ai/install.sh|bashWindowspowershell删除残留Remove-Item -Recurse -Force $HOME/.openclaw重新安装iwr -useb https://openclaw.ai/install.ps1 | iex3. 检查系统版本与依赖OpenClaw 要求WindowsWin10/11 64 位不支持 Win7macOS10.15Catalina 及以上LinuxUbuntu 18.04/CentOS 8脚本会自动装 Node.js但如果装失败可手动安装 Node.js ≥22.0.0官网下载https://nodejs.org/zh-cn/download/current/验证安装后执行 node -v能显示版本号即成功。二、常见报错及针对性解决报错curl: (7) Failed to connect to openclaw.ai port 443连接失败原因网络不通 / 域名解析失败 / 防火墙拦截。解决手动访问 https://openclaw.ai 确认能打开关闭电脑防火墙 / 杀毒软件企业用户需找网管放行改用国内镜像脚本备用bash运行macOS/Linux 国内镜像curl -fsSL https://gitee.com/openclaw/install/raw/main/install.sh | bashWindows PowerShell 国内镜像iwr -useb https://gitee.com/openclaw/install/raw/main/install.ps1 | iex2. 报错Error: EACCES: permission denied权限拒绝原因没有写入系统目录的权限。解决macOS/Linux加 sudo 重新执行见基础排查 1Windows确认是管理员身份运行且没有文件夹只读权限右键 .openclaw 文件夹→属性→取消 “只读”。3. 报错Node.js not found/npm: command not foundNode 安装失败原因脚本自动装 Node 失败或系统路径未配置。解决手动安装 Node.js官网下载对应系统版本安装后执行 npm -v 验证手动安装 OpenClaw替代一键脚本bash运行npm install -g openclawlatest4. Windows 报错无法加载文件 xxx.ps1因为在此系统上禁止运行脚本原因PowerShell 执行策略限制。解决管理员打开 PowerShell执行powershellSet-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认再重新执行安装脚本。5. 安装完成但执行 openclaw 提示 “命令不存在”原因Node 的全局目录未加入系统环境变量。解决macOS/Linux执行 export PATH$PATH:~/.npm-global/bin并将该命令加入/.bashrc//.zshrcWindows找到 Node 的安装目录如 C:\Users\你的用户名\AppData\Roaming\npm手动添加到系统环境变量 “Path” 中重启终端。三、终极替代方案脚本完全用不了时如果一键脚本始终失败直接用手动安装更稳定步骤 1手动装 Node.js下载对应系统版本https://nodejs.org/zh-cn/download/current/验证node -v 和 npm -v 能显示版本号。步骤 2全局安装 OpenClawbash运行切换国内源可选加速npm config set registry https://registry.npmmirror.com安装OpenClawnpm install -g openclawlatest初始化配置openclaw onboard --install-daemon步骤 3验证安装执行 openclaw version能显示版本号即安装成功。四、获取官方帮助如果以上方法都解决不了收集报错截图 / 日志安装时的完整输出访问 OpenClaw 官方社区GitHub Issueshttps://github.com/openclaw/openclaw/issues官方文档https://docs.openclaw.ai/installation/troubleshooting总结一键脚本安装失败优先检查权限和网络加 sudo、切换国内源Windows 用户重点解决PowerShell 执行策略和管理员权限问题脚本装不了时直接用 npm 手动安装是最稳的替代方案核心依赖是 Node.js ≥22.0.0确保这个装对就成功了 80%。