OpenClaw Windows Node - OpenClaw 的 Windows 配套套件

这是什么

openclaw/openclaw-windows-node 是一个基于 C# 开发的原生 Windows 配套套件（Companion Suite），旨在为 AI 个人助手框架 OpenClaw 提供本地化支持。该项目由 Scott Hanselman 和 Molty 维护，是一个包含 Windows 中心枢纽、共享客户端库以及 CLI 实用工具的 Monorepo 仓库。

它不仅仅是一个简单的客户端，更是一个功能完备的 Windows 系统托盘应用，通过本地网关（Gateway）与 OpenClaw 后端进行通信。项目支持 x64 和 ARM64 架构，基于 .NET 10.0 SDK 和 WinUI 3 构建，并集成了 WebView2 以提供现代化的 Web 聊天界面。

解决的问题

该项目的核心目标是填补 OpenClaw 在 Windows 平台上的原生体验空白，解决以下痛点：

1. 缺乏原生 Windows 入口：OpenClaw 本身可能更偏向于 Linux/macOS 或 Web 端操作，Windows 用户此前缺乏一个直观、集成的桌面级交互界面。
2. 本地网关管理复杂：通过 WSL（Windows Subsystem for Linux）运行网关对于普通用户门槛较高。该项目提供了简化的安装流程和配置管理，甚至支持创建锁定状态的专用 WSL 发行版作为本地网关。
3. 设备控制与可观测性缺失：用户难以直观地监控 AI 代理（Agent）的状态、会话活动、资源使用情况以及连接的节点（Nodes）。
4. 跨平台功能不对称：此前 macOS 版本（openclaw-menubar）拥有较好的菜单栏集成，而 Windows 用户缺少同等深度的系统级集成（如全局快捷键、Toast 通知、系统托盘状态指示）。

核心功能

• 现代化系统托盘集成：
  • 提供 Windows 11 风格的 Flyout 菜单，支持深色/浅色模式。
  • 带有像素风龙虾（Lobster）品牌图标，并根据连接状态显示不同颜色。
  • 支持开机自启（Auto-start）。
• Quick Send（快速发送）：
  • 支持通过全局快捷键（默认 Ctrl+Alt+Shift+C）直接发送消息。
  • 底层调用网关的 chat.send 方法，要求设备具备 operator.write 权限。
  • 具备智能错误处理：若权限不足，会自动将身份信息和修复指南复制到剪贴板；若需配对，会提示在网关端批准设备。
• Command Center（命令中心）：
  • 高密度信息仪表盘，集中展示网关诊断、通道健康状态、资源用量、会话列表、节点状态和配对/白名单信息。
  • 提供可复制的修复命令和摘要信息，便于调试。
• Node Mode（节点模式）：
  • 允许 Windows PC 作为 OpenClaw 代理控制的“节点”。
  • 代理可执行系统通知、运行命令、控制画布（Canvas）、截图、调用摄像头、获取位置信息及文本转语音（TTS）等操作。
  • 通过网关侧的 allowCommands 白名单机制严格控制权限，确保隐私安全（如 screen.record 需显式开启）。
• 实时状态与通知：
  • 实时显示会话、通道和用量数据。
  • 支持带有智能分类的 Windows Toast 通知，点击可跳转详情。
  • 活动流（Activity Stream）页面实时展示会话、用量、节点和通知事件。
• 通道控制：
  • 直接在菜单中启动或停止 Telegram 和 WhatsApp 通道连接。
• Web Chat 嵌入：
  • 基于 WebView2 的嵌入式聊天窗口，提供完整的 Web 交互体验。
• CLI 调试与验证：
  • 提供 OpenClaw.Cli 工具，用于验证网关连通性、发送测试消息、循环探测 API 以及覆盖网关 URL/Token 进行隔离测试。

亮点 / 与同类相比

• 与 macOS 版本（openclaw-menubar）对比：
  • 功能更丰富：Windows 版本提供了 macOS 版本不具备的 Node Mode（节点控制）、更详细的 Command Center 诊断面板、以及更完善的系统级集成（如 Toast 通知、全局快捷键）。
  • 架构优势：基于 WinUI 3 和 .NET，提供了更原生的 Windows 11 UI 体验。
• 安全性与权限控制：
  • 在 Node Mode 下，采用显式的 allowCommands 白名单机制，而非通配符（如 canvas.* 无效），确保只有明确授权的命令才能执行，极大提升了作为受控节点的安全性。
  • 打包安装声明了相机、麦克风和位置权限，首次使用时会触发 Windows 标准权限请求。
• 开发友好性：
  • 提供完整的构建脚本（build.ps1）和多种构建选项（Debug/Release, MSIX 打包, ARM64/x64）。
  • 支持通过 run-app-local.ps1 进行隔离测试，允许同时运行多个工作树实例，便于开发调试。
• 自动化与更新：
  • 支持从 GitHub Releases 自动更新。
  • 提供 Alpha 更新通道测试，便于早期用户反馈。

适合谁用 / 上手

适合人群：

• OpenClaw 重度用户：需要在 Windows 环境下高效管理 AI 代理会话、监控资源用量和调试网关连接的用户。
• 开发者与测试人员：需要利用 CLI 工具进行 API 验证、网关连通性测试或 Node Mode 功能开发的人员。
• 追求自动化与集成的用户：希望将 AI 助手深度集成到 Windows 系统托盘、利用全局快捷键快速交互，并希望通过 Windows PC 作为受控节点执行系统级任务（如截图、通知）的用户。

上手指南：

1. 安装：
   • 推荐方式：从 OpenClaw Windows 文档下载最新的稳定版 x64 或 ARM64 安装程序。
   • 源码构建：克隆仓库后，确保安装 .NET 10.0 SDK 和 Windows 10 SDK。运行 .\build.ps1 进行构建。
2. 首次运行：
   • 启动应用后，会进入 6 屏的设置向导，引导完成连接、权限、聊天、配置等步骤。
   • 默认启用 Node Mode，首次连接会在网关端生成配对请求。
3. 配置网关权限：
   • 在网关端执行 openclaw devices list 找到 Windows 设备 ID。
   • 执行 openclaw devices approve <id> 批准设备。
   • 在 ~/.openclaw/openclaw.json 中配置 gateway.nodes.allowCommands，明确列出允许 Windows 节点执行的命令（注意：不支持通配符）。
4. 日常使用：
   • 点击托盘图标打开 Flyout 菜单，查看状态、发送消息或管理通道。
   • 使用 Ctrl+Alt+Shift+C 快速发送消息。
   • 通过 Command Center 监控详细的活动和诊断信息。
5. 调试：
   • 使用 dotnet run --project src/OpenClaw.Cli 命令行工具进行连通性测试和消息发送验证。