安装

已经按照入门指南操作了吗？您已设置完成 — 此页面用于替代安装方法、平台特定说明和维护。

系统要求

在 Windows 上，我们强烈建议在 [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) 下运行 OpenClaw。

安装方法

**安装程序脚本**是安装 OpenClaw 的推荐方式。它一步处理 Node 检测、安装和入职。 对于 VPS/云主机，尽可能避免使用第三方"一键式"市场镜像。首选干净的基础 OS 镜像（例如 Ubuntu LTS），然后使用安装程序脚本自行安装 OpenClaw。 下载 CLI，通过 npm 全局安装，并启动入职向导。 
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

就这样 — 脚本处理 Node 检测、安装和入职。

跳过入职并仅安装二进制文件：

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

有关所有标志、环境变量和 CI/自动化选项，请参阅[安装程序内部](/zh/docs/install/installer)。
 如果您已有 Node 22+ 并希望自行管理安装： 
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```
  </Tab>
</Tabs>
 使用 Docker 运行 OpenClaw： 
```bash
docker run -d \
  --name openclaw \
  -v ~/.openclaw:/home/node/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest
```

有关更多 Docker 配置选项，请参阅 [Docker 指南](/zh/docs/install/docker)。
 如果您想从源码构建： 
```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm link
```

安装后

安装后，运行入职向导：

openclaw onboard

这将引导您完成：

  • 配置 AI 模型
  • 连接消息频道
  • 设置安全选项

故障排除

安装失败

  • 检查 Node 版本：node --version
  • 确保有网络连接
  • 尝试手动安装

权限错误

  • 检查 npm 权限
  • 使用 nvm 或 sudo

更新 OpenClaw

openclaw update

卸载 OpenClaw

openclaw uninstall

平台特定说明

macOS

  • 使用 Homebrew 安装： brew install openclaw
  • 或使用安装程序脚本

Linux

  • 使用安装程序脚本
  • 或使用 apt/yum 安装

Windows

  • 使用 PowerShell 安装程序
  • 或使用 WSL2

云平台

相关链接