安装

已经按照快速入门操作了？你已经准备好了 — 本页提供替代安装方法、平台特定说明和维护指南。

系统要求

Node 22+（安装脚本会在缺失时安装）
macOS、Linux 或 Windows
仅当你从源码构建时需要 pnpm

在 Windows 上，我们强烈建议在 WSL2 下运行 OpenClaw。

安装方法

安装脚本是推荐的 OpenClaw 安装方式。它在一个步骤中处理 Node 检测、安装和入门引导。

对于 VPS/云主机，尽可能避免第三方"一键式"市场镜像。优先使用干净的基础 OS 镜像（例如 Ubuntu LTS），然后使用安装脚本自行安装 OpenClaw。

下载 CLI，通过 npm 全局安装，并启动入门向导。

curl -fsSL https://openclaw.ai/install.sh | bash

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

要跳过入门引导只安装二进制文件：

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

对于所有标志、环境变量和 CI/自动化选项，查看安装器内部原理。

其他安装方法

📦

Docker

容器化或无头部署。

📦

Podman

无根容器：运行 setup-podman.sh 一次，然后运行启动脚本。

❄️

Nix

通过 Nix 声明式安装。

🖥️

Ansible

自动化集群配置。

⚡

Bun

通过 Bun 运行时仅使用 CLI。

安装后

验证一切正常工作：

openclaw doctor         # 检查配置问题
openclaw status         # gateway 状态
openclaw dashboard      # 打开浏览器 UI

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

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

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

故障排除：找不到 `openclaw`

更新 / 卸载

🔄

更新

保持 OpenClaw 最新。

➡️

迁移

移动到新机器。

🗑️

卸载

完全移除 OpenClaw。

安装

安装