在使用一键脚本安装 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/Linux
bash
npm config set registry https://registry.npmmirror.comWindows PowerShell
bash
npm config set registry https://registry.npmmirror.com- 重新执行安装脚本
一键脚本偶尔会因网络波动中断，删除残留文件后重新执行：
macOS/Linux：
bash
运行
删除残留
bash
rm -rf ~/.openclaw重新安装
bash
curl -fsSL https://openclaw.ai/install.sh | bash
Windows：powershell
删除残留
Remove-Item -Recurse -Force $HOME/.openclaw
重新安装
iwr -useb https://openclaw.ai/install.ps1 | iex
- 检查系统版本与依赖
OpenClaw 要求：
Windows：Win10/11 64 位（不支持 Win7）
macOS：10.15+（Catalina 及以上）
Linux：Ubuntu 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 | bash
Windows PowerShell 国内镜像
iwr -useb https://gitee.com/openclaw/install/raw/main/install.ps1 | iex
- 报错：Error: EACCES: permission denied（权限拒绝）
原因：没有写入系统目录的权限。
解决：
macOS/Linux：加 sudo 重新执行（见基础排查 1）；
Windows：确认是管理员身份运行，且没有文件夹只读权限（右键 .openclaw 文件夹→属性→取消 "只读"）。
- 报错：Node.js not found/npm: command not found（Node 安装失败）
原因：脚本自动装 Node 失败，或系统路径未配置。
解决：
手动安装 Node.js（官网下载对应系统版本）；
安装后执行 npm -v 验证；
手动安装 OpenClaw（替代一键脚本）：
bash
运行
npm install -g openclaw@latest
- Windows 报错：无法加载文件 xxx.ps1，因为在此系统上禁止运行脚本
原因：PowerShell 执行策略限制。
解决：
管理员打开 PowerShell，执行：
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
输入 Y 确认，再重新执行安装脚本。
- 安装完成但执行 openclaw 提示 "命令不存在"
原因：Node 的全局目录未加入系统环境变量。
解决：
macOS/Linux：执行 export PATH=$PATH:~/.npm-global/bin，并将该命令加入 /.bashrc//.zshrc；
Windows：找到 Node 的安装目录（如 C:\Users\你的用户名\AppData\Roaming\npm），手动添加到系统环境变量 "Path" 中，重启终端。
三、终极替代方案（脚本完全用不了时）
如果一键脚本始终失败，直接用手动安装（更稳定）：
步骤 1：手动装 Node.js
下载对应系统版本：https://nodejs.org/zh-cn/download/current/
验证：node -v 和 npm -v 能显示版本号。
步骤 2：全局安装 OpenClaw
bash
运行
切换国内源（可选，加速）
npm config set registry https://registry.npmmirror.com
安装OpenClaw
npm install -g openclaw@latest
初始化配置
openclaw onboard --install-daemon
步骤 3：验证安装
执行 openclaw version，能显示版本号即安装成功。
四、获取官方帮助
如果以上方法都解决不了：
收集报错截图 / 日志（安装时的完整输出）；
访问 OpenClaw 官方社区：
GitHub Issues：https://github.com/openclaw/openclaw/issues
官方文档：https://docs.openclaw.ai/installation/troubleshooting
总结
一键脚本安装失败，优先检查权限和网络（加 sudo、切换国内源）；
Windows 用户重点解决PowerShell 执行策略和管理员权限问题；
脚本装不了时，直接用 npm 手动安装是最稳的替代方案；
核心依赖是 Node.js ≥22.0.0，确保这个装对就成功了 80%。