安装概览
本页汇总所有受支持的安装方式，帮助你在 最短时间内 把 OpenClaw 跑起来。
系统要求
| 项目 | 最低要求 |
|---|---|
| Node.js | >= 22.0（安装指南） |
| 操作系统 | macOS 12+、Linux（glibc >= 2.28）、Windows 10+ |
| 内存 | >= 4 GB（推荐 8 GB） |
| 磁盘 | >= 2 GB 可用空间 |
为什么需要 Node 22+？
OpenClaw 使用了 Node 22 引入的原生 fetch、WebSocket 等 API。更低版本将无法启动 Gateway（网关）。
安装方式
1. 一键安装脚本（推荐）
适用于 macOS / Linux / WSL2 和 Windows PowerShell，一条命令即可完成安装。
bash
curl -fsSL https://openclaw.ai/install.sh | bashpowershell
iwr -useb https://openclaw.ai/install.ps1 | iex安装脚本会自动完成以下操作：
- 检测系统环境与 Node 版本
- 下载最新稳定版 OpenClaw
- 配置
PATH并注册系统服务 - 运行
openclaw doctor做健康检查
想了解脚本内部原理？请参阅 安装器内部原理。
2. npm / pnpm 全局安装
bash
npm install -g openclawbash
pnpm add -g openclawsharp 构建报错？
openclaw 依赖 sharp（图像处理库），在部分系统上可能触发原生模块编译错误。常见解决方案：
bash
# 方法一：使用预编译二进制
npm install -g openclaw --sharp-install-force-prebuilt
# 方法二：安装系统依赖后重试
# Debian/Ubuntu
sudo apt install -y build-essential libvips-dev
# macOS
brew install vips3. 从源码安装
适合需要修改源码或参与开发的用户。
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm link --global安装完成后运行 openclaw --version 验证。
4. 其他安装方式
| 方式 | 说明 | 文档 |
|---|---|---|
| Docker | 容器化部署 Gateway | Docker 安装 |
| Podman | 无根容器方案 | Podman |
| Nix | Home Manager 模块 | Nix 安装 |
| Ansible | 生产服务器自动部署 | Ansible 部署 |
| Bun | 实验性 JS 运行时 | Bun（实验性） |
安装后验证
安装完成后，请运行以下命令确认一切正常：
bash
# 健康检查——检测 Node 版本、依赖、端口等
openclaw doctor
# 查看服务状态
openclaw status
# 启动 Web 控制面板
openclaw dashboard如果 openclaw doctor 输出全部为绿色 PASS，说明安装成功。
PATH 排障
如果终端提示 openclaw: command not found，说明可执行文件不在系统 PATH 中。
macOS / Linux 修复方法
将以下内容添加到 ~/.bashrc、~/.zshrc 或对应 shell 配置文件：
bash
export PATH="$HOME/.openclaw/bin:$PATH"然后重新加载配置：
bash
source ~/.bashrc # 或 source ~/.zshrcWindows 修复方法
- 打开 系统属性 > 高级 > 环境变量
- 在 用户变量 的
Path中添加%USERPROFILE%\.openclaw\bin - 重启终端
或在 PowerShell 中运行：
powershell
[Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\.openclaw\bin;" + $env:Path, "User")