安装
已经跟着快速上手走过一遍了？那就不用看这页了——这里主要讲的是其他安装方式、特定平台的说明，以及日常维护。
系统要求
- Node 24（推荐）（Node 22 LTS，目前
22.16+，仍兼容支持；安装脚本会在缺失时自动安装 Node 24） - macOS、Linux 或 Windows
- 仅从源码构建时需要
pnpm
注意： 在 Windows 上，强烈建议在 WSL2 下运行 OpenClaw。
安装方式
提示： 安装脚本是安装 OpenClaw 的推荐方式。它一步搞定 Node 检测、安装和初始化引导。
警告： 对于 VPS/云主机，尽量避免使用第三方”一键部署”的市场镜像。优先选择干净的基础系统镜像（比如 Ubuntu LTS），然后用安装脚本自行安装 OpenClaw。
安装脚本
下载 CLI，通过 npm 全局安装，然后启动初始化引导向导。
#### macOS / Linux / WSL2
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
#### Windows (PowerShell)
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
就这么简单——脚本会自动处理 Node 检测、安装和初始化引导。
如果只想安装二进制文件、跳过引导流程：
#### macOS / Linux / WSL2
```bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```
#### Windows (PowerShell)
```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
```
所有可用参数、环境变量和 CI/自动化选项，请参阅[安装脚本内部机制](/docs/install/installer)。npm / pnpm
如果你自己管理 Node，推荐使用 Node 24。OpenClaw 仍兼容 Node 22 LTS，目前 `22.16+`：
#### npm
```bash
npm install -g openclaw@latest
openclaw onboard --install-daemon
```
<details>sharp 编译报错？
如果系统上全局安装了 libvips（macOS 上通过 Homebrew 安装很常见），导致 `sharp` 编译失败，可以强制使用预编译二进制：
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
```
如果看到 `sharp: Please add node-gyp to your dependencies`，要么安装构建工具链（macOS: Xcode CLT + `npm install -g node-gyp`），要么用上面的环境变量。
</details>
#### pnpm
```bash
pnpm add -g openclaw@latest
pnpm approve-builds -g # 审批 openclaw、node-llama-cpp、sharp 等
openclaw onboard --install-daemon
```
> **注意：** pnpm 要求对带有构建脚本的包进行显式审批。首次安装时如果看到 "Ignored build scripts" 警告，运行 `pnpm approve-builds -g` 并选择列出的包即可。从源码构建
适合贡献者，或者想从本地代码运行的人。
### 第 1 步：克隆并构建
克隆 [OpenClaw 仓库](https://github.com/openclaw/openclaw) 并构建：
```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
```
### 第 2 步：链接 CLI
让 `openclaw` 命令在全局可用：
```bash
pnpm link --global
```
也可以跳过链接，在仓库目录内通过 `pnpm openclaw ...` 运行命令。
### 第 3 步：运行引导流程
```bash
openclaw onboard --install-daemon
```
更深入的开发工作流，请参阅[开发环境搭建](/docs/start/setup)。其他安装方式
- Docker — 容器化或无头部署。
- Podman — 无根容器：运行一次
setup-podman.sh，然后用启动脚本。 - Nix — 通过 Nix 声明式安装。
- Ansible — 自动化批量部署。
- Bun — 通过 Bun 运行时使用 CLI。
安装后
验证一切正常：
openclaw doctor # 检查配置问题
openclaw status # 网关状态
openclaw dashboard # 打开浏览器 UI如果需要自定义运行时路径：
OPENCLAW_HOME用于设置基于 home 目录的内部路径OPENCLAW_STATE_DIR用于设置可变状态的存储位置OPENCLAW_CONFIG_PATH用于设置配置文件位置
详见环境变量中的优先级和完整说明。
排错：找不到 openclaw 命令
PATH 诊断与修复
快速诊断：
node -v
npm -v
npm prefix -g
echo "$PATH"如果 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）不在你的 $PATH 中，shell 就找不到全局 npm 二进制文件（包括 openclaw）。
修复——将其添加到 shell 启动文件（~/.zshrc 或 ~/.bashrc）：
export PATH="$(npm prefix -g)/bin:$PATH"Windows 上，将 npm prefix -g 的输出添加到 PATH 中。
然后打开新终端（或在 zsh 中 rehash / bash 中 hash -r）。