安装

​

安装

已经跟随入门指南操作了吗？您已经准备就绪了 — 本页面介绍其他安装方法、特定平台的说明以及维护工作。

​

系统要求

• Node 24（推荐）（为了兼容性，目前仍支持 Node 22 LTS，即 22.16+；如果缺少 Node 24，安装程序脚本 将会安装它）
• macOS、Linux 或 Windows
• 仅当您从源码构建时才需要 pnpm

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

​

安装方法

安装程序脚本 是安装 OpenClaw 的推荐方式。它一步即可完成 Node 检测、安装和引导。

对于 VPS/云主机，请尽可能避免使用第三方“一键式”市场镜像。首选纯净的基础操作系统镜像（例如 Ubuntu LTS），然后使用安装程序脚本自行安装 OpenClaw。

安装程序脚本

下载 CLI，通过 npm 全局安装，并启动新手引导。

macOS / Linux / WSL2

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

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

就是这样 —— 脚本会处理 Node 检测、安装和新手引导。

要跳过新手引导并仅安装二进制文件：

macOS / Linux / WSL2

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

Windows (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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

npm / pnpm

如果您自己管理 Node，我们建议使用 Node 24。为了兼容性，OpenClaw 仍支持当前的 Node 22 LTS 22.16+：

npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

编译错误？

如果您全局安装了 libvips（在 macOS 上通过 Homebrew 很常见）并且 sharp 失败，请强制使用预构建的二进制文件：

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）或使用上述环境变量。

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
openclaw onboard --install-daemon

pnpm 需要明确批准包含构建脚本的包。首次安装显示“Ignored build scripts”警告后，运行 pnpm approve-builds -g 并选择列出的包。

想要使用包管理器安装当前 GitHub main head 版本？

npm install -g github:openclaw/openclaw#main

pnpm add -g github:openclaw/openclaw#main

从源码安装

适用于贡献者或任何想要从本地检出运行的人。

1. 克隆并构建

   克隆 OpenClaw 仓库 并构建：

   git clone https://github.com/openclaw/openclaw.git
   cd openclaw
   pnpm install
   pnpm ui:build
   pnpm build
   
2. 链接 CLI

   使 openclaw 命令全局可用：

   pnpm link --global
   

   或者，跳过链接并通过仓库内的 pnpm openclaw ... 运行命令。

3. 运行新手引导

   openclaw onboard --install-daemon
   

有关更深入的开发工作流，请参阅 Setup。

​

其他安装方法

Docker

容器化或无头部署。

Podman

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

Nix

通过 Nix 进行声明式安装。

Ansible

自动化集群配置。

Bun

通过 Bun 运行时进行 CLI 专用操作。

​

安装后

验证一切是否正常工作：

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

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

• OPENCLAW_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）。

​

更新 / 卸载

Updating

保持 OpenClaw 为最新状态。

Migrating

迁移到新机器。

Uninstall

完全移除 OpenClaw。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。