Windows 用户安装 OpenClaw 时，最容易犯的错误，不是命令打错，而是一开始就选错路线。很多人听说"Windows 也支持"，就默认自己应该直接走原生 Windows 安装；结果折腾一圈才发现，官方虽然支持原生 Windows，但真正更稳、更完整的体验路径，其实是 WSL2。这不是一句泛泛的建议，而是官方 Windows 文档明确写出来的：OpenClaw 同时支持原生 Windows 和 WSL2，但 WSL2 是更稳定、也更推荐的完整路线。
所以这篇文章要解决的，不是"给你一条安装命令"那么简单，而是先把一个更关键的问题说透：在 Windows 上安装 OpenClaw 之前，你到底该准备哪种环境，为什么这样准备，哪种选择最适合新手。 只要你把路线选对，后面的安装其实并不复杂；但如果路线选错，后面你每修一个坑，都会像在泥里拔腿。
一、先把官方态度看清楚：Windows 能装，但 WSL2 更稳
官方 Windows 平台文档写得非常直白：OpenClaw 支持原生 Windows 和 WSL2，两者都能用；但 WSL2 是更稳定、并且更推荐的完整体验路径，因为 CLI、Gateway 和工具链都在 Linux 环境里运行，兼容性更完整。与此同时，官方也说明原生 Windows 的核心 CLI 和 Gateway 已经可用，只是还存在一些 caveats，也就是现实中的限制和绕路点。
这句话你一定要读懂。它不是说"原生 Windows 不能用"，而是说：能用，不等于适合新手当第一选择。 如果你只是想稳稳把 OpenClaw 跑起来，不想一边装一边兼职当兼容性测试员，那就别犟，优先走 WSL2。官方连 CLI onboarding 文档里都再次强调，Windows 场景下推荐通过 WSL2 走引导配置。
二、为什么新手最该优先准备 WSL2
很多没碰过 WSL 的用户，一听这个名字就紧张，觉得是不是要学很深的 Linux。其实没有那么夸张。你可以把 WSL2 理解成：在 Windows 里准备一个更适合开发工具运行的 Linux 子环境。 对 OpenClaw 这类依赖 Node、CLI、Gateway、后台服务的工具来说，这个环境往往比原生 Windows 更顺手，也更接近官方默认支持最完整的那条路。
微软官方现在给 WSL 的安装方式也已经非常简单。管理员权限打开 PowerShell 后，执行 wsl --install，系统会自动启用所需功能并安装默认 Linux 发行版；如果你想指定发行版，也可以先用 wsl --list --online 查看可选列表，再用 wsl --install -d <发行版名> 安装。微软文档还特别说明，新通过 wsl --install 装出来的 Linux，默认就是 WSL 2。
也就是说，今天的 WSL2 早就不是那种需要你查半天教程、手工拼一堆组件的东西了。对于 OpenClaw 新手来说，它更像一条"少踩坑通道"。你不一定要理解它所有底层原理，但你最好别绕开它。
三、Windows 安装前最正确的第一步：先把 WSL2 装好
如果你决定按最稳的路走，那第一步就是在管理员 PowerShell 中安装 WSL：
wsl --install
如果你想自己选系统版本，可以这样：
wsl --list --online
wsl --install -d Ubuntu-24.04
这些命令都来自微软官方的 WSL 安装说明，而 OpenClaw 的 Windows 文档也直接把这套流程列为了分步安装的一部分。执行完以后，如果系统提示重启，就老老实实重启。
第一次启动新装的 Linux 发行版时，系统会完成文件解压和初始化。别急着马上装 OpenClaw，先确认你确实进入了 WSL 的 Linux 终端，而不是还在 PowerShell 里原地打转。很多新手后面命令跑不通，不是命令有问题，而是跑错了壳。
四、OpenClaw 在 WSL2 里真正依赖的，不只是 Linux，还有 systemd
这一步很多人会忽略，但对后续后台服务安装非常关键。官方 Windows 文档明确写到，在 WSL2 分步安装中，启用 systemd 是安装 Gateway 服务所必需的。官方给出的做法，是在 WSL 里写入 /etc/wsl.conf，加入 [boot] 和 systemd=true，然后回到 PowerShell 执行 wsl --shutdown，再重新打开发行版，用 systemctl --user status 验证。
官方示例是这样的：
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
然后在 PowerShell 里执行：
wsl --shutdown
重新进入 WSL 后，再检查：
systemctl --user status
这一步的意义很简单：没有 systemd，后面很多"把 Gateway 装成服务、让它自己起来"的能力就立不住。你安装前如果跳过了这一步，后面就很容易陷入一种诡异状态：命令看起来装上了，但服务行为始终不稳定。
五、Node 环境别想复杂：知道版本线就够了
不管你走 WSL2 还是原生 Windows，Node 都是 OpenClaw 的基础运行时。官方要求是 Node 22.14 或以上，推荐默认是 Node 24。同时官方安装页明确说明：如果你使用推荐安装脚本，Node 检测和补装会自动处理；只有当你想自己掌控 Node 环境时，才需要手工安装。
如果你走原生 Windows，自行安装 Node 时，官方建议用 winget install OpenJS.NodeJS.LTS，也可以用 Chocolatey，或者直接从 Node 官网下载安装包。你可以先用下面这条命令检查版本：
node -v
如果输出是 v24.x.x，那就是官方当前最推荐的默认环境；如果是 v22.14.x 以上，也在支持范围内。
这里还有个很多新手容易误会的点：pnpm 不是人人都必须提前装。 官方安装页写得很清楚，pnpm 主要是给从源码构建的人准备的；普通推荐安装路线并不要求你一开始就自己把整套前端/构建工具链准备好。
六、如果你非要走原生 Windows，也不是不行，但你必须知道它的现实边界
官方没有否认原生 Windows，而是把它放在了"可用，但要知道限制"的位置。官方文档列出了目前原生 Windows 上工作得比较好的部分，包括网站安装器 install.ps1、一些基础 CLI 命令，例如 openclaw --version、openclaw doctor、openclaw plugins list --json，以及本地 agent/provider 的基础 smoke 测试。
但文档同样列出了一串你安装前就该知道的 caveats。比如，openclaw onboard --non-interactive 仍然默认希望能访问到本地 Gateway，除非你显式加上 --skip-health；openclaw gateway install 和带 --install-daemon 的 onboarding，会优先尝试 Windows Scheduled Tasks；如果创建任务被拒绝，OpenClaw 会退回到当前用户的 Startup 文件夹登录自启；如果 schtasks 本身卡死，它会快速放弃这条路径，避免无限挂起。
这段话翻成大白话就是：原生 Windows 不是不能装，而是你得接受它在后台服务管理上会绕一些 Windows 自己的机制，而这些机制本身就不如 Linux/WSL2 那么顺。对于新手来说，这种"不一定报错，但可能绕来绕去"的环境，比纯命令报错还烦。
七、原生 Windows 场景下，安装前最好先想清楚你到底要什么
如果你只是想先体验一下原生 CLI，不急着搞后台托管服务，官方已经给了更轻量的做法。比如可以用：
openclaw onboard --non-interactive --skip-health
openclaw gateway run
如果你反而就是想在原生 Windows 上把自启动和托管状态接上，那么官方建议用：
openclaw gateway install
openclaw gateway status --json
这类命令背后的逻辑，官方写得很清楚：有条件时优先用 Scheduled Tasks，没有权限时再回退到 Startup 文件夹方案。你安装前如果先想清楚"我是只要 CLI，还是要服务托管"，后面就不会因为模式没选对而反复折腾。
八、想让 WSL2 里的 OpenClaw 在 Windows 登录前也起来，你还要准备一条完整启动链
如果你只是自己本机偶尔打开用一下，其实到这里已经够了。但如果你希望它更像一台长期运行的小服务机，比如重启电脑后不用你登录 Windows 桌面，它也能把 Gateway 拉起来，那官方 Windows 文档还给出了一条完整的启动链。
第一步，在 WSL 内执行：
sudo loginctl enable-linger "$(whoami)"
第二步，安装 OpenClaw 的用户服务：
openclaw gateway install
第三步，在管理员 PowerShell 中创建一个开机时启动 WSL 的计划任务：
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
其中 Ubuntu 要换成你自己的发行版名，可以先用 wsl --list --verbose 查。官方还给出了验证方法：重启之后，在 WSL 内用 systemctl --user is-enabled openclaw-gateway.service 和 systemctl --user status openclaw-gateway.service --no-pager 看服务状态。
这一套看上去比"装个软件"复杂很多，但它的价值就在于稳定。你安装前如果已经想好未来想把 OpenClaw 当成长期运行环境，那就最好一开始就按官方这条完整链路去部署，而不是后面边用边补。
九、Windows 下另一个大坑：WSL 和 Windows 不是同一个网络世界
很多小白第一次碰 WSL2 时，都会天然以为：既然都在同一台电脑里，那服务地址应该完全一样。实际不是。官方 Windows 文档明确提醒，WSL 有自己的虚拟网络。如果别的设备需要访问运行在 WSL 里的服务，比如 SSH、本地 TTS 服务，或者 OpenClaw Gateway，你就必须把 Windows 的端口转发到当前 WSL IP；而这个 IP 在重启后可能变化，所以端口转发规则有时也要刷新。
官方给出了 netsh interface portproxy 的示例，还提醒你同时要开 Windows 防火墙规则。并且有个很关键的说明：如果你希望只是本机可见，用 127.0.0.1；如果你想让局域网可见，才用 0.0.0.0。这个区别你安装前一定要懂，因为它直接关系到服务暴露范围。
更进一步，OpenClaw 自己的安全文档也明确提醒：Gateway 和 node host 属于受信任操作边界，默认产品模型更偏向"单操作者可信环境"，并不等于天生适合公网多租户暴露；浏览器工具文档更是直接建议把 Gateway 和 node host 保持在私有网络里，优先回环地址或 tailnet，不要随手暴露到公网。
十、等环境都铺平了，再开始正式安装
当你把 WSL2、systemd、Node 和路径选择都搞明白之后，安装本身反而很简单。官方安装页给出的推荐方式是：
WSL2、Linux 或 macOS：
curl -fsSL https://openclaw.ai/install.sh | bash
原生 Windows PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex
如果你只想先装不想立刻跑 onboarding，也都可以加上跳过 onboarding 的参数。官方安装页明确说明，这个安装器会检测系统、按需安装 Node、安装 OpenClaw，并在适当的时候启动 onboarding。
装完以后，官方推荐的检查思路很统一：先跑 onboarding 或 configure，再用 openclaw health 看健康状态，出了问题用 openclaw doctor 做修复和迁移；后续升级，则推荐 openclaw update，它会自动识别安装类型、拉取版本、运行 openclaw doctor 并重启 Gateway。
十一、写在最后：Windows 篇最重要的不是"怎么装"，而是"别装错"
如果你只记住一句话，那就记住这句：Windows 上安装 OpenClaw，先决定你是要"更稳的 WSL2"，还是要"可用但限制更多的原生 Windows"。 这个决定，远比后面那一条安装命令更重要。官方文档已经把态度说得很清楚：WSL2 更稳，更完整，更适合作为主路线。
很多人不是败在不会操作，而是败在"明明有更顺的路，非要先冲最拧巴的那条"。你把 WSL2、systemd、Node 版本和网络边界这些前置条件准备好，OpenClaw 在 Windows 上的安装和运行，会比你想象得清晰得多。真正难的不是安装，而是你有没有先把环境想明白。
问题求助
没能解决你的问题？直接问我
如果你遇到任何技术问题无法解决，可以在这里提交求助。我会尽快查看并回复你。
支持作者
如果这篇文章帮到了你，可以支持我
扫码打赏，支持我持续更新原创排障文章。
