推荐：安装脚本
这是最快的安装方式。它会检测你的操作系统，在需要时安装 Node，安装 OpenClaw，并启动新手引导。
- macOS / Linux / WSL2
- Windows (PowerShell)
curl -fsSL https://openclaw.ai/install.sh | bash
如果你希望安装时不运行新手引导：
- macOS / Linux / WSL2
- Windows (PowerShell)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
有关所有标志以及 CI/自动化选项，请参见 安装器内部机制。
系统要求
- Node 24（推荐）或 Node 22.14+ —— 安装脚本会自动处理
- macOS、Linux 或 Windows —— 同时支持原生 Windows 和 WSL2；WSL2 更稳定。参见 Windows。
- 只有在你从源码构建时才需要
pnpm
其他安装方式
本地前缀安装器（install-cli.sh）
当你希望将 OpenClaw 和 Node 保持在本地前缀下（例如 ~/.openclaw），而不依赖系统范围的 Node 安装时，请使用此方式：
curl -fsSL https://openclaw.ai/install-cli.sh | bash
它默认支持 npm 安装，也支持在同一 前缀流程下使用 git 检出安装。完整参考： 安装器内部机制。
npm、pnpm 或 bun
如果你已经自行管理 Node：
- npm
- pnpm
- bun
npm install -g openclaw@latest
openclaw onboard --install-daemon
故障排除：sharp 构建错误（npm）
从源码安装
适用于贡献者，或任何希望从本地检出运行的人：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
或者跳过 link，直接在仓库内使用 pnpm openclaw ...。完整开发工作流请参见 设置。
从 GitHub main 安装
npm install -g github:openclaw/openclaw#main
验证安装
openclaw --version # 确认 CLI 可用
openclaw doctor # 检查配置问题
openclaw gateway status # 验证 Gateway 网关正在运行
如果你希望安装后由系统托管启动：
原生 Windows：优先使用 Scheduled Task；如果任务创建被拒绝，则回退到按用户的 Startup 文件夹登录项
macOS：通过 openclaw onboard --install-daemon 或 openclaw gateway install 安装 LaunchAgent
Linux/WSL2：通过相同命令安装 systemd 用户服务
故障排除：找不到 openclaw
如果安装成功，但终端中找不到 openclaw：
node -v # Node 是否已安装？
npm prefix -g # 全局软件包安装在哪里？
echo "$PATH" # 全局 bin 目录是否在 PATH 中？
如果 $(npm prefix -g)/bin 不在你的 $PATH 中，请将它添加到你的 shell 启动文件（~/.zshrc 或 ~/.bashrc）中：
export PATH="$(npm prefix -g)/bin:$PATH"
然后打开一个新的终端。更多细节请参见 Node 设置。