Skip to main content

​
安装

已经阅读过快速入门？那你已经准备好了——本页介绍替代安装方法、特定平台说明及维护相关内容。

​
系统要求

  • Node 22+ （如果缺失，安装脚本会自动安装）
  • macOS、Linux 或 Windows
  • 仅当你从源码构建时需要 pnpm
在 Windows 上，我们强烈推荐在 WSL2 下运行 OpenClaw。

​
安装方法

安装脚本 是推荐的 OpenClaw 安装方式。它一步完成 Node 的检测、安装和引导流程。
对于 VPS/云主机，尽量避免使用第三方的“单击安装”市场镜像。建议使用干净的基础操作系统镜像（例如 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/自动化选项，请参见安装器内部。
如果你已经有 Node 22+ 并且想自己管理安装：
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）或者使用上面提到的环境变量。
适用于贡献者或希望从本地代码库运行的用户。
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
关于更深入的开发流程，请参见设置。

​
其他安装方式

Docker

容器化或无头部署。

Podman

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

Nix

通过 Nix 的声明式安装。

Ansible

自动化集群配置。

Bun

仅通过 Bun 运行时使用 CLI。

​
安装后

验证一切正常： 
openclaw doctor         # 检查配置问题
openclaw status         # 网关状态
openclaw dashboard      # 打开浏览器 UI
如果你需要自定义运行时路径，请使用：
  • OPENCLAW_HOME 指定基于家目录的内部路径
  • OPENCLAW_STATE_DIR 指定可变状态存储位置
  • OPENCLAW_CONFIG_PATH 指定配置文件位置
详见环境变量了解优先级及完整细节。

​
故障排查：找不到 openclaw

快速诊断：
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）。

​
更新 / 卸载

更新

保持 OpenClaw 最新。

迁移

迁移到新机器。

卸载

完全移除 OpenClaw。