OpenClaw 安装方式怎么选：脚本、npm、桌面应用与容器对比

安装 OpenClaw 本身只要一条命令，难的是选对途径。这一页按「你手上是什么机器」来分岔。

系统要求

• Node.js 22.22.3+、24.15+ 或 25.9+，官方推荐默认用 24；用 node --version 先确认。
• macOS、Linux 或 Windows；Windows 有三条路线（见下）。
• 只有从源码构建才需要 pnpm。

按平台选路线

• macOS / Linux / WSL2：官方 shell 安装脚本，自动检测系统、按需装 Node、装完启动新手引导；加参数可跳过引导。也可以用「本地前缀安装脚本」把 OpenClaw 和 Node 一起收进用户目录，不动系统级环境。
• Windows 原生：三条路——桌面版 Windows Hub 应用（最省事，图形界面）、PowerShell 安装脚本（直接装 CLI 与网关）、或 WSL2 里当 Linux 用（与 Linux 生态兼容性最好）。
• 不想污染主机：Docker 或 Podman 容器，另有 Nix 声明式安装与 Ansible 批量配置。

自管 Node 用户的装法

已经用 npm/pnpm/bun 管理全局包的人，直接装最新版然后跑引导：

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

• pnpm 用户首次安装后要运行 pnpm approve-builds -g 批准构建脚本。
• bun 可以完成安装，但生成的可执行文件仍需要受支持的 Node 运行时。

验证装好了

openclaw --version
openclaw doctor
openclaw gateway status

第三条命令应显示网关正在监听 18789 端口（默认值）。如果提示找不到 openclaw 命令，几乎都是 npm 全局二进制目录不在 PATH 里——这是官方文档列的头号安装问题，Windows 用户尤其常见。

从源码跑

克隆仓库后依次执行依赖安装、构建、界面构建，再把命令链接进全局环境；不想链接也可以在仓库目录内直接用包管理器脚本调用。这条路主要为贡献者和想读源码的用户准备。

相关阅读：新手引导、容器部署、Windows Hub。