跳转到主要内容

​
系统要求

  • Node 24（推荐）或 Node 22.14+ —— 安装脚本会自动处理这一点
  • macOS、Linux 或 Windows —— 同时支持原生 Windows 和 WSL2；WSL2 更稳定。参见 Windows。
  • 只有在你从源码构建时才需要 pnpm

​
推荐：安装脚本

这是最快的安装方式。它会检测你的操作系统，在需要时安装 Node，安装 OpenClaw，并启动新手引导。 
curl -fsSL https://openclaw.ai/install.sh | bash
如需安装但不运行新手引导： 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
有关所有标志以及 CI / 自动化选项，请参见 安装器内部机制。

​
其他安装方式

​
本地前缀安装器（install-cli.sh）

如果你希望将 OpenClaw 和 Node 保存在本地前缀目录下（例如 ~/.openclaw），而不依赖系统范围安装的 Node，请使用此方式： 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
它默认支持 npm 安装，也支持在相同前缀流程下通过 git 检出进行安装。完整参考请见：安装器内部机制。 已经安装过了？你可以使用 openclaw update --channel dev 和 openclaw update --channel stable 在软件包安装和 git 安装之间切换。参见 更新。

​
npm、pnpm 或 bun

如果你已经自行管理 Node： 
npm install -g openclaw@latest
openclaw onboard --install-daemon
如果由于全局安装的 libvips 导致 sharp 失败：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
从源码安装

适用于贡献者，或任何希望从本地检出运行的人： 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
或者你也可以跳过 link，直接在仓库内部使用 pnpm openclaw ...。完整开发工作流请参见 设置。

​
从 GitHub main 安装

npm install -g github:openclaw/openclaw#main

​
容器和包管理器

Docker

容器化或无头部署。

Podman

Docker 的无 root 容器替代方案。

Nix

通过 Nix flake 进行声明式安装。

Ansible

自动化批量部署。

Bun

通过 Bun 运行时进行仅 CLI 用法。

​
验证安装

openclaw --version      # 确认 CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 验证 Gateway 网关正在运行
如果你希望在安装后由系统托管启动：
  • macOS：通过 openclaw onboard --install-daemon 或 openclaw gateway install 安装 LaunchAgent
  • Linux / WSL2：通过相同命令安装 systemd 用户服务
  • 原生 Windows：优先使用计划任务；如果任务创建被拒绝，则回退为每用户“启动”文件夹登录项

​
托管与部署

将 OpenClaw 部署到云服务器或 VPS：

VPS

任意 Linux VPS

Docker VM

共享的 Docker 步骤

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
更新、迁移或卸载

Updating

让 OpenClaw 保持最新。

Migrating

迁移到新机器。

Uninstall

完全移除 OpenClaw。

​
故障排除：找不到 openclaw

如果安装成功了，但你的终端中找不到 openclaw： 
node -v           # 已安装 Node？
npm prefix -g     # 全局软件包装在哪里？
echo "$PATH"      # 全局 bin 目录是否在 PATH 中？
如果 $(npm prefix -g)/bin 不在你的 $PATH 中，请将它添加到你的 shell 启动文件（~/.zshrc 或 ~/.bashrc）中： 
export PATH="$(npm prefix -g)/bin:$PATH"
然后打开一个新的终端。更多详情请参见 Node 设置。