安装部署
OpenClaw 支持多种安装方式，适配不同的使用场景。推荐使用安装脚本，最快 30 秒完成。
环境要求
- Node.js：推荐 v24，最低支持 v22 LTS
- 操作系统：macOS、Linux、Windows（WSL 推荐）
- Git：安装脚本会自动检测并提示
方式一：安装脚本（推荐）
适用于 macOS / Linux / WSL，会自动安装 Node.js（如果缺失）并通过 npm 安装 OpenClaw：
curl -fsSL https://openclaw.ai/install.sh | bash常用参数：
| 参数 | 说明 |
|---|---|
| --install-method npm|git | 安装方式（默认 npm） |
| --version <tag> | 指定版本 |
| --beta | 安装 beta 版本 |
| --no-onboard | 跳过交互式引导 |
| --dry-run | 仅展示将执行的操作 |
升级时脚本会自动运行 openclaw doctor --non-interactive 进行健康检查。
方式二：本地前缀安装（无需 root）
安装到 ~/.openclaw，不影响全局 Node 环境，下载固定版本 Node 22：
curl -fsSL https://openclaw.ai/install-cli.sh | bash支持自定义安装目录：--prefix ~/my-oc。
方式三：npm 全局安装
如果你已有 Node.js 环境：
npm install -g openclaw@latest
# 或使用 pnpm
pnpm add -g openclaw@latest方式四：Docker
适合服务器部署和隔离环境：
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest挂载 ~/.openclaw 目录可保留配置和会话数据。
方式五：Windows PowerShell
在 PowerShell 5+ 中运行（需管理员权限）：
irm https://openclaw.ai/install.ps1 | iex脚本通过 winget / Chocolatey / Scoop 安装 Node.js，然后 npm 安装 OpenClaw。
CI / 自动化场景
在 CI 环境中跳过交互提示：
# 方式一：命令行参数
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard
# 方式二：环境变量
OPENCLAW_INSTALL_METHOD=npm OPENCLAW_NO_PROMPT=1 bash install.sh安装后验证
# 查看版本
openclaw --version
# 运行诊断
openclaw doctor
# 启动引导
openclaw onboard --install-daemon安装完成后，建议立即运行 openclaw onboard 完成模型认证和首个渠道配置。
注意事项
- 使用安装脚本时默认设置
SHARP_IGNORE_GLOBAL_LIBVIPS=1，避免 sharp 兼容问题 - Kubernetes 和其他云平台部署请参考官方对应文档（Fly、Hetzner、Railway 等）
- 升级前建议先备份
~/.openclaw目录