安装 OpenClaw
这篇只解决一件事：把 OpenClaw 装好，并确认它真的能打开。
如果你是第一次用，推荐路线是：
安装 OpenClaw → 运行 onboard → 打开 dashboard → 发第一条消息新手先别纠结安装方式
如果你不知道该选 npm、Docker、云服务器还是 Kubernetes，就选“一键安装脚本”。 你现在的目标不是研究部署方式，而是先让 OpenClaw 在电脑上跑起来。
先检查电脑环境
OpenClaw 支持：
- macOS
- Linux
- Windows
Windows 可以直接用 PowerShell 安装；如果你后面要做更完整的开发和本地工具调用，WSL2 通常更稳。
如果你只是想先聊天、先体验控制 UI，Windows PowerShell 也可以开始，不必一上来安装一整套开发环境。
Node.js 版本
官方当前推荐：
- Node 24：推荐版本
- Node 22.14+：兼容版本
检查命令：
node --version如果你还没有 Node.js，先看安装 Node.js。
方法一：一键安装脚本（最推荐）
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex这个脚本会帮你处理安装细节。新手不用纠结 npm、pnpm、路径这些问题。
方法二：用 npm 安装
如果你已经熟悉 Node.js，也可以手动装。 如果你不知道 npm 是什么，请回到“一键安装脚本”。
npm install -g openclaw@latest
openclaw onboard --install-daemon第二行很重要。它会启动新手向导，并把 Gateway 装成后台服务。
方法三：其他安装方式
下面这些方式不是给第一天的新手准备的。 它们适合你已经知道自己为什么需要容器、云服务器或集群时再选。
| 方式 | 适合谁 |
|---|---|
| Docker 部署 | 想把 OpenClaw 放进容器里运行 |
| ClawDock | Docker 用户想用短命令管理容器 |
| Docker VM Runtime | 云 VM + Docker 长期运行 |
| Nix 安装 | 已经在使用 Nix 的用户 |
| Bun 安装 | 想尝试 Bun 的用户 |
| GCP、Azure、DigitalOcean、Oracle、Hetzner | 想把 Gateway 放到云服务器上的用户 |
| Northflank、Railway、Render | 想用一键云平台模板 |
| Hostinger | 想用托管面板或 VPS |
| Raspberry Pi | 想在家里放一台小网关 |
| Kubernetes | 团队已有集群 |
如果你只是想先用起来，不需要从这里开始。
安装后必须做的 3 个检查
安装命令跑完，不代表事情结束。 请一定做下面 3 个检查，它们能告诉你“真的装好了没有”。
1. 运行体检
openclaw doctor它会检查配置、服务、权限和常见风险。
2. 查看 Gateway 状态
openclaw gateway statusGateway 是 OpenClaw 的总服务台。它在，OpenClaw 才能接消息。
3. 打开控制 UI
openclaw dashboard浏览器能打开控制 UI，并且能发出第一条消息，就说明安装主链路已经成功。
成功标准很简单：你能在浏览器里问一句话，AI 能回一句话。 如果还没做到，先不要继续接 Telegram、WhatsApp 或远程访问。
常见问题
安装完后提示 openclaw: command not found
这通常是系统 PATH 没找到 npm 的全局命令目录。
先看 npm 全局目录：
npm prefix -g再把它的 bin 加到 PATH。以 zsh 为例：
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc重新打开终端后再试：
openclaw --version我已经装过旧版本，怎么升级？
最简单是重新运行安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash或者：
openclaw update
openclaw doctor
openclaw gateway restart更完整的说明看更新。
我从 Claude 或 Hermes 迁移过来怎么办？
先用 dry-run 预览迁移计划：
openclaw migrate claude --dry-run
openclaw migrate hermes --dry-run详细说明看 从 Claude 迁移 和 从 Hermes 迁移。
想卸载怎么办？
看卸载说明。
下一步
安装完成后，回到快速开始，先用控制 UI 发出第一条消息，再去接 Telegram 或 WhatsApp。