OpenClaw本地部署失败时，可按五种方式解决：一、官方一键脚本（推荐）；二、手动全局安装；三、nvm管理Node.js多版本；四、macOS Homebrew流程；五、Ubuntu/Debian换源加速安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试在本地系统部署 OpenClaw，但安装失败或命令无法识别，则可能是由于 Node.js 版本不兼容、依赖缺失或网络源不可达所致。以下是适用于 2026 年最新版（v2.5+）的多种安装路径，覆盖 Windows、macOS 和 Linux 全平台场景：
一、使用官方一键脚本安装（推荐首选）
该方式自动检测系统环境、安装必要依赖（Node.js v22+、Git、npm 配置），并拉取最新稳定版 OpenClaw，全程无需手动干预。
1、以管理员权限打开终端（Windows：PowerShell；macOS/Linux：Terminal）
2、执行对应平台的一键安装命令：
Windows（PowerShell）：iwr -useb https://openclaw.ai/install.ps1 | iex
macOS/Linux（Bash）：curl -fsSL https://openclaw.ai/install.sh | bash
3、等待脚本自动完成 Node.js 安装、npm 全局配置、OpenClaw 下载与软链接注册
4、验证是否生效：openclaw --version，输出类似 openclaw v2.5.3 即成功
二、手动全局安装（可控性强，适合调试）
当一键脚本因网络策略或权限限制失败时，可分步执行安装流程，便于定位问题环节。
1、确认已安装 Node.js v22.x（非 v20 或 v21）：node -v 必须返回 v22.0.0 或更高版本
2、设置 npm 全局镜像为国内加速源：npm config set registry https://registry.npmmirror.com
3、执行全局安装命令：npm install -g openclaw-cn（国内镜像版）或 npm install -g openclaw（官方源，需稳定访问 GitHub）
4、将 npm 全局 bin 目录加入系统 PATH（如 macOS/Linux 需追加至 ~/.zprofile；Windows 需在系统环境变量中添加）
5、重开终端后运行：openclaw onboard --install-daemon 启动初始化向导
三、通过 nvm/nvm-windows 管理多版本 Node.js 安装（企业/开发人员适用）
该方法避免系统级 Node.js 冲突，支持快速切换版本，适用于已存在旧版 Node.js 或需并行测试多个 OpenClaw 分支的场景。
1、Windows 用户下载并安装 nvm-setup.exe（最新版 v1.1.13+）：https://github.com/coreybutler/nvm-windows/releases
2、macOS/Linux 用户安装 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
3、安装指定 Node.js 版本：nvm install 22.22.0
4、设为默认版本：nvm alias default 22.22.0
5、验证切换结果：nvm use default 后执行 node -v 应输出 v22.22.0
6、再执行 npm install -g openclaw-cn 完成安装
四、Mac 平台专属 Homebrew + Node.js 流程（无魔法环境友好）
针对未开启代理、但具备 Homebrew 基础的 macOS 用户，提供低依赖、高成功率安装链。
1、确保已安装 Homebrew（若未安装，运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）
2、通过 Homebrew 安装 Node.js v22：brew install node@22
3、强制链接该版本：brew link --force node@22
4、验证：node -v 输出应为 v22.x.x，且 which node 指向 /opt/homebrew/bin/node
5、设置 npm 镜像并安装：npm config set registry https://registry.npmmirror.com && npm install -g openclaw-cn
五、Ubuntu/Debian 系统换源加速安装（含小鱼一键指令）
针对国内服务器或校园网用户，先优化系统源与 npm 源，再执行安装，可显著降低超时与 404 错误率。
1、执行小鱼换源指令（自动适配 Ubuntu 22.04+/Debian 12+）：wget http://fishros.com/install -O fishros && . fishros，选择选项 5
2、安装构建依赖：sudo apt update && sudo apt install -y build-essential cmake python3 git
3、添加 NodeSource 官方 v22 源：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
4、安装 Node.js：sudo apt install -y nodejs
5、设置 npm 镜像并安装 OpenClaw：npm config set registry https://registry.npmmirror.com && sudo npm install -g openclaw-cn
