OpenClaw 支持多种安装方式，适配从个人开发机到生产 VPS 的各种场景。本文覆盖所有主流安装方法，以及安装后的验证步骤。
系统要求
- Node.js 22+（安装脚本会自动检测并安装）
- 操作系统：macOS、Linux 或 Windows
- Windows 用户强烈建议在 WSL2 下运行
bash
node --version # 需要 v22 或更高方法一：安装脚本（推荐）
macOS / Linux / WSL2：
bash
curl -fsSL https://openclaw.ai/install.sh | bashWindows（PowerShell）：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex脚本自动完成：Node 检测与安装、CLI 全局安装、启动引导向导。
仅安装，跳过引导：
bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard方法二：npm / pnpm 手动安装
bash
npm install -g openclaw@latest
openclaw onboard --install-daemon遇到 sharp 构建错误：
bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestpnpm 方式：
bash
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon方法三：从源码构建
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon方法四：Docker 容器化部署
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh完成后访问 http://127.0.0.1:18789/，在 Settings → token 粘贴生成的 Token。
安装可选助手工具 ClawDock：
bash
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/shell-helpers/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.sh
echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc之后可用 clawdock-start、clawdock-stop、clawdock-dashboard 等命令。
其他安装方式
| 方式 | 适用场景 |
|---|---|
| Docker | 容器化或无头部署 |
| Podman | 无 root 容器 |
| Nix | 声明式安装 |
| Ansible | 多机批量部署 |
| Bun | Bun 运行时（实验性） |
云端一键部署
支持 Fly.io、Hetzner、GCP、Railway、Render、Northflank、exe.dev 等平台。
安装后验证
bash
openclaw doctor # 检查配置问题
openclaw status # 查看 Gateway 状态
openclaw dashboard # 打开浏览器控制面板常见问题：openclaw 命令找不到
bash
# 诊断
npm prefix -g
echo "$PATH"
# 修复
export PATH="$(npm prefix -g)/bin:$PATH"
# 添加到 ~/.zshrc 使其永久生效自定义路径环境变量
| 环境变量 | 说明 |
|---|---|
OPENCLAW_HOME | 主目录路径 |
OPENCLAW_STATE_DIR | 状态目录位置 |
OPENCLAW_CONFIG_PATH | 配置文件路径 |
原文：Install - OpenClaw | 来源：OpenClaw 官方文档