安装

已经完成快速开始了吗？那你已经准备好了——本页面提供替代安装方法、平台特定说明和维护信息。

系统要求

• ▹Node 22+（安装脚本会在缺失时自动安装）点击安装 Node.js
• ▹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
irm https://openclaw.ai/install.ps1 | iex

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

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

复制
bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

有关所有标志、环境变量和 CI/自动化选项，请参阅安装程序内部。

npm / pnpm

复制
bash
npm install -g openclaw@latest

从源代码构建

复制
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm link --global

其他安装方法

• ▹Docker - 容器化或无头部署
• ▹Podman - 无根容器：运行一次 setup-podman.sh，然后使用启动脚本
• ▹Nix - 通过 Nix 声明式安装
• ▹Ansible - 自动化集群配置
• ▹Bun - 通过 Bun 运行时仅使用 CLI

安装后

验证一切正常：

复制
bash
openclaw doctor         # 检查配置问题
openclaw status         # 网关状态
openclaw dashboard      # 打开浏览器界面

如果需要自定义运行时路径，使用：

• ▹OPENCLAW_HOME 用于基于主目录的内部路径
• ▹OPENCLAW_STATE_DIR 用于可变状态位置
• ▹OPENCLAW_CONFIG_PATH 用于配置文件位置

查看环境变量了解优先级和完整详情。

故障排除：找不到 openclaw

PATH 诊断和修复

快速诊断：

复制
bash
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）：

复制
bash
export PATH="$(npm prefix -g)/bin:$PATH"

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

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

更新 / 卸载

• ▹更新 - 保持 OpenClaw 最新
• ▹迁移 - 迁移到新机器
• ▹卸载 - 完全删除 OpenClaw