Install guide

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

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

开始安装查看官方来源

Implementation notes

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

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

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

Signal board

Runtime

Static export

Optimized for predictable Cloudflare Pages deploys.

Content model

Shared data layer

One set of structures will power homepage, lists, and showcase proof.

Editorial tone

Safer, quieter, sharper

Trust-led

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