Install guide

Windows 安装 OpenClaw：从环境准备到第一次跑通

这篇教程只走官方推荐的首选路径：Windows 上优先用 WSL2，再用 CLI + daemon + Dashboard 跑通第一轮 onboarding。命令按顺序给出，先解决安装成功率，再谈进阶玩法。

开始安装查看官方来源

快速提示

官方推荐 Windows 首选 WSL2；不建议把默认 CMD 当主要环境。

Node.js 推荐 24，22.16+ 也受支持；先确认 `node -v` 再继续。

首轮目标不是把所有 provider 配满，而是先通过 `onboard -> dashboard -> gateway status -> doctor`。

你将获得

内容风格

少废话，先给结果

先告诉你该做什么、会遇到什么，再给出最短可用路径。

阅读体验

能看懂，也能照着做

重点信息会被拆成清单、步骤和提示，减少第一次上手的理解成本。

页面重点

先把关键问题讲清楚

实用优先

Article brief

这篇文章适合谁，以及今天先解决什么

第一次在 Windows 上安装 OpenClaw、希望少踩路径和权限坑的用户。

预计耗时

20 到 35 分钟

验证日期

2026-03-13

Image plan

图文并茂版本建议至少补这 4 张图

图 1：Windows 功能中已启用 WSL 与虚拟机平台。

图 2：Ubuntu / WSL 终端里 `node -v`、`npm -v` 输出正常。

图 3：执行 `openclaw onboard --install-daemon` 后进入 onboarding。

图 4：`openclaw gateway status` 与 `openclaw doctor` 返回健康状态。

Before you start

安装前准备

先把环境、网络和运行时准备好，再敲第一条安装命令。

准备 1

Windows 11，或已正确启用 WSL2 的 Windows 10。

准备 2

可正常联网，能够访问 `openclaw.ai`、`nodejs.org` 与 npm registry。

准备 3

有一个准备接入 OpenClaw 的模型方案，但今天先不要求全部配置完成。

Hard stops

这篇教程里的停手点

以下情况先停下来排错，不要继续堆命令。

停手点 1

不要在来源不明的 PowerShell 脚本和默认 CMD 环境里混装多套 Node。

停手点 2

不要在 daemon 没起来时急着接模型、技能或浏览器自动化。

停手点 3

如果你必须不用 WSL2，至少切到 Git Bash，并明确 PATH 与 npm 全局目录。

Step by step

按官方顺序安装，别把第一天的目标搞成“大而全”。

每一步都带目的说明和可直接复制的命令。先让安装成功率稳定，再谈配置、Skills 和复杂工作流。

Step 1

步骤 1：先准备 WSL2，而不是直接在默认终端里硬装

官方推荐 Windows 首选 WSL2。它能把大部分路径、权限和 shell 行为拉回 OpenClaw 更稳定的 Linux 语境。

在“启用或关闭 Windows 功能”里打开 `适用于 Linux 的 Windows 子系统` 与 `虚拟机平台`。

从 Microsoft Store 安装 Ubuntu，首次启动时完成 Linux 用户初始化。

如果你以前装过旧版 Node，建议在 WSL2 里重新确认版本，不要直接复用 Windows 全局环境。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

wsl --install -d Ubuntu

Step 2

步骤 2：确认 Node.js 版本，再安装 OpenClaw CLI

官方当前建议 Node.js 24，Node 22.16+ 也受支持。版本不对时，先修 Node，不要先怀疑 OpenClaw。

如果 WSL 里还没有 Node，可以先安装 Node 24。

命令行里先看 `node -v` 与 `npm -v`，两者都正常后再装 CLI。

CLI 安装使用 npm 全局安装，避免在第一轮把安装方式搞得太复杂。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash
sudo apt-get install -y nodejs
node -v
npm -v
npm install -g openclaw@latest

Step 3

步骤 3：先跑 onboard，把 daemon 和 Dashboard 带起来

第一次安装最重要的是 `openclaw onboard --install-daemon`。这一步会把服务安装和 onboarding 串起来。

运行 onboard 之后，先完成引导，不要中途跳去改一堆环境变量。

如果系统提示权限或服务安装确认，先看清提示，再继续。

这一轮先追求能进 Dashboard、能看到 gateway 运行，不追求把所有外部服务一次配齐。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

openclaw onboard --install-daemon
openclaw dashboard

Step 4

步骤 4：用 gateway status + doctor 做第一次验收

安装成功不等于环境健康。你至少要用状态命令和健康检查把“看起来能用”和“真的可继续配置”区分开。

先看 daemon 是否在线。

再跑 doctor；如果你要验证外部服务，再加 `--verify-external-services`。

只有这里通过，才建议继续往模型、Skills 和更高权限能力走。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

openclaw gateway status
openclaw doctor
openclaw doctor --verify-external-services

Verification

完成安装后，至少核对这 5 项

只有这些检查都通过，才算真的完成了第一次系统安装。

检查 1

`node -v` 输出 `v24.x` 或 `v22.16+`。

检查 2

`openclaw onboard --install-daemon` 可以完成首轮引导。

检查 3

`openclaw dashboard` 能打开页面或启动 onboarding。

检查 4

`openclaw gateway status` 返回运行中。

检查 5

`openclaw doctor` 没有阻断性错误。

Copy-ready command

安装完成后的统一验收命令

这组命令适合放在文末，方便用户复制做最终确认。

openclaw dashboard
openclaw gateway status
openclaw doctor

Official sources

本文只优先采信 OpenClaw 官方文档可交叉验证的信息。

涉及脚本安装、Node 版本、onboard、Dashboard、gateway 状态与健康检查的内容，都以官方文档为第一来源。

官方文档 · Installer Scripts

用于核对 `install.sh`、`install-cli.sh`、`install.ps1` 的官方安装方式与推荐场景。

https://docs.openclaw.ai/zh-CN/install/installer

官方文档 · Node.js 安装与排错

用于核对 Node.js 22.16+ / 24、PATH 与全局安装排错建议。

https://docs.openclaw.ai/zh-CN/install/node

官方文档 · Getting Started

用于核对 `openclaw onboard --install-daemon`、Dashboard、gateway 状态与最短验证链路。

https://docs.openclaw.ai/zh-CN/start/getting-started

官方文档 · Doctor & Health Check

用于核对 `openclaw doctor` 与外部服务检查方式。

https://docs.openclaw.ai/zh-CN/config/doctor-and-health-check