--- title: "在 macOS、Linux 和 Windows 上安装 OpenClaw · DotsAgent" description: "使用官方脚本、PowerShell 或 npm 安装 OpenClaw，运行初始化向导，用 openclaw doctor 检查安装，并在 stable、beta 和 dev 更新通道之间切换。" url: https://dotsagent.io/zh/openclaw/install --- OpenClaw 指南 · 5 个步骤 # 安装 OpenClaw 使用官方脚本、PowerShell 安装程序或 npm 安装 openclaw CLI，然后通过初始化向导创建配置、网关 token 和后台服务。 通过 npm 安装需要 Node.js 24.16+ 或 26.1+；安装脚本会为你安装 Node。建议至少配备 1 vCPU、1 GB RAM 和 500 MB 磁盘空间。 1. 在 macOS、Linux 或 WSL2 上运行安装程序 脚本会在需要时安装 Node（macOS 上安装 Node 26，Linux 上安装 Node 24 LTS）和 openclaw CLI，然后启动初始化向导。如需跳过向导进行安装，请将命令改为通过管道传入 bash -s -- --no-onboard，而不是直接传入 bash。 shell`curl -fsSL https://openclaw.ai/install.sh | bash` 2. 或在 Windows 上使用 PowerShell 在原生 Windows 环境中，打开 PowerShell 窗口并运行 PowerShell 安装程序。也可以使用原生 Windows Hub 应用；在 WSL2 中则可以改用第 1 步中的 shell 脚本。 PowerShell`iwr -useb https://openclaw.ai/install.ps1 | iex` 3. 或使用 npm 安装 如果你自行管理 Node，请全局安装此软件包。npm 12 和 11.16+ 需要添加 --allow-scripts=openclaw；npm 11.15 或更早版本则不要添加此标志。运行 onboard --install-daemon 会启动向导并安装服务：在 macOS 上安装 LaunchAgent，在 Linux 和 WSL2 上安装 systemd 用户服务，在 Windows 上安装计划任务。 shell`npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemon` 4. 检查安装 openclaw --version 会显示已安装的版本，openclaw doctor 会运行健康检查，openclaw gateway status 会报告网关服务是否正在运行。版本号采用日期格式，形式为 YYYY.M.N。 shell`openclaw --version openclaw doctor openclaw gateway status` 5. 保持最新 openclaw update 会安装最新版本。使用 --channel 可在 stable、extended-stable、beta 和 dev 通道之间切换；使用 --dry-run 可预览更新而不实际应用。你也可以使用 openclaw update status 和 openclaw update repair。 shell`openclaw update openclaw update --channel beta openclaw update --dry-run` 初始化向导会生成网关 token，并将网关绑定到 127.0.0.1:18789。连接聊天渠道前，请先阅读安全加固指南。 ## 更多 OpenClaw 指南 [在 VPS 上运行 OpenClaw](https://dotsagent.io/zh/openclaw/vps) [在 Docker 中运行 OpenClaw](https://dotsagent.io/zh/openclaw/docker) [在 Raspberry Pi 上运行 OpenClaw](https://dotsagent.io/zh/openclaw/raspberry-pi) [将模型连接到 OpenClaw](https://dotsagent.io/zh/openclaw/models) [将 OpenClaw 连接到 Telegram](https://dotsagent.io/zh/openclaw/telegram) [加固你的 OpenClaw gateway](https://dotsagent.io/zh/openclaw/hardening) [远程访问 OpenClaw](https://dotsagent.io/zh/openclaw/remote-access) ## 来源 1. [docs.openclaw.ai](https://docs.openclaw.ai/install)/install 2. [docs.openclaw.ai](https://docs.openclaw.ai/install/updating)/install/updating 为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。 © 2026 DotsAgent · 事实核查日期：2026年10月1日