OpenClaw Windows 安装教程，WSL2 部署和使用指南

如果你的主力电脑是 Windows，最稳的结论其实很简单：把 OpenClaw 的 CLI 和 Gateway 放进 WSL2 里跑。官方平台页写得很明确，Windows 推荐通过 WSL2 使用，尤其推荐 Ubuntu。原因不是“原生 Windows 完全不能用”，而是 OpenClaw 依赖的运行时、工具链、守护进程模型和很多扩展能力，本质上更贴近 Linux。

为什么 WSL2 是主路径#

官方对 Windows 的判断可以概括成三句话：

• WSL2 能提供更完整的 Linux 运行环境
• Node、Bun、pnpm、Linux 二进制和 Skills 在这里兼容性更高
• 原生 Windows 仍在持续改进，但长期稳定运行 Gateway 还不是推荐路径

对教程站读者来说，可以把它理解成：

• Windows 负责桌面体验、浏览器、编辑器
• WSL2 负责命令行、守护进程、渠道连接和大多数自动化能力

这样做的好处是，后面你看到的大多数官方安装、排障、日志和 system service 文档，都能直接复用 Linux 方案，不需要为 Windows 单独绕路。

最推荐的部署结构#

方案 A：Windows + WSL2 本机运行

适合：

• 你想先在自己的电脑上体验 OpenClaw
• 目前不打算买 VPS 或单独准备一台 24/7 主机
• 可以接受这台电脑睡眠时 Gateway 也会暂停

方案 B：Windows 只做控制端

适合：

• Gateway 跑在 Linux、VPS、家里主机或 Raspberry Pi 上
• Windows 主要用于浏览 Dashboard、SSH 管理和编辑配置

如果你的目标是长期在线、稳定接渠道、少踩平台坑，方案 B 往往更省心。但如果你只是先想把本地链路跑通，方案 A 足够开始。

第一步：安装 WSL2#

官方平台页直接给出了最短命令：

wsl --install

执行后一般会自动安装：

• WSL2
• 推荐发行版

更稳妥的做法是把默认发行版设置成 Ubuntu，然后在 Ubuntu 里继续后面的安装流程。

装完后先确认：

wsl --status
wsl -l -v

理想状态是你看到：

• 默认发行版已经装好
• 版本为 2

第二步：把 OpenClaw 安装流程放到 WSL2 里执行#

接下来的所有核心命令，都建议在 WSL2 的 Linux shell 里完成，而不是 PowerShell 或 CMD：

1. 安装 Node 24，或者至少 Node 22.16+
2. 安装 OpenClaw CLI
3. 运行 onboarding
4. 安装 Gateway 服务

一个最短路径可以是：

npm i -g openclaw@latest
openclaw onboard --install-daemon

如果你已经看过 Linux 教程，这里基本就是同一套流程，只是宿主机变成了 WSL2。

第三步：在 Windows 浏览器里访问 Dashboard#

当 Gateway 跑在 WSL2 里时，日常操作通常是：

1. 在 WSL2 里启动或安装 Gateway
2. 在 Windows 浏览器中打开 Dashboard
3. 需要时从 Windows 的编辑器修改仓库文件
4. 回到 WSL2 执行 openclaw 命令

这种分工非常自然，因为：

• 浏览器和桌面应用仍在 Windows 上
• 实际运行环境保持 Linux 兼容

原生 Windows 现在能做什么#

官方平台页也没有完全否定原生 Windows。当前已经能正常工作的内容包括：

• 通过 install.ps1 使用网站安装器
• 基础 CLI 命令，例如 openclaw --version
• 诊断命令，例如 openclaw doctor
• 查看插件列表，例如 openclaw plugins list --json
• 本地 smoke test，例如：

openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."

这说明原生 Windows 并不是完全不可用，但它更适合：

• 做基础 CLI 验证
• 做轻量本地测试
• 验证安装本身是否正常

而不是把它当作长期承载 Gateway 和多个渠道的最终生产环境。

原生 Windows 当前有哪些注意事项#

官方文档点了两个很实际的问题：

• openclaw onboard --non-interactive 默认仍然要求本地 Gateway 可访问，除非你显式传 --skip-health
• openclaw onboard --non-interactive --install-daemon 和 openclaw gateway install 会优先尝试 Windows Scheduled Tasks

这两个点说明什么？

• 你在原生 Windows 上跑无交互安装时，健康检查和守护进程安装逻辑与 Linux 不完全一样
• 排障资料和社区经验也会更少

所以如果你不是在专门验证 Windows 兼容性，真的没必要把自己逼到这条路上。

推荐的实际使用方法#

新手最省心方案

1. 在 Windows 上安装 WSL2
2. 在 Ubuntu 里安装 Node 和 OpenClaw
3. 在 WSL2 里运行 openclaw onboard --install-daemon
4. 从 Windows 浏览器访问 Dashboard
5. 如果以后需要长期在线，再迁移到 Linux / VPS

已经有远程主机的方案

1. 让远程 Linux 运行 Gateway
2. Windows 只保留 SSH、浏览器和本地编辑器
3. 需要时用端口转发访问 Dashboard

这套结构通常比“在 Windows 本机硬跑一切”更贴近官方推荐。

什么时候应该放弃本机 Windows 承载#

如果你遇到下面这些情况，基本就可以判断该把 Gateway 挪走了：

• 电脑经常休眠或关机
• 需要 24/7 接收 Telegram / WhatsApp / Google Chat 消息
• 需要更稳定的日志、守护进程和重启恢复能力
• 需要长期挂着远程渠道和工具

这时候最合理的做法不是继续折腾 Windows，而是把 Gateway 迁移到 Linux、VPS 或 Raspberry Pi。

常见误区#

误区 1：Windows 上能执行 openclaw --version 就说明适合长期运行

不对。能跑 CLI 和能长期稳定跑 Gateway 是两件事。官方明确把这两者区分开了。

误区 2：WSL2 只是“兼容层”，所以性能一定很差

对 OpenClaw 这类以 Node、网络 IO 和外部 API 为主的系统来说，WSL2 通常足够稳定，兼容性收益远大于这点差异。

误区 3：既然是 Windows 用户，就应该尽量全程只用 PowerShell

不建议。OpenClaw 目前大部分成熟文档、守护进程习惯和命令示例都更贴近 Linux shell，WSL2 才是更少坑的路径。

一条很实用的判断标准#

你可以这样理解官方建议：

• 想体验：Windows + WSL2
• 想长期在线：Linux / VPS / Raspberry Pi
• 想少踩平台坑：不要把原生 Windows 当主承载环境

如果你只记住这一条，后面很多平台决策都会简单很多。