Skip to main content
OpenClaw 提供原生 Windows Hub 配套应用以及 Windows CLI 支持。 当你需要带有设置、托盘状态、聊天、Command Center 诊断和 Windows 节点能力的桌面应用时，请使用 Windows Hub。你想直接使用 CLI/Gateway 时，请使用 PowerShell 安装程序。你想要最兼容 Linux 的 Gateway 运行时环境时，请使用 WSL2。

​
推荐：Windows Hub

Windows Hub 是面向 Windows 10 20H2+ 和 Windows 11 的原生 WinUI 配套应用。它无需管理员权限即可安装，并随 OpenClaw 发布版提供已签名的 x64 和 ARM64 安装包。 下载最新稳定版安装程序： 安装后，从开始菜单或系统托盘启动 OpenClaw Companion。安装程序还会添加 Gateway Setup、Chat、Settings、 Check for Updates 和卸载的快捷方式。

​
Windows Hub 包含内容

  • 系统托盘状态和开机登录自启动
  • 为本地、应用自有的 WSL Gateway 提供首次运行设置
  • 本地、远程和通过 SSH 隧道连接的 Gateway 的连接设置
  • 原生聊天窗口以及对浏览器 Control UI 的访问
  • 用于会话、用量、通道、节点、配对和修复命令的 Command Center 诊断
  • Windows 节点模式，支持代理控制的画布、屏幕、摄像头、通知、 设备状态、文本转语音、语音转文本以及受控的 system.run
  • 面向 MCP 客户端（如 Claude Desktop、Claude Code 和 Cursor）的本地 MCP 服务器模式

​
首次启动

首次启动时，如果没有可用的已保存 Gateway，Windows Hub 会打开设置界面。 最快的方式是选择 Set up locally，它会创建一个应用自有的 OpenClawGateway WSL 发行版，在其中安装 Gateway，并完成应用配对。 这不会导出或修改你现有的 Ubuntu 发行版。 当你已经有 Gateway 时，选择 Advanced setup 或打开 Connections 选项卡。 你可以连接到：
  • 这台电脑上的本地 Gateway
  • 这台电脑上的 WSL Gateway
  • 通过 URL 和 token 或设置代码连接的远程 Gateway
  • 通过 SSH 隧道到达的 Gateway
设置完成后，托盘图标会变为绿色。从托盘打开 Command Center 以确认连接、配对、节点状态和通道健康状况。

​
Windows 节点模式

Windows Hub 可以注册为一等 OpenClaw 节点。随后，代理可以通过 Gateway 使用声明的 Windows 原生能力。 常见命令包括：
  • canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot
  • screen.snapshot 以及在明确选择启用后可用的 screen.record
  • camera.list 以及在明确选择启用后可用的 camera.snap, camera.clip
  • system.notify, system.run, system.run.prepare, system.which
  • location.get, device.info, device.status
  • stt.transcribe, tts.speak
节点模式需要 Gateway 配对。如果应用显示配对请求，请在 Gateway 主机上批准： 
openclaw devices list
openclaw devices approve <request-id>
openclaw nodes status
Gateway 只会转发节点声明且服务器策略允许的命令。诸如 screen.record、camera.snap 和 camera.clip 这类涉及隐私的命令需要显式启用 gateway.nodes.allowCommands。

​
本地 MCP 模式

Windows Hub 可以将同样的 Windows 原生能力注册表作为本地 loopback 上的 MCP 服务器导出。当你希望本地 MCP 客户端在没有运行 OpenClaw Gateway 的情况下驱动 Windows 能力时，这很有用。 在 Windows Hub 设置中的开发者/高级部分启用它。启用服务器后，应用会显示 loopback 端点和 bearer token。 模式矩阵：
Node modeMCP server行为
offoff仅供操作者使用的桌面应用
onoff连接到 Gateway 的 Windows 节点
offon仅本地 MCP 服务器
ononGateway 节点加本地 MCP 服务器

​
原生 Windows CLI 和 Gateway

如果偏好终端优先使用方式，请通过 PowerShell 安装 OpenClaw： 
iwr -useb https://openclaw.ai/install.ps1 | iex
验证： 
openclaw --version
openclaw doctor
openclaw gateway status --json
原生 Windows CLI 和 Gateway 流程均受支持，并且仍在持续改进。 在可用时，托管启动会使用 Windows 计划任务；若任务创建被拒绝，则回退为 每用户 Startup 文件夹登录项。 要安装 Gateway 服务： 
openclaw gateway install
openclaw gateway status --json
如果你只想使用 CLI，而不使用受管的 Gateway 服务： 
openclaw onboard --non-interactive --skip-health
openclaw gateway run

​
WSL2 Gateway

WSL2 仍然是在 Windows 上最兼容 Linux 的 Gateway 运行时。Windows Hub 可以为你设置一个应用自有的 WSL Gateway，或者你也可以在自己的发行版中手动安装。 手动设置： 
wsl --install
# 或者显式选择一个发行版：
wsl --list --online
wsl --install -d Ubuntu-24.04
在 WSL 中启用 systemd： 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
从 PowerShell 重启 WSL： 
wsl --shutdown
然后使用 Linux 快速开始在 WSL 中安装 OpenClaw： 
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw gateway status

​
在 Windows 登录前自动启动 Gateway

对于无头 WSL 设置，请确保即使没有人登录 Windows，完整启动链也会运行。 在 WSL 中： 
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install
在 PowerShell 中以管理员身份： 
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

​
通过 LAN 暴露 WSL 服务

WSL 有自己的虚拟网络。如果另一台机器必须访问 WSL 内的服务，请将 Windows 端口转发到当前 WSL IP。WSL IP 在重启后可能会变化，因此需要时请刷新转发规则。 PowerShell 管理员示例： 
$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "未找到 WSL IP。" }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
注意：
  • 从另一台机器通过 SSH 连接时，目标是 Windows 主机 IP，例如 ssh user@windows-host -p 2222。
  • 远程节点必须指向可访问的 Gateway URL，而不是 127.0.0.1。
  • 局域网访问使用 listenaddress=0.0.0.0。仅本地访问使用 127.0.0.1。

​
故障排查

​
托盘图标未出现

在任务管理器中检查 OpenClaw.Tray.WinUI.exe。如果它正在运行，请打开 隐藏的托盘图标区域并将其固定。如果它没有运行，请从开始菜单启动 OpenClaw Companion。

​
本地设置失败

从 Windows Hub 打开设置日志，或查看： 
notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"
常见原因包括 WSL 被禁用、虚拟化被阻止、应用自有的 WSL 状态陈旧，或者安装 Gateway 包时网络故障。

​
应用提示需要配对

从 Gateway 批准操作者或节点请求： 
openclaw devices list
openclaw devices approve <request-id>
如果设备已经有 token，请在批准后从 Connections 选项卡重新连接。

​
Web chat 无法连接到远程 Gateway

远程 web chat 需要 HTTPS 或 localhost。对于自签名证书，请在 Windows 中信任该证书，或者使用 SSH 隧道连接到 localhost URL。

​
screen.snapshot、摄像头或音频命令失败

确认 Windows 对摄像头、麦克风、屏幕捕获和通知的权限。打包安装会声明受保护的能力，但 Windows 在命令首次使用它们时仍可能弹出提示。

​
Git 或 GitHub 连接失败

某些网络会阻止或限制到 GitHub 的 HTTPS。如果 git clone 或 gh auth login 失败，请尝试其他网络、VPN 或 HTTP/HTTPS 代理。 当前会话中基于 token 的 gh 认证： 
$env:GH_TOKEN="<your-token>"
gh auth status
gh auth setup-git
切勿提交 token，也不要将其粘贴到 issue 或 pull request 中。

​
相关