安装 OpenClaw

按平台选择安装方式

平台	推荐方案	说明
Windows	Windows 安装（WSL2 / 原生）	推荐 WSL2，更稳定
macOS	一键脚本（见下方）	直接运行即可
Linux / VPS	一键脚本（见下方）	适合腾讯云、阿里云 ECS 等
Docker	Docker 容器化部署	隔离环境，适合服务器
Kubernetes	K8s 部署	集群场景

推荐：一键安装脚本

最快的安装方式。自动检测操作系统、按需安装 Node.js、安装 OpenClaw 并启动引导流程。

macOS / Linux / WSL2：

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

Windows (PowerShell)：

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

跳过引导流程安装：

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/自动化选项，参见 安装脚本详解。

系统要求

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

其他安装方式

npm 或 pnpm

如果你已经自行管理 Node.js：

npm：

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

pnpm：

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

注意： pnpm 需要为带构建脚本的包手动批准。首次安装后运行 pnpm approve-builds -g。

故障排查：sharp 构建错误（npm）：

如果因全局安装的 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 ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

也可以跳过 link，直接在仓库目录内用 pnpm openclaw ...。完整开发工作流参见 Setup。

从 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 是否在运行

托管和云端部署

在云服务器或 VPS 上部署 OpenClaw：

• 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

更新、迁移或卸载

• 更新 — 保持 OpenClaw 最新版本
• 迁移 — 迁移到新机器
• 卸载 — 完全移除 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 配置。