OpenClaw Windows Hub 介绍OpenClaw 是一款由 AI 驱动的个人助手而 OpenClaw Windows Hub 则是其原生 Windows 配套套件。它由 Scott Hanselman 和 Molty Projects 打造。这个单仓库包含了 Windows 中心、共享客户端库和 CLI 实用工具。项目描述-OpenClaw.Tray.WinUI基于 WinUI 3 的系统托盘应用程序可让你快速访问 OpenClaw。-OpenClaw.Shared共享网关客户端库。-OpenClaw.Cli使用托盘设置进行 WebSocket 连接、发送和探测的 CLI 验证器。快速开始终端用户安装程序你可以从 OpenClaw Windows 文档中下载最新的稳定版 x64 或 ARM64 安装程序也可以查看 docs/SETUP.md 以获取分步安装说明无需构建。托管 WSL 网关本地设置会创建一个受限制的、由应用程序拥有的 OpenClawGateway 发行版。你可以查看 docs/WSL_GATEWAY_ADMIN.md以 openclaw 用户身份编辑 openclaw.json并使用 root 权限进行受保护文件的管理。直接从最新的 OpenClaw 版本下载- OpenClawCompanion-Setup-x64.exe- OpenClawCompanion-Setup-arm64.exe- OpenClawCompanion-SHA256SUMS.txt先决条件- Windows 1020H2或 Windows 11- .NET 10.0 SDK - [下载地址](https://dotnet.microsoft.com/download/dotnet/10.0)- Windows 10 SDK用于 WinUI 构建 - 可通过 Visual Studio 安装或独立安装- WebView2 Runtime - 现代 Windows 系统已预装也可从 [这里](https://developer.microsoft.com/microsoft-edge/webview2) 获取构建你可以使用构建脚本来检查先决条件并进行构建# 检查先决条件 .uild.ps1 -CheckOnly # 构建所有项目 .uild.ps1 # 构建特定项目 .uild.ps1 -Project WinUI或者直接使用 dotnet 进行构建# 构建所有项目使用 build.ps1 可获得最佳效果 dotnet build # 构建 WinUI需要运行时标识符以支持 WebView2 dotnet build src/OpenClaw.Tray.WinUI/OpenClaw.Tray.WinUI.csproj -r win-arm64 # ARM64 dotnet build src/OpenClaw.Tray.WinUI/OpenClaw.Tray.WinUI.csproj -r win-x64 # x64 # 构建 MSIX 包用于相机/麦克风权限提示 dotnet build src/OpenClaw.Tray.WinUI -r win-arm64 -p:PackageMsixtrue # ARM64 MSIX dotnet build src/OpenClaw.Tray.WinUI -r win-x64 -p:PackageMsixtrue # x64 MSIX运行托盘应用# 构建并启动未打包的 WinUI 托盘应用 . un-app-local.ps1 # 如果你已经构建过跳过重建并启动现有的调试输出 . un-app-local.ps1 -NoBuild # 与正常的托盘设置隔离运行以便多个工作树可以同时运行 . un-app-local.ps1 -Isolated # 从发布版本进行 Alpha 更新测试 . un-app-local.ps1 -Configuration Release -Isolated -UpdateChannel alpha # 可选通过 WinAppCLI 并使用 Package.appxmanifest 启动 . un-app-local.ps1 -UseWinApp -NoBuild默认路径会直接启动未打包的可执行文件。使用 -UseWinApp 需要安装 Microsoft WinAppCLIwinget install Microsoft.WinAppCLI仅在你需要进行清单/MSIX 相关的启动验证时才需要。运行 CLI WebSocket 验证器你可以使用 CLI 来验证网关连接并在托盘 UI 之外发送聊天消息。# 显示帮助信息 dotnet run --project src/OpenClaw.Cli -- --help # 使用 %APPDATA%\OpenClawTray\settings.json 中的托盘设置并发送一条消息 dotnet run --project src/OpenClaw.Cli -- --message quick send validation # 循环发送消息并探测会话/使用情况/节点 API dotnet run --project src/OpenClaw.Cli -- --repeat 5 --delay-ms 1000 --probe-read --verbose # 覆盖网关 URL/令牌以进行隔离测试 dotnet run --project src/OpenClaw.Cli -- --url ws://127.0.0.1:18789 --token --message override testOpenClaw.TrayMolty功能-龙虾品牌带有状态颜色的像素艺术龙虾托盘图标。-现代 UI支持黑暗/明亮模式的 Windows 11 弹出菜单。-快速发送通过全局热键CtrlAltShiftC发送消息。-自动更新从 GitHub Releases 自动更新。-网页聊天使用 WebView2 嵌入的聊天窗口。-实时状态实时显示会话、频道和使用情况。-指挥中心在一个窗口中提供密集的网关、频道、使用情况、节点、配对和允许列表诊断信息。-活动流用于实时会话、使用情况、节点和通知事件的指挥中心页面。-吐司通知可点击的 Windows 通知具有智能分类功能。-频道控制可从菜单中启动/停止 Telegram 和 WhatsApp。-节点可观测性显示节点库存包括在线/离线状态和可复制的摘要。-定时任务快速访问计划任务。-自动启动随 Windows 启动。-设置完整的配置页面。-首次运行引导6 屏设置向导连接、权限、聊天、配置。快速发送范围要求快速发送使用网关的 chat.send 方法要求操作设备具有 operator.write 范围。如果快速发送因缺少 operator.write 范围而失败Molty 会将身份信息和修复指导复制到你的剪贴板包括- 托盘应用使用的操作员角色和 client.id- 网关报告的操作员设备 ID如果提供- 当前授予的范围如果提供对于此特定错误缺少范围operator.write原因是操作员令牌范围问题。更新托盘应用使用的令牌使其包含 operator.write然后重试快速发送。如果快速发送因需要配对NOT_PAIRED而失败则是设备批准问题。在网关配对批准中批准托盘设备重新连接并重试。菜单部分-状态显示网关连接状态点击可查看详细信息。-指挥中心包含诊断信息、频道健康状况、使用情况、会话、节点和可复制的修复命令。-会话显示活动代理会话带有预览和每个会话的控制选项。-使用情况提供提供商/成本摘要可快速跳转到活动详细信息。-频道显示 Telegram/WhatsApp 状态可进行开关控制。-节点显示在线/离线节点库存和可复制的摘要。-最近活动显示会话、使用情况、节点和通知事件的时间戳事件流。-操作包含仪表板、网页聊天、快速发送、活动流、历史记录。-支持与调试包含日志、配置、诊断文件夹、经过编辑的支持上下文、浏览器设置、端口/功能/节点/频道/活动摘要以及托管 SSH 隧道重启。-设置配置和自动启动。Mac 兼容性状态功能MacWindows备注菜单栏/托盘图标✅✅颜色编码状态网关状态显示✅✅已连接/未连接PID 显示✅✅指挥中心显示网关监听器进程/PID频道状态✅✅MacDiscord / WinTelegramWhatsApp会话计数✅✅上次检查时间戳✅✅显示在托盘工具提示中网关启动/停止/重启✅⚠️Windows 可以从托盘支持与调试和指挥中心重启托管 SSH 隧道未实现外部网关进程控制查看日志✅✅打开 Web UI✅✅刷新✅✅菜单打开时自动刷新登录时启动✅✅通知开关✅✅Windows 独有功能这些功能在 Windows 应用中可用但在 Mac 应用中不可用-快速发送热键CtrlAltShiftC 全局热键。-嵌入式网页聊天基于 WebView2 的聊天窗口。-吐司通知可点击的 Windows 通知。-频道控制启动/停止 Telegram 和 WhatsApp。-现代弹出菜单Windows 11 风格支持黑暗/明亮模式。-深度链接openclaw:// URL 方案支持 IPC。-首次运行引导6 屏引导设置向导欢迎 → 连接 → 向导 → 权限 → 聊天 → 就绪。节点模式代理控制当在设置中启用节点模式时你的 Windows PC 就会成为一个节点OpenClaw 代理可以对其进行控制就像 Mac 应用一样代理可以执行以下操作功能命令描述系统system.notify, system.run, system.run.prepare, system.which, system.execApprovals.get, system.execApprovals.set显示 Windows 吐司通知使用策略控制执行命令画布canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset显示和控制 WebView2 窗口屏幕screen.snapshot, screen.record捕获屏幕截图和固定时长的 MP4 屏幕录制相机camera.list, camera.snap, camera.clip枚举相机并捕获静态照片或短视频剪辑语音转文本stt.transcribe从默认麦克风捕获有限时长的音频并返回转录文本。默认关闭可通过设置启用。启用后会向网关调用者受网关允许列表限制和本地 MCP 客户端受承载令牌限制公开。位置location.get当获得权限时返回 Windows 地理位置设备device.info, device.status返回 Windows 主机/应用程序元数据和轻量级状态文本转语音tts.speak通过 Windows 语音合成朗读文本或在配置后使用 ElevenLabs打包安装会声明相机、麦克风和位置功能。当节点功能首次使用这些受保护资源时Windows 可能会要求用户进行授权。节点设置1. 在设置中启用节点模式默认启用。2. 首次连接时会在网关上创建一个配对请求。3. 在网关上批准设备openclaw devices list # 查找你的 Windows 设备 openclaw devices approve device_id # 批准它4. 配置网关 allowCommands在 ~/.openclaw/openclaw.json 的 gateway.nodes 下添加你想要允许的命令{ gateway: { nodes: { allowCommands: [ system.notify, system.run, system.run.prepare, system.which, system.execApprovals.get, system.execApprovals.set, canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset, screen.snapshot, camera.list, camera.snap, camera.clip, location.get, device.info, device.status, tts.speak ] } }}⚠️ 重要提示网关有一个服务器端允许列表命令必须明确列出像 canvas.* 这样的通配符是不起作用的像 screen.record 和通过 tts.speak 进行的代理驱动音频播放等隐私敏感命令只有在你明确允许时才应添加到 allowCommands 中。从 Mac/网关进行测试# 显示通知 openclaw nodes notify --node node_id --title Hello --body From Mac! # 打开画布窗口 openclaw nodes canvas present --node node_id --url https://example.com # 执行 JavaScript注意CLI 发送 javaScript 参数 openclaw nodes canvas eval --node node_id --javaScript document.title # 在画布中渲染 A2UI JSONL将文件内容作为字符串传递 openclaw nodes canvas a2ui push --node node_id --jsonl $(cat ./ui.jsonl) # 截屏 openclaw nodes invoke --node node_id --command screen.snapshot --params {screenIndex:0,format:png} # 录制短屏幕剪辑需要在网关上明确允许 screen.record openclaw nodes screen record --node node_id --duration 3000 --fps 10 --screen 0 --no-audio --out /tmp/openclaw-windows-screen-record-test.mp4 --json # 列出相机 openclaw nodes invoke --node node_id --command camera.list # 拍照NV12/MediaCapture 回退 openclaw nodes invoke --node node_id --command camera.snap --params {deviceId:,format:jpeg,quality:80} # 在 Windows 节点上朗读文本需要在设置中启用 TTS 并在网关上允许 tts.speak openclaw nodes invoke --node node_id --command tts.speak --params {text:Hello from OpenClaw,provider:windows} # 在 Windows 节点上执行命令 openclaw nodes invoke --node node_id --command system.run --params {command:Get-Process | Select -First 5,shell:powershell,timeoutMs:10000} # 查看执行批准策略 openclaw nodes invoke --node node_id --command system.execApprovals.get # 更新执行批准策略添加自定义规则 openclaw nodes invoke --node node_id --command system.execApprovals.set --params {rules:[{pattern:echo *,action:allow},{pattern:*,action:deny}],defaultAction:deny}相机权限桌面版本依赖于 Windows 隐私设置。打包的 MSIX 版本会显示系统授权提示。执行策略system.run 受 Windows 节点上 %LOCALAPPDATA%\OpenClawTray\exec-policy.json 中的批准策略限制架构{ defaultAction: ..., rules: [...] }。这与网关端的 ~/.openclaw/exec-approvals.json 是分开的。规则会与完整的命令行进行匹配。在执行之前还会评估已知的包装负载如 cmd /c ...、powershell -Command ...、pwsh -EncodedCommand ... 和 bash -c ...。像 PATH、PATHEXT、NODE_OPTIONS、GIT_SSH_COMMAND、LD_* 和 DYLD_* 等危险的环境覆盖会被拒绝。指挥中心诊断你可以从托盘菜单或通过 openclaw://commandcenter 打开状态详细信息/指挥中心。它会显示- 来自网关健康事件的频道健康状况包括在没有单独操作员连接的情况下接收到的节点模式健康状况。- 活动会话、使用情况/成本数据、节点库存、声明的命令和 Mac 兼容性说明。- 允许列表诊断将安全的配套命令与像 screen.record、camera.snap 和 camera.clip 等隐私敏感的可选功能区分开来。- 可复制的修复命令用于安全的允许列表修复和待处理的配对批准。- 通过活动流显示的最近活动和节点调用结果仅存储命令名称/状态/持续时间不包括有效负载、屏幕截图、录制或机密信息。openclaw nodes invoke --node node_id --command system.execApprovals.set --params {rules:[{pattern:powershell.exe,action:allow},{pattern:pwsh.exe,action:allow},{pattern:echo *,action:allow},{pattern:*,action:deny}],defaultAction:deny}网页聊天安全上下文远程网页聊天需要使用 https://或 localhost。如果使用自签名证书需要在 Windows 中信任它受信任的根证书颁发机构或者使用 SSH 隧道连接到 localhost。托盘菜单中的节点状态托盘菜单会显示节点连接状态- 启用节点模式时会显示节点模式部分。- ⏳ 等待批准... - 设备需要在网关上获得批准。- ✅ 已配对并连接 - 准备好接收命令。点击设备 ID 可复制它用于批准命令。深度链接OpenClaw 注册了 openclaw:// URL 方案用于自动化和集成链接描述openclaw://settings打开设置页面openclaw://setup打开设置向导openclaw://chat打开聊天页面openclaw://commandcenter打开指挥中心诊断页面openclaw://activity打开活动页面openclaw://history打开过滤到通知历史记录的活动页面openclaw://dashboard在浏览器中打开仪表板openclaw://dashboard/sessions打开特定的仪表板页面openclaw://dashboard/channels打开频道仪表板页面openclaw://dashboard/skills打开技能仪表板页面openclaw://dashboard/cron打开定时任务仪表板页面openclaw://healthcheck手动运行健康检查openclaw://check-updates手动检查更新openclaw://logs打开当前的托盘日志文件openclaw://log-folder打开日志文件夹openclaw://config打开配置文件夹openclaw://diagnostics打开诊断 JSONL 文件夹openclaw://support-context复制经过编辑的支持上下文openclaw://debug-bundle复制用于支持的组合调试包openclaw://browser-setup复制浏览器代理/浏览器控制设置指导openclaw://port-diagnostics复制网关/浏览器/隧道端口诊断信息包括所有者 PID 停止提示openclaw://capability-diagnostics复制权限、允许列表和兼容性诊断信息openclaw://node-inventory复制节点功能、命令和策略状态openclaw://channel-summary复制频道健康状况和启动/停止可用性openclaw://activity-summary复制最近的托盘活动用于故障排除openclaw://extensibility-summary复制频道、技能和定时任务仪表板表面指导openclaw://restart-ssh-tunnel启用时重启托盘管理的 SSH 隧道openclaw://send?messageHello打开预填充文本的快速发送窗口openclaw://agent?messageHello直接向连接的网关发送消息深度链接即使在 Molty 已经运行时也能正常工作它们会通过 IPC 进行转发。OpenClaw.Shared共享库包含- OpenClawGatewayClient用于网关协议的 WebSocket 客户端。- IOpenClawLogger日志记录接口。- 数据模型SessionInfo、ChannelHealth 等。- 频道控制通过网关启动/停止频道。开发项目结构openclaw-windows-node/ ├── src/ │ ├── OpenClaw.Shared/ # 共享网关库 │ └── OpenClaw.Tray.WinUI/ # 系统托盘应用WinUI 3 ├── tests/ │ ├── OpenClaw.Shared.Tests/ # 共享库测试 │ └── OpenClaw.Tray.Tests/ # 托盘应用辅助测试 ├── docs/ │ └── images/ # 截图 ├── openclaw-windows-node.slnx # 解决方案文件 ├── README.md ├── LICENSE └── .gitignore配置设置存储在以下位置-设置%APPDATA%\OpenClawTray\settings.json-日志%LOCALAPPDATA%\OpenClawTray\openclaw-tray.log-一键设置摘要%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt-一键设置 JSONL%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.jsonl-默认网关ws://localhost:18789首次运行首次运行时Molty 会启动一个引导式的入门向导引导你完成设置1.欢迎介绍 OpenClaw 并启动设置流程。2.连接选择本地网关、远程网关或稍后配置。粘贴设置代码或手动输入网关 URL 和令牌。使用 Ed25519 设备认证测试连接。3.向导由网关驱动的配置步骤AI 提供商选择、个性设置、通信频道。步骤由你的网关定义。4.权限审查 Windows 系统权限通知、相机、麦克风、屏幕捕获、位置并链接到系统设置以授予这些权限。5.聊天在由网关的 Web UI 驱动的实时聊天中与你的代理见面。6.就绪总结可用功能提供启动时启动的选项并提供完成按钮。详细的设置说明请查看 docs/SETUP.md。完整的入门架构请查看 docs/ONBOARDING_WIZARD.md。许可证本项目采用 MIT 许可证 - 详情请查看 LICENSE。该项目曾被称为 Moltbot也曾被称为 Clawdbot。这一系列的功能和设置到底能给用户带来怎样的使用体验呢
OpenClaw Windows Hub：AI 驱动个人助手的 Windows 配套套件，功能丰富亮点多！
OpenClaw Windows Hub 介绍OpenClaw 是一款由 AI 驱动的个人助手而 OpenClaw Windows Hub 则是其原生 Windows 配套套件。它由 Scott Hanselman 和 Molty Projects 打造。这个单仓库包含了 Windows 中心、共享客户端库和 CLI 实用工具。项目描述-OpenClaw.Tray.WinUI基于 WinUI 3 的系统托盘应用程序可让你快速访问 OpenClaw。-OpenClaw.Shared共享网关客户端库。-OpenClaw.Cli使用托盘设置进行 WebSocket 连接、发送和探测的 CLI 验证器。快速开始终端用户安装程序你可以从 OpenClaw Windows 文档中下载最新的稳定版 x64 或 ARM64 安装程序也可以查看 docs/SETUP.md 以获取分步安装说明无需构建。托管 WSL 网关本地设置会创建一个受限制的、由应用程序拥有的 OpenClawGateway 发行版。你可以查看 docs/WSL_GATEWAY_ADMIN.md以 openclaw 用户身份编辑 openclaw.json并使用 root 权限进行受保护文件的管理。直接从最新的 OpenClaw 版本下载- OpenClawCompanion-Setup-x64.exe- OpenClawCompanion-Setup-arm64.exe- OpenClawCompanion-SHA256SUMS.txt先决条件- Windows 1020H2或 Windows 11- .NET 10.0 SDK - [下载地址](https://dotnet.microsoft.com/download/dotnet/10.0)- Windows 10 SDK用于 WinUI 构建 - 可通过 Visual Studio 安装或独立安装- WebView2 Runtime - 现代 Windows 系统已预装也可从 [这里](https://developer.microsoft.com/microsoft-edge/webview2) 获取构建你可以使用构建脚本来检查先决条件并进行构建# 检查先决条件 .uild.ps1 -CheckOnly # 构建所有项目 .uild.ps1 # 构建特定项目 .uild.ps1 -Project WinUI或者直接使用 dotnet 进行构建# 构建所有项目使用 build.ps1 可获得最佳效果 dotnet build # 构建 WinUI需要运行时标识符以支持 WebView2 dotnet build src/OpenClaw.Tray.WinUI/OpenClaw.Tray.WinUI.csproj -r win-arm64 # ARM64 dotnet build src/OpenClaw.Tray.WinUI/OpenClaw.Tray.WinUI.csproj -r win-x64 # x64 # 构建 MSIX 包用于相机/麦克风权限提示 dotnet build src/OpenClaw.Tray.WinUI -r win-arm64 -p:PackageMsixtrue # ARM64 MSIX dotnet build src/OpenClaw.Tray.WinUI -r win-x64 -p:PackageMsixtrue # x64 MSIX运行托盘应用# 构建并启动未打包的 WinUI 托盘应用 . un-app-local.ps1 # 如果你已经构建过跳过重建并启动现有的调试输出 . un-app-local.ps1 -NoBuild # 与正常的托盘设置隔离运行以便多个工作树可以同时运行 . un-app-local.ps1 -Isolated # 从发布版本进行 Alpha 更新测试 . un-app-local.ps1 -Configuration Release -Isolated -UpdateChannel alpha # 可选通过 WinAppCLI 并使用 Package.appxmanifest 启动 . un-app-local.ps1 -UseWinApp -NoBuild默认路径会直接启动未打包的可执行文件。使用 -UseWinApp 需要安装 Microsoft WinAppCLIwinget install Microsoft.WinAppCLI仅在你需要进行清单/MSIX 相关的启动验证时才需要。运行 CLI WebSocket 验证器你可以使用 CLI 来验证网关连接并在托盘 UI 之外发送聊天消息。# 显示帮助信息 dotnet run --project src/OpenClaw.Cli -- --help # 使用 %APPDATA%\OpenClawTray\settings.json 中的托盘设置并发送一条消息 dotnet run --project src/OpenClaw.Cli -- --message quick send validation # 循环发送消息并探测会话/使用情况/节点 API dotnet run --project src/OpenClaw.Cli -- --repeat 5 --delay-ms 1000 --probe-read --verbose # 覆盖网关 URL/令牌以进行隔离测试 dotnet run --project src/OpenClaw.Cli -- --url ws://127.0.0.1:18789 --token --message override testOpenClaw.TrayMolty功能-龙虾品牌带有状态颜色的像素艺术龙虾托盘图标。-现代 UI支持黑暗/明亮模式的 Windows 11 弹出菜单。-快速发送通过全局热键CtrlAltShiftC发送消息。-自动更新从 GitHub Releases 自动更新。-网页聊天使用 WebView2 嵌入的聊天窗口。-实时状态实时显示会话、频道和使用情况。-指挥中心在一个窗口中提供密集的网关、频道、使用情况、节点、配对和允许列表诊断信息。-活动流用于实时会话、使用情况、节点和通知事件的指挥中心页面。-吐司通知可点击的 Windows 通知具有智能分类功能。-频道控制可从菜单中启动/停止 Telegram 和 WhatsApp。-节点可观测性显示节点库存包括在线/离线状态和可复制的摘要。-定时任务快速访问计划任务。-自动启动随 Windows 启动。-设置完整的配置页面。-首次运行引导6 屏设置向导连接、权限、聊天、配置。快速发送范围要求快速发送使用网关的 chat.send 方法要求操作设备具有 operator.write 范围。如果快速发送因缺少 operator.write 范围而失败Molty 会将身份信息和修复指导复制到你的剪贴板包括- 托盘应用使用的操作员角色和 client.id- 网关报告的操作员设备 ID如果提供- 当前授予的范围如果提供对于此特定错误缺少范围operator.write原因是操作员令牌范围问题。更新托盘应用使用的令牌使其包含 operator.write然后重试快速发送。如果快速发送因需要配对NOT_PAIRED而失败则是设备批准问题。在网关配对批准中批准托盘设备重新连接并重试。菜单部分-状态显示网关连接状态点击可查看详细信息。-指挥中心包含诊断信息、频道健康状况、使用情况、会话、节点和可复制的修复命令。-会话显示活动代理会话带有预览和每个会话的控制选项。-使用情况提供提供商/成本摘要可快速跳转到活动详细信息。-频道显示 Telegram/WhatsApp 状态可进行开关控制。-节点显示在线/离线节点库存和可复制的摘要。-最近活动显示会话、使用情况、节点和通知事件的时间戳事件流。-操作包含仪表板、网页聊天、快速发送、活动流、历史记录。-支持与调试包含日志、配置、诊断文件夹、经过编辑的支持上下文、浏览器设置、端口/功能/节点/频道/活动摘要以及托管 SSH 隧道重启。-设置配置和自动启动。Mac 兼容性状态功能MacWindows备注菜单栏/托盘图标✅✅颜色编码状态网关状态显示✅✅已连接/未连接PID 显示✅✅指挥中心显示网关监听器进程/PID频道状态✅✅MacDiscord / WinTelegramWhatsApp会话计数✅✅上次检查时间戳✅✅显示在托盘工具提示中网关启动/停止/重启✅⚠️Windows 可以从托盘支持与调试和指挥中心重启托管 SSH 隧道未实现外部网关进程控制查看日志✅✅打开 Web UI✅✅刷新✅✅菜单打开时自动刷新登录时启动✅✅通知开关✅✅Windows 独有功能这些功能在 Windows 应用中可用但在 Mac 应用中不可用-快速发送热键CtrlAltShiftC 全局热键。-嵌入式网页聊天基于 WebView2 的聊天窗口。-吐司通知可点击的 Windows 通知。-频道控制启动/停止 Telegram 和 WhatsApp。-现代弹出菜单Windows 11 风格支持黑暗/明亮模式。-深度链接openclaw:// URL 方案支持 IPC。-首次运行引导6 屏引导设置向导欢迎 → 连接 → 向导 → 权限 → 聊天 → 就绪。节点模式代理控制当在设置中启用节点模式时你的 Windows PC 就会成为一个节点OpenClaw 代理可以对其进行控制就像 Mac 应用一样代理可以执行以下操作功能命令描述系统system.notify, system.run, system.run.prepare, system.which, system.execApprovals.get, system.execApprovals.set显示 Windows 吐司通知使用策略控制执行命令画布canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset显示和控制 WebView2 窗口屏幕screen.snapshot, screen.record捕获屏幕截图和固定时长的 MP4 屏幕录制相机camera.list, camera.snap, camera.clip枚举相机并捕获静态照片或短视频剪辑语音转文本stt.transcribe从默认麦克风捕获有限时长的音频并返回转录文本。默认关闭可通过设置启用。启用后会向网关调用者受网关允许列表限制和本地 MCP 客户端受承载令牌限制公开。位置location.get当获得权限时返回 Windows 地理位置设备device.info, device.status返回 Windows 主机/应用程序元数据和轻量级状态文本转语音tts.speak通过 Windows 语音合成朗读文本或在配置后使用 ElevenLabs打包安装会声明相机、麦克风和位置功能。当节点功能首次使用这些受保护资源时Windows 可能会要求用户进行授权。节点设置1. 在设置中启用节点模式默认启用。2. 首次连接时会在网关上创建一个配对请求。3. 在网关上批准设备openclaw devices list # 查找你的 Windows 设备 openclaw devices approve device_id # 批准它4. 配置网关 allowCommands在 ~/.openclaw/openclaw.json 的 gateway.nodes 下添加你想要允许的命令{ gateway: { nodes: { allowCommands: [ system.notify, system.run, system.run.prepare, system.which, system.execApprovals.get, system.execApprovals.set, canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset, screen.snapshot, camera.list, camera.snap, camera.clip, location.get, device.info, device.status, tts.speak ] } }}⚠️ 重要提示网关有一个服务器端允许列表命令必须明确列出像 canvas.* 这样的通配符是不起作用的像 screen.record 和通过 tts.speak 进行的代理驱动音频播放等隐私敏感命令只有在你明确允许时才应添加到 allowCommands 中。从 Mac/网关进行测试# 显示通知 openclaw nodes notify --node node_id --title Hello --body From Mac! # 打开画布窗口 openclaw nodes canvas present --node node_id --url https://example.com # 执行 JavaScript注意CLI 发送 javaScript 参数 openclaw nodes canvas eval --node node_id --javaScript document.title # 在画布中渲染 A2UI JSONL将文件内容作为字符串传递 openclaw nodes canvas a2ui push --node node_id --jsonl $(cat ./ui.jsonl) # 截屏 openclaw nodes invoke --node node_id --command screen.snapshot --params {screenIndex:0,format:png} # 录制短屏幕剪辑需要在网关上明确允许 screen.record openclaw nodes screen record --node node_id --duration 3000 --fps 10 --screen 0 --no-audio --out /tmp/openclaw-windows-screen-record-test.mp4 --json # 列出相机 openclaw nodes invoke --node node_id --command camera.list # 拍照NV12/MediaCapture 回退 openclaw nodes invoke --node node_id --command camera.snap --params {deviceId:,format:jpeg,quality:80} # 在 Windows 节点上朗读文本需要在设置中启用 TTS 并在网关上允许 tts.speak openclaw nodes invoke --node node_id --command tts.speak --params {text:Hello from OpenClaw,provider:windows} # 在 Windows 节点上执行命令 openclaw nodes invoke --node node_id --command system.run --params {command:Get-Process | Select -First 5,shell:powershell,timeoutMs:10000} # 查看执行批准策略 openclaw nodes invoke --node node_id --command system.execApprovals.get # 更新执行批准策略添加自定义规则 openclaw nodes invoke --node node_id --command system.execApprovals.set --params {rules:[{pattern:echo *,action:allow},{pattern:*,action:deny}],defaultAction:deny}相机权限桌面版本依赖于 Windows 隐私设置。打包的 MSIX 版本会显示系统授权提示。执行策略system.run 受 Windows 节点上 %LOCALAPPDATA%\OpenClawTray\exec-policy.json 中的批准策略限制架构{ defaultAction: ..., rules: [...] }。这与网关端的 ~/.openclaw/exec-approvals.json 是分开的。规则会与完整的命令行进行匹配。在执行之前还会评估已知的包装负载如 cmd /c ...、powershell -Command ...、pwsh -EncodedCommand ... 和 bash -c ...。像 PATH、PATHEXT、NODE_OPTIONS、GIT_SSH_COMMAND、LD_* 和 DYLD_* 等危险的环境覆盖会被拒绝。指挥中心诊断你可以从托盘菜单或通过 openclaw://commandcenter 打开状态详细信息/指挥中心。它会显示- 来自网关健康事件的频道健康状况包括在没有单独操作员连接的情况下接收到的节点模式健康状况。- 活动会话、使用情况/成本数据、节点库存、声明的命令和 Mac 兼容性说明。- 允许列表诊断将安全的配套命令与像 screen.record、camera.snap 和 camera.clip 等隐私敏感的可选功能区分开来。- 可复制的修复命令用于安全的允许列表修复和待处理的配对批准。- 通过活动流显示的最近活动和节点调用结果仅存储命令名称/状态/持续时间不包括有效负载、屏幕截图、录制或机密信息。openclaw nodes invoke --node node_id --command system.execApprovals.set --params {rules:[{pattern:powershell.exe,action:allow},{pattern:pwsh.exe,action:allow},{pattern:echo *,action:allow},{pattern:*,action:deny}],defaultAction:deny}网页聊天安全上下文远程网页聊天需要使用 https://或 localhost。如果使用自签名证书需要在 Windows 中信任它受信任的根证书颁发机构或者使用 SSH 隧道连接到 localhost。托盘菜单中的节点状态托盘菜单会显示节点连接状态- 启用节点模式时会显示节点模式部分。- ⏳ 等待批准... - 设备需要在网关上获得批准。- ✅ 已配对并连接 - 准备好接收命令。点击设备 ID 可复制它用于批准命令。深度链接OpenClaw 注册了 openclaw:// URL 方案用于自动化和集成链接描述openclaw://settings打开设置页面openclaw://setup打开设置向导openclaw://chat打开聊天页面openclaw://commandcenter打开指挥中心诊断页面openclaw://activity打开活动页面openclaw://history打开过滤到通知历史记录的活动页面openclaw://dashboard在浏览器中打开仪表板openclaw://dashboard/sessions打开特定的仪表板页面openclaw://dashboard/channels打开频道仪表板页面openclaw://dashboard/skills打开技能仪表板页面openclaw://dashboard/cron打开定时任务仪表板页面openclaw://healthcheck手动运行健康检查openclaw://check-updates手动检查更新openclaw://logs打开当前的托盘日志文件openclaw://log-folder打开日志文件夹openclaw://config打开配置文件夹openclaw://diagnostics打开诊断 JSONL 文件夹openclaw://support-context复制经过编辑的支持上下文openclaw://debug-bundle复制用于支持的组合调试包openclaw://browser-setup复制浏览器代理/浏览器控制设置指导openclaw://port-diagnostics复制网关/浏览器/隧道端口诊断信息包括所有者 PID 停止提示openclaw://capability-diagnostics复制权限、允许列表和兼容性诊断信息openclaw://node-inventory复制节点功能、命令和策略状态openclaw://channel-summary复制频道健康状况和启动/停止可用性openclaw://activity-summary复制最近的托盘活动用于故障排除openclaw://extensibility-summary复制频道、技能和定时任务仪表板表面指导openclaw://restart-ssh-tunnel启用时重启托盘管理的 SSH 隧道openclaw://send?messageHello打开预填充文本的快速发送窗口openclaw://agent?messageHello直接向连接的网关发送消息深度链接即使在 Molty 已经运行时也能正常工作它们会通过 IPC 进行转发。OpenClaw.Shared共享库包含- OpenClawGatewayClient用于网关协议的 WebSocket 客户端。- IOpenClawLogger日志记录接口。- 数据模型SessionInfo、ChannelHealth 等。- 频道控制通过网关启动/停止频道。开发项目结构openclaw-windows-node/ ├── src/ │ ├── OpenClaw.Shared/ # 共享网关库 │ └── OpenClaw.Tray.WinUI/ # 系统托盘应用WinUI 3 ├── tests/ │ ├── OpenClaw.Shared.Tests/ # 共享库测试 │ └── OpenClaw.Tray.Tests/ # 托盘应用辅助测试 ├── docs/ │ └── images/ # 截图 ├── openclaw-windows-node.slnx # 解决方案文件 ├── README.md ├── LICENSE └── .gitignore配置设置存储在以下位置-设置%APPDATA%\OpenClawTray\settings.json-日志%LOCALAPPDATA%\OpenClawTray\openclaw-tray.log-一键设置摘要%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt-一键设置 JSONL%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.jsonl-默认网关ws://localhost:18789首次运行首次运行时Molty 会启动一个引导式的入门向导引导你完成设置1.欢迎介绍 OpenClaw 并启动设置流程。2.连接选择本地网关、远程网关或稍后配置。粘贴设置代码或手动输入网关 URL 和令牌。使用 Ed25519 设备认证测试连接。3.向导由网关驱动的配置步骤AI 提供商选择、个性设置、通信频道。步骤由你的网关定义。4.权限审查 Windows 系统权限通知、相机、麦克风、屏幕捕获、位置并链接到系统设置以授予这些权限。5.聊天在由网关的 Web UI 驱动的实时聊天中与你的代理见面。6.就绪总结可用功能提供启动时启动的选项并提供完成按钮。详细的设置说明请查看 docs/SETUP.md。完整的入门架构请查看 docs/ONBOARDING_WIZARD.md。许可证本项目采用 MIT 许可证 - 详情请查看 LICENSE。该项目曾被称为 Moltbot也曾被称为 Clawdbot。这一系列的功能和设置到底能给用户带来怎样的使用体验呢
