跳转到内容
OpenClaw Docs

安装

安装

Section titled “安装”

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

系统要求

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

安装方法

Section titled “安装方法”

安装程序脚本

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

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

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

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

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

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

npm / pnpm

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

Terminal window
npm install -g openclaw@latest
openclaw onboard --install-daemon
编译错误？

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

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

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

Terminal window
npm install -g github:openclaw/openclaw#main
Terminal window
pnpm add -g github:openclaw/openclaw#main
从源码安装

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

  1. 克隆并构建

    克隆 OpenClaw 仓库 并构建：

    Terminal window
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build

  2. 链接 CLI

    使 openclaw 命令全局可用：

    Terminal window
    pnpm link --global

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

  3. 运行新手引导

    Terminal window
    openclaw onboard --install-daemon

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

其他安装方法

Section titled “其他安装方法”
Docker

容器化或无头部署。

Podman

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

Nix

通过 Nix 进行声明式安装。

Ansible

自动化集群配置。

Bun

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

安装后

Section titled “安装后”

验证一切是否正常工作：

Terminal window
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

Section titled “故障排除：找不到 openclaw”
PATH 诊断与修复

快速诊断：

Terminal window
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）中：

Terminal window
export PATH="$(npm prefix -g)/bin:$PATH"

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

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

更新 / 卸载

Section titled “更新 / 卸载”
Updating

保持 OpenClaw 为最新状态。

Migrating

迁移到新机器。

Uninstall

完全移除 OpenClaw。