OpenClaw 上 Windows 的三条官方安装路线与避坑清单

山止川行AI 前沿2026-09-17849 阅读💛 132 收藏

Windows 用户现在有三种官方支持的方式运行 OpenClaw：Windows Hub、原生 PowerShell CLI，或者 WSL2 Gateway。下面讲怎么选、怎么装，以及怎么避开常见的首次运行坑。

如果你一直在等一个干净、原生的 Windows 方式来跑 OpenClaw，等待结束了。OpenClaw 现在在 Windows 10 和 Windows 11 上提供三条官方支持路径：签名的 Windows Hub 桌面应用、PowerShell CLI/Gateway 安装器，以及面向最 Linux 兼容运行时的完整 WSL2 Gateway。三条路径最终落在同一个 Gateway 上，所以你可以先用 Hub 起步、之后切到 PowerShell，或者反过来，不用推倒重来。

这篇文章把三个选项走一遍：各自什么时候合适，以及那些小但重要、能让首次安装顺畅的细节。

太长不看版

想要桌面应用？ 用 Windows Hub。安装不需要管理员权限，有系统托盘图标，还能在后台自动提供一个应用自有的 WSL Gateway。
日常活在 PowerShell 或 Windows Terminal 里？ 用 PowerShell 安装器。一行命令拿到和 macOS、Linux 用户一样的 CLI 和 Gateway。
需要最 Linux 兼容的运行时？ 用 WSL2。在你的发行版里跑 Linux 安装器，获得完整的 systemd 服务支持。

三条路径都要求受支持的 Node 运行时：推荐 Node 26，同时支持 Node 25.9+、24.15+ 和 22.22.3+。Node 23 不受支持。

路线一：Windows Hub（适合大多数人）

Windows Hub 是最新、最 Windows 原生的选项。它是一个签名的 WinUI 伴侣应用，独立于 OpenClaw CLI 和 Gateway 发布，所以在 Windows 专属特性上迭代更快。

从官方 Windows Hub 发布页下载 x64 或 ARM64 安装器：

OpenClawCompanion-Setup-x64.exe
OpenClawCompanion-Setup-arm64.exe

安装器是按用户安装的，不需要管理员权限。启动后，托盘图标让你快速访问 Chat、Settings、Command Center 诊断和 Check for Updates。

首次运行时，如果还没有配置 Gateway，Hub 会打开 Set up locally。这会创建一个专用的 OpenClawGateway WSL 发行版、在里面安装 Gateway，并自动配对应用。它不会碰你现有的 Ubuntu 或其他 WSL 发行版，你的开发环境保持原样。

如果你已经有 Gateway 跑在别处，用 Advanced setup 或 Connections 标签页把 Hub 指向：

同一台 PC 上的本地 Gateway，
你自己管理的 WSL Gateway，
通过 URL 加 token 或设置码连接的远程 Gateway，
或者通过 SSH 隧道到达的 Gateway。

托盘图标变绿之后，打开 Command Center 确认连接、配对状态、节点健康和频道状态，再去接 Telegram、WhatsApp、Discord、Microsoft Teams 或其他频道。

Windows 节点模式与本地 MCP 模式

Windows Hub 可以把这台 PC 注册为 OpenClaw 节点（node），让 agent 通过 Gateway 使用 Windows 原生能力。可用的能力面包括屏幕截图、摄像头访问、系统通知、设备状态、文字转语音，以及受控的 system.run 执行。命令必须由节点声明、被 Gateway 策略允许，隐私敏感命令如 screen.record、camera.snap 和 camera.clip 需要显式选择加入。

Hub 还可以把同一套能力注册表作为本地 MCP 服务器暴露在 loopback 上。这意味着 Claude Desktop、Claude Code 和 Cursor 可以在完全没有 OpenClaw Gateway 运行的情况下驱动 Windows 能力。模式矩阵很简单：

节点模式关、MCP 服务器关：仅操作者使用的桌面应用
节点模式开、MCP 服务器关：连接 Gateway 的 Windows 节点
节点模式关、MCP 服务器开：仅本地 MCP 服务器
节点模式开、MCP 服务器开：Gateway 节点加本地 MCP 服务器

如果你把 Hub 和 Gateway 配对、而 Gateway 请求审批，用 Gateway 宿主侧命令：

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

路线二：PowerShell CLI + Gateway（适合终端优先用户）

如果你一天本来就泡在 PowerShell 或 Windows Terminal 里，这条路让你留在熟悉的地盘。它安装的 OpenClaw CLI 和 Gateway 与 macOS、Linux 上完全相同，但改用官方 PowerShell 安装器和 Windows 计划任务做托管的后台启动。

打开一个新的 PowerShell 窗口，运行：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装器会检测 Windows、在需要时提供一个受支持的 Node 运行时、安装稳定版 OpenClaw 包，然后启动引导流程。如果你自己管理 Node，保持它在受支持区间内。

安装完成后，打开一个新的 PowerShell 窗口让 PATH 生效，然后验证：

openclaw --version
openclaw doctor
openclaw gateway status --json

Gateway 作为一个无控制台窗口的 Windows 计划任务运行。这个任务启动一个生成的 gateway.vbs WScript 包装器，后者再运行存放在你 OpenClaw 状态目录里的可读 gateway.cmd 脚本。如果 Windows 计划任务不可用或被拒绝，OpenClaw 会退回到按用户的 Startup 文件夹登录项。

文档里的一个小技巧：如果你要编辑 gateway.cmd 重定向输出，把整个目标用引号包起来。例如：

>> "%USERPROFILE%\.openclaw\logs\gateway-stdout.log" 2>&1

不加引号的环境变量展开可能在 Gateway 的参数里留下零散的文件名碎片，导致莫名其妙的所有权检查失败。

路线三：WSL2 Gateway（适合 Linux 原生工具链）

当你想要最 Linux 兼容的 Gateway 运行时、systemd 服务支持，以及和 Linux 队友完全一致的工具时，WSL2 是正确选择。

在你的 WSL2 发行版里运行 Linux 安装器：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | sh

然后验证并启动 Gateway：

openclaw --version
openclaw doctor
openclaw gateway up

这条路径的行为几乎和原生 Linux 安装一致。你得到 systemd 服务管理、标准的 Linux 状态目录布局，以及相同的 shell 安装器参数。如果你遇到看似 WSL 特有的 OAuth 或 Git 集成问题，切到原生 PowerShell 路线或 Windows Hub 往往能解决，因为那些路径直接在 Windows 上跑 Gateway，而不是在 WSL 网络边界之内。

常见首次运行坑

Node 版本不匹配。 Windows 上最常见的安装失败是 Node 版本看起来新、但不在受支持区间。比如 Node 23 就不受支持。如果 openclaw doctor 抱怨 Node，用 nvm-windows 或 fnm 这类版本管理器，或者让安装器替你提供 Node 26。

PowerShell 执行策略。 如果你的执行策略阻止未签名脚本，安装器可能失败。可以用 Get-ExecutionPolicy 查看当前策略，必要时从一个允许远程签名脚本的会话运行安装器。OpenClaw 官方文档对这个场景有专门的排障页面。

PATH 没刷新。 装完之后开一个新的 PowerShell 或终端窗口。openclaw 命令在运行安装器的同一个 shell 会话里是找不到的。

WSL OAuth 怪癖。 有用户报告 GitHub OAuth 流程在 WSL 里因为网络或浏览器启动差异而失败。遇到这种情况，Windows Hub 或原生 PowerShell 路线是更简单的解法。

设备配对和节点审批搞混。 记住设备配对和节点能力面审批是两个独立步骤。先批准设备请求，再重连，然后批准节点请求。两个 ID 不一样。

怎么选

你想要……	推荐路线
带托盘状态的普通桌面应用	Windows Hub
从下载到聊天最快的路径	Windows Hub
可脚本化、可复现、终端优先的安装	PowerShell 安装器
与 macOS/Linux 队友相同的运行时	WSL2 Gateway
Windows 原生屏幕、摄像头和 MCP 访问	Windows Hub
完全不碰 WSL	Windows Hub 或 PowerShell 安装器

结论

Windows 不再是 OpenClaw 的二等公民。无论你想要一个精致的桌面伴侣、PowerShell 原生 CLI，还是完整的 WSL2 Gateway，现在都有对应的第一方路径。从匹配你工作方式的那条开始，跑一遍 openclaw doctor 确认一切健康，然后接上你的第一个频道。agent 会在你已经待着的地方跟你碰面：Windows 上。