安装 OpenClaw
基于官方 OpenClaw 安装教程，面向新手讲清推荐安装、Node 要求、替代路径、源码安装和安装后验证。
OpenClaw 官方推荐先走安装脚本。脚本会识别系统、补齐 Node 环境、安装 OpenClaw，并启动 onboarding。只有你已经自己管理 Node，或要从源码贡献，才需要 npm、pnpm、bun 或 source 安装。
先理解：新手不要先折腾安装路径
普通用户的目标是让 OpenClaw 跑起来，而不是先设计完 Node、pnpm、全局包和源码 checkout。
官方安装脚本是默认路径。它适合 macOS、Linux、WSL2 和 Windows PowerShell。
如果你只是想安装 CLI、不马上进入 onboarding，可以选择 no-onboard 路线。
如果你不想污染系统 Node，可以选本地 prefix 安装。
如果你要贡献 OpenClaw 源码，再走 source 安装。
怎么判断系统要求
官方安装页当前推荐 Node 24，也支持 Node 22.14+。
macOS、Linux、Windows 都支持。Windows 原生可用，但 WSL2 通常更稳定。
从源码构建时才需要你自己处理 pnpm。
普通用户不要先手动搭完整开发环境。先用官方脚本跑通，再按需要调整。
什么时候用 npm、pnpm、bun
已经自己管理 Node 环境，并且知道全局包安装路径时，可以用 npm、pnpm 或 bun 安装 CLI。
如果你不确定全局包会装到哪里，就不要从这里开始。安装脚本更少出错。
Bun 适合 CLI 安装路径；Gateway runtime 仍推荐 Node。
如果 npm 安装遇到 sharp / libvips 相关 build 错误，再按官方排障处理，不要一开始就改一堆环境变量。
从源码安装什么时候需要
只有两类人需要源码安装：贡献代码的人，或必须跑本地 checkout 的人。
源码安装会引入 git clone、pnpm install、build、UI build、link 等步骤。它比普通安装多很多失败点，不适合作为新手第一路径。
安装后先验证
安装完成后先确认三件事：CLI 能显示版本，doctor 没有明显问题，Gateway 状态正常。
如果你希望登录或开机后自动启动，再看 LaunchAgent、systemd user service 或 Windows Scheduled Task。
不要在安装没验收前继续配置 channel、workspace、agents、security 和远程访问。
新手常见坑
- 一开始走源码安装，结果卡在 Node / pnpm / build。
- Windows 下忽略 WSL2 的稳定性。
- 没验证 Gateway 状态就开始配置消息渠道。
- 多个 Node 版本混用，导致全局 openclaw 命令指向旧版本。
- 安装后没跑 doctor。
- 把安装问题和配置问题混在一起排查。
怎么验收
你能在终端运行 OpenClaw CLI。
你能看到 OpenClaw 版本。
你能跑 doctor，并知道是否有需要处理的问题。
你能看到 Gateway 状态。
你能说明当前安装方式是脚本、prefix、包管理器还是源码。