> ## Documentation Index
> Fetch the complete documentation index at: https://clawdbot.openclaw-doc-zh.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

# 安装

除非有特殊原因，否则请使用安装程序。它会设置 CLI 并运行引导流程。

## 快速安装（推荐）

```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```

Windows (PowerShell)：

```powershell theme={null}
iwr -useb https://openclaw.ai/install.ps1 | iex
```

下一步（如果你跳过了引导）：

```bash theme={null}
openclaw onboard --install-daemon
```

## 系统要求

* **Node >=22**
* macOS、Linux 或通过 WSL2 的 Windows
* 仅从源码构建时需要 `pnpm`

## 选择你的安装路径

### 1) 安装程序脚本（推荐）

通过 npm 全局安装 `openclaw` 并运行引导流程。

```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```

安装程序标志：

```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help
```

详情：[安装程序内部原理](/docs/install/installer)。

非交互式（跳过引导）：

```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```

### 2) 全局安装（手动）

如果你已有 Node：

```bash theme={null}
npm install -g openclaw@latest
```

如果你已全局安装 libvips（macOS 上通过 Homebrew 很常见）且 `sharp` 安装失败，强制使用预构建二进制文件：

```bash theme={null}
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`），要么使用上面的 `SHARP_IGNORE_GLOBAL_LIBVIPS=1` 变通方法来跳过原生构建。

或者：

```bash theme={null}
pnpm add -g openclaw@latest
```

然后：

```bash theme={null}
openclaw onboard --install-daemon
```

### 3) 从源码安装（贡献者/开发者）

```bash theme={null}
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build
openclaw onboard --install-daemon
```

提示：如果你还没有全局安装，可以通过 `pnpm openclaw ...` 运行仓库命令。

### 4) 其他安装选项

* Docker：[Docker](/docs/install/docker)
* Nix：[Nix](/docs/install/nix)
* Ansible：[Ansible](/docs/install/ansible)
* Bun（仅 CLI）：[Bun](/docs/install/bun)

## 安装后

* 运行引导：`openclaw onboard --install-daemon`
* 快速检查：`openclaw doctor`
* 检查网关健康：`openclaw status` + `openclaw health`
* 打开仪表板：`openclaw dashboard`

## 安装方法：npm vs git（安装程序）

安装程序支持两种方法：

* `npm`（默认）：`npm install -g openclaw@latest`
* `git`：从 GitHub 克隆/构建并从源码检出运行

### CLI 标志

```bash theme={null}
# 显式使用 npm
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

# 从 GitHub 安装（源码检出）
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
```

常用标志：

* `--install-method npm|git`
* `--git-dir <path>`（默认：`~/openclaw`）
* `--no-git-update`（使用现有检出时跳过 `git pull`）
* `--no-prompt`（禁用提示；CI/自动化必需）
* `--dry-run`（打印将要执行的操作；不做任何更改）
* `--no-onboard`（跳过引导）

### 环境变量

等效的环境变量（适用于自动化）：

* `OPENCLAW_INSTALL_METHOD=git|npm`
* `OPENCLAW_GIT_DIR=...`
* `OPENCLAW_GIT_UPDATE=0|1`
* `OPENCLAW_NO_PROMPT=1`
* `OPENCLAW_DRY_RUN=1`
* `OPENCLAW_NO_ONBOARD=1`
* `SHARP_IGNORE_GLOBAL_LIBVIPS=0|1`（默认：`1`；避免 `sharp` 针对系统 libvips 构建）

## 故障排除：找不到 `openclaw`（PATH）

快速诊断：

```bash theme={null}
node -v
npm -v
npm prefix -g
echo "$PATH"
```

如果 `$(npm prefix -g)/bin`（macOS/Linux）或 `$(npm prefix -g)`（Windows）**不在** `echo "$PATH"` 中，你的 shell 找不到全局 npm 二进制文件（包括 `openclaw`）。

修复：将其添加到你的 shell 启动文件（zsh：`~/.zshrc`，bash：`~/.bashrc`）：

```bash theme={null}
# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"
```

在 Windows 上，将 `npm prefix -g` 的输出添加到你的 PATH。

然后打开新终端（或在 zsh 中运行 `rehash` / 在 bash 中运行 `hash -r`）。

## 更新 / 卸载

* 更新：[更新](/docs/install/updating)
* 迁移到新机器：[迁移](/docs/install/migrating)
* 卸载：[卸载](/docs/install/uninstall)