跳转到主要内容

​
安装

已经完成了快速开始？那你已经准备就绪 —— 本页面介绍其他安装方式、特定平台说明以及维护相关内容。

​
系统要求

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

​
安装方式

安装器脚本是推荐的 OpenClaw 安装方式。它会在一步中完成 Node 检测、安装和新手引导。

安装器脚本

下载 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
或者跳过 link，在仓库目录中使用 pnpm openclaw ... 运行命令。
3

运行新手引导

openclaw onboard --install-daemon
有关更深入的开发工作流，请参阅 Setup。

​
其他安装方式

Docker

容器化或无头部署。

Podman

无 root 容器：先运行 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

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