系统要求
- Node 22.22.3+、24.15+ 或 25.9+ - Node 26 是推荐的默认版本；如果未安装 Node，安装脚本会自动配置该版本。
- macOS、Linux 或 Windows - Windows 用户可以从原生 Windows Hub 应用、PowerShell CLI 安装程序或 WSL2 Gateway 开始。请参阅 Windows。
- 只有在从源代码构建时才需要
pnpm。
推荐：安装脚本
最快的安装方式。它会检测你的操作系统，如有需要会安装 Node，安装 OpenClaw，并启动引导流程。Windows 桌面用户也可以安装原生的 Windows Hub 配套应用，其中包括设置、托盘状态、聊天、node 模式和本地 MCP 模式。
- macOS / Linux / WSL2
- Windows (PowerShell)
- macOS / Linux / WSL2
- Windows (PowerShell)
其他安装方式
本地前缀安装器（install-cli.sh）
当你希望将 OpenClaw 和 Node 保持在本地前缀下，例如
~/.openclaw，而不依赖系统级 Node 安装时，请使用此方式：
openclaw update --channel dev 和 openclaw update --channel stable 在包安装和 git 安装之间切换。请参阅
更新。
npm、pnpm 或 bun
如果你已经自行管理 Node：- npm
- pnpm
- bun
npm 12 默认会阻止包生命周期脚本，因此上面的命令会跳过 OpenClaw 的
npm 11.16.x 只会警告这些脚本
preinstall 和 postinstall 步骤——npm 会将它们报告为
blocked because they are not covered by allowScripts。请显式允许它们：not yet covered by allowScripts，但仍会运行它们。如果你想消除该警告，请注意，它建议使用的
npm approve-scripts openclaw 命令无法用于全局安装——它会失败并显示
ENOMATCH No installed packages match: openclaw。npm 11.12 及更早版本没有此策略。托管安装器会清除 OpenClaw 包安装的
min-release-age 等 npm 新鲜度筛选条件。如果你使用 npm 手动安装，则仍会应用你自己的 npm 策略。来自源码
适用于贡献者或任何想要从本地检出版本运行的人：pnpm openclaw ...。请参阅 设置 获取完整的开发工作流。
从 GitHub main 检出版本安装
容器和包管理器
Docker
容器化或无头部署。
Podman
Docker 的无 root 容器替代方案。
Nix
通过 Nix flake 进行声明式安装。
Ansible
自动化集群配置。
Bun
可选依赖安装器和包脚本运行器。
验证安装
- macOS：通过
openclaw onboard --install-daemon或openclaw gateway install创建 LaunchAgent - Linux/WSL2：通过相同命令创建 systemd 用户服务
- 原生 Windows：优先使用计划任务；如果创建任务被拒绝，则回退为每用户的 Startup 文件夹登录项
托管与部署
在云服务器或 VPS 上部署 OpenClaw。请参阅 Linux server 获取完整的提供商选择列表（DigitalOcean、Hetzner、Hostinger、Fly.io、GCP、Azure、Railway、Northflank、Oracle Cloud、Raspberry Pi 等），在 Render 上进行声明式部署，或尝试实验性的 Cloudflare Containers 模板。Cloudflare
实验性的 Worker + Container 部署。
VPS
选择一个提供商。
Docker VM
共享 Docker 步骤。
Kubernetes
K8s 部署。
更新、迁移或卸载
更新
保持 OpenClaw 为最新版本。
迁移
迁移到新机器。
卸载
完全移除 OpenClaw。
故障排查：找不到 openclaw
这几乎总是一个 PATH 问题：npm 的全局 bin 目录不在你的 shell 的 PATH 中。请参阅 Node.js 故障排查 获取完整修复方法，包括 Windows 路径。