openclaw/openclaw-windows-node
Windows companion suite for OpenClaw - System Tray app, Shared library, Node, and PowerToys Command Palette extension
snapshot: 2026-06-05
scraped_at: 2026/06/05 1:52
period stars: +411
stars: 1,342
forks: 169
Language: C#
Summary
一覧カードと同じ provider の要約本文です。
Highlights
OpenClaw Windows HubはOpenClawのネイティブWindowsコンパニオンスイートで、WinUI3のシステムトレイアプリ、共有クライアントライブラリ、CLIバリデータを単一のモノレポで提供します。リポジトリには主に以下が含まれます：OpenClaw.Tray.WinUI（WinUI3トレイアプリ）、（ゲートウェイクライアントライブラリ）、（WebSocket接続／送信／プローブ用のCLI）。
Translation
要約とは別に生成された翻訳本文です。
翻訳はまだありません。
README
取得した README 原文です。
A native Windows companion suite for OpenClaw - the AI-powered personal assistant.
Made with 🦞 love by Scott Hanselman and Molty
This monorepo contains the Windows hub, shared client libraries, and CLI utilities:
| Project | Description |
|---|---|
| OpenClaw.Tray.WinUI | System tray application (WinUI 3) for quick access to OpenClaw |
| OpenClaw.Shared | Shared gateway client library |
| OpenClaw.Cli | CLI validator for WebSocket connect/send/probe using tray settings |
End-user installer? Download the latest stable x64 or ARM64 installer from the OpenClaw Windows docs, or see docs/SETUP.md for step-by-step installation (no build required).
Managed WSL gateway? Local setup creates a locked-down app-owned
OpenClawGatewaydistro. See docs/WSL_GATEWAY_ADMIN.md for editing as the user and using root for protected-file administration.
OpenClaw.SharedOpenClaw.CliREADMEにある直接ダウンロードは OpenClawCompanion-Setup-x64.exe と OpenClawCompanion-Setup-arm64.exe（SHA256SUMSあり）で、インストーラから簡単に導入できます。ビルドはリポジトリ付属の build.ps1 を推奨し、例として .uild.ps1 -CheckOnly や .uild.ps1 -Project WinUI といったコマンドが示されています。実行用のローカル起動スクリプトは .un-app-local.ps1（-NoBuild / -Isolated / -UseWinApp 等のオプションあり）で動作検証が可能です。
Ctrl+Alt+Shift+C）と、失敗時のスコープ/ペアリング復旧ガイダンスsystem.*、canvas.*、screen.snapshot、camera.snap、stt.transcribe、tts.speakなど多数のエージェントコマンドをサポートallowCommands 明示必須（ワイルドカード不可）や、ペアリング承認手順の具体例がREADMEに記載.uild.ps1 / dotnet build src/OpenClaw.Tray.WinUI/... -r win-x64 / .un-app-local.ps1dotnet run --project src/OpenClaw.Cli -- --message "quick send validation" や --repeat/--probe-read フラグで接続検証このリポジトリは単なるGUIではなく、ローカルゲートウェイとの深い統合とWindows特有の機能（グローバルホットキー、WebView2チャット、トースト、チャネル起動/停止、Node Modeによるリモート操作）を組み合わせている点が重要です。インストーラ（x64/ARM64）と自動更新対応によりエンドユーザー導入が容易で、デバッグ／運用向けにCLIバリデータや詳細なコマンドセンター（セッション・ノード・使用量表示）をREADMEが具体的に案内している点も差別化ポイントです。
本日大きく注目されている理由として、READMEで明示された公式インストーラやAuto-update対応、Windows専用のNode Mode機能、そしてScott HanselmanやMoltyによるメンテナンスで目立つ点があり、Starsの急増（+411）によってランキング上昇しています。PowerToys Command Palette拡張を含む“Windows向け補助”という説明もあり、Windowsユーザーへの利便性強化が注目を集めています。
openclaw.jsonopenclawDirect downloads from the latest OpenClaw release:
Use the build script to check prerequisites and build:
# Check prerequisites
.\build.ps1 -CheckOnly
# Build all projects
.\build.ps1
# Build specific project
.\build.ps1 -Project WinUI
Or build directly with dotnet:
# Build all (use build.ps1 for best results)
dotnet build
# Build WinUI (requires runtime identifier for WebView2 support)
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
# Build MSIX package (for camera/mic consent prompts)
dotnet build src/OpenClaw.Tray.WinUI -r win-arm64 -p:PackageMsix=true # ARM64 MSIX
dotnet build src/OpenClaw.Tray.WinUI -r win-x64 -p:PackageMsix=true # x64 MSIX
# Build and launch the unpackaged WinUI tray app
.\run-app-local.ps1
# If you already built, skip rebuild and launch the existing Debug output
.\run-app-local.ps1 -NoBuild
# Run isolated from your normal tray settings so multiple worktrees can run together
.\run-app-local.ps1 -Isolated
# Alpha update testing from a Release build
.\run-app-local.ps1 -Configuration Release -Isolated -UpdateChannel alpha
# Optional: launch through WinAppCLI with Package.appxmanifest
.\run-app-local.ps1 -UseWinApp -NoBuild
The default path starts the unpackaged executable directly. -UseWinApp requires
Microsoft WinAppCLI (winget install Microsoft.WinAppCLI) and is only needed when
you want manifest/MSIX-adjacent launch validation.
Use the CLI to validate gateway connectivity and chat.send outside the tray UI.
# Show help
dotnet run --project src/OpenClaw.Cli -- --help
# Use tray settings from %APPDATA%\OpenClawTray\settings.json and send one message
dotnet run --project src/OpenClaw.Cli -- --message "quick send validation"
# Loop sends and also probe sessions/usage/nodes APIs
dotnet run --project src/OpenClaw.Cli -- --repeat 5 --delay-ms 1000 --probe-read --verbose
# Override gateway URL/token for isolated testing
dotnet run --project src/OpenClaw.Cli -- --url ws://127.0.0.1:18789 --token "<token>" --message "override test"
Modern Windows 11-style system tray companion that connects to your local OpenClaw gateway.
Quick Send uses the gateway chat.send method and requires the operator device to have operator.write scope.
If Quick Send fails with missing scope: operator.write, Molty now copies identity + remediation guidance to your clipboard, including:
client.id used by the tray appFor this specific error (missing scope: operator.write), the cause is an operator token scope issue. Update the token used by the tray app so it includes operator.write, then retry Quick Send.
If Quick Send fails with pairing required / NOT_PAIRED, that is a device approval issue. Approve the tray device in gateway pairing approvals, reconnect, and retry.
Comparing against openclaw-menubar (macOS Swift menu bar app):
| Feature | Mac | Windows | Notes |
|---|---|---|---|
| Menu bar/tray icon | ✅ | ✅ | Color-coded status |
| Gateway status display | ✅ | ✅ | Connected/Disconnected |
| PID display | ✅ | ✅ | Command Center shows gateway listener process/PID |
| Channel status | ✅ | ✅ | Mac: Discord / Win: Telegram+WhatsApp |
| Sessions count | ✅ | ✅ | |
| Last check timestamp | ✅ | ✅ | Shown in tray tooltip |
| Gateway start/stop/restart | ✅ | ⚠️ | Windows can restart the managed SSH tunnel from tray Support & Debug and Command Center; external gateway process control is not implemented |
| View Logs | ✅ | ✅ | |
| Open Web UI | ✅ | ✅ | |
| Refresh | ✅ | ✅ | Auto-refresh on menu open |
| Launch at Login | ✅ | ✅ | |
| Notifications toggle | ✅ | ✅ |
These features are available in Windows but not in the Mac app:
| Feature | Description |
|---|---|
| Quick Send hotkey | Ctrl+Alt+Shift+C global hotkey |
| Embedded Web Chat | WebView2-based chat window |
| Toast notifications | Clickable Windows notifications |
| Channel control | Start/stop Telegram & WhatsApp |
| Modern flyout menu | Windows 11-style with dark/light mode |
| Deep links | openclaw:// URL scheme with IPC |
| First-run onboarding | 6-screen guided setup wizard (Welcome → Connection → Wizard → Permissions → Chat → Ready) |
When Node Mode is enabled in Settings, your Windows PC becomes a node that the OpenClaw agent can control - just like the Mac app! The agent can:
| Capability | Commands | Description |
|---|---|---|
| System | system.notify, system.run, system.run.prepare, system.which, system.execApprovals.get, system.execApprovals.set | Show Windows toast notifications, execute commands with policy controls |
| Canvas | canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset | Display and control a WebView2 window |
| Screen | screen.snapshot, screen.record | Capture screenshots and fixed-duration MP4 screen recordings |
| Camera | camera.list, camera.snap, camera.clip | Enumerate cameras and capture still photos or short video clips |
| Speech-to-text | stt.transcribe | Capture audio from the default microphone for a bounded duration and return transcribed text. Default-off; opt-in via Settings. When enabled, advertised to both gateway callers (subject to gateway allowlist) and local MCP clients (subject to bearer token). |
| Location | location.get | Return Windows geolocation when permission is available |
| Device | device.info, device.status | Return Windows host/app metadata and lightweight status |
| Text-to-speech | tts.speak | Speak text aloud through Windows speech synthesis, or ElevenLabs when configured |
Packaged installs declare camera, microphone, and location capabilities. Windows may ask for consent the first time a node capability uses one of those protected resources.
Enable Node Mode in Settings (enabled by default)
First connection creates a pairing request on the gateway
Approve the device on your gateway:
openclaw devices list # Find your Windows device
openclaw devices approve <id> # Approve it
Configure gateway allowCommands - Add the commands you want to allow under gateway.nodes in ~/.openclaw/openclaw.json:
{
"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"
]
}
}
}
⚠️ Important: The gateway has a server-side allowlist. Commands must be listed explicitly - wildcards like
canvas.*don't work! Privacy-sensitive commands such asscreen.recordand agent-driven audio playback viatts.speakshould only be added toallowCommandswhen you explicitly want to allow them.
Test it from your Mac/gateway:
# Show a notification
openclaw nodes notify --node <id> --title "Hello" --body "From Mac!"
# Open a canvas window
openclaw nodes canvas present --node <id> --url "https://example.com"
# Execute JavaScript (note: CLI sends "javaScript" param)
openclaw nodes canvas eval --node <id> --javaScript "document.title"
# Render A2UI JSONL in the canvas (pass the file contents as a string)
openclaw nodes canvas a2ui push --node <id> --jsonl "$(cat ./ui.jsonl)"
# Take a screenshot
openclaw nodes invoke --node <id> --command screen.snapshot --params '{"screenIndex":0,"format":"png"}'
# Record a short screen clip (requires explicitly allowing screen.record on the gateway)
openclaw nodes screen record --node <id> --duration 3000 --fps 10 --screen 0 --no-audio --out /tmp/openclaw-windows-screen-record-test.mp4 --json
# List cameras
openclaw nodes invoke --node <id> --command camera.list
# Take a photo (NV12/MediaCapture fallback)
openclaw nodes invoke --node <id> --command camera.snap --params '{"deviceId":"<device-id>","format":"jpeg","quality":80}'
# Speak text aloud on the Windows node (requires TTS enabled in Settings and tts.speak allowed on the gateway)
openclaw nodes invoke --node <id> --command tts.speak --params '{"text":"Hello from OpenClaw","provider":"windows"}'
# Execute a command on the Windows node
openclaw nodes invoke --node <id> --command system.run --params
openclaw nodes invoke --node <> -- system.execApprovals.get
openclaw nodes invoke --node <> -- system.execApprovals. --params
Open the status detail/Command Center from the tray menu or with openclaw://commandcenter. It shows:
channel health from gateway health events, including node-mode health received without a separate operator connection
active sessions, usage/cost data, node inventory, declared commands, and Mac parity notes
allowlist diagnostics that separate safe companion commands from privacy-sensitive opt-ins like screen.record, camera.snap, and camera.clip
copyable repair commands for safe allowlist fixes and pending pairing approval
recent activity and node invoke results through the Activity Stream, storing command names/status/duration only (not payloads, screenshots, recordings, or secrets)
openclaw nodes invoke --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"}'
🔐 Web Chat secure context: Remote web chat requires
https://(or localhost). If using a self-signed cert, trust it in Windows (Trusted Root Certification Authorities) or use an SSH tunnel to localhost.
The tray menu shows node connection status:
OpenClaw registers the openclaw:// URL scheme for automation and integration:
| Link | Description |
|---|---|
openclaw://settings | Open the Settings page |
openclaw://setup | Open Setup Wizard |
openclaw://chat | Open the Chat page |
openclaw://commandcenter | Open Command Center diagnostics |
openclaw://activity | Open the Activity page |
openclaw://history | Open the Activity page filtered to notification history |
openclaw://dashboard | Open Dashboard in browser |
openclaw://dashboard/sessions | Open specific dashboard page |
openclaw://dashboard/channels | Open Channels dashboard page |
openclaw://dashboard/skills | Open Skills dashboard page |
openclaw://dashboard/cron | Open Cron dashboard page |
openclaw://healthcheck | Run a manual health check |
openclaw://check-updates | Run a manual update check |
openclaw://logs | Open the current tray log file |
openclaw://log-folder | Open the logs folder |
openclaw://config | Open the config folder |
openclaw://diagnostics | Open the diagnostics JSONL folder |
openclaw://support-context | Copy redacted support context |
openclaw://debug-bundle | Copy a combined debug bundle for support |
openclaw://browser-setup | Copy browser.proxy/browser-control setup guidance |
openclaw://port-diagnostics | Copy gateway/browser/tunnel port diagnostics with owner PID stop hints |
openclaw://capability-diagnostics | Copy permissions, allowlist, and parity diagnostics |
openclaw://node-inventory | Copy node capabilities, commands, and policy status |
openclaw://channel-summary | Copy channel health and start/stop availability |
openclaw://activity-summary | Copy recent tray activity for troubleshooting |
openclaw://extensibility-summary | Copy channel, skills, and cron dashboard surface guidance |
openclaw://restart-ssh-tunnel | Restart the tray-managed SSH tunnel when enabled |
openclaw://send?message=Hello | Open Quick Send with pre-filled text |
openclaw://agent?message=Hello | Send message directly to the connected gateway |
Deep links work even when Molty is already running - they're forwarded via IPC.
Shared library containing:
OpenClawGatewayClient - WebSocket client for gateway protocolIOpenClawLogger - Logging interfaceopenclaw-windows-node/
├── src/
│ ├── OpenClaw.Shared/ # Shared gateway library
│ └── OpenClaw.Tray.WinUI/ # System tray app (WinUI 3)
├── tests/
│ ├── OpenClaw.Shared.Tests/ # Shared library tests
│ └── OpenClaw.Tray.Tests/ # Tray app helper tests
├── docs/
│ └── images/ # Screenshots
├── openclaw-windows-node.slnx # Solution file
├── README.md
├── LICENSE
└── .gitignore
Settings are stored in:
%APPDATA%\OpenClawTray\settings.json%LOCALAPPDATA%\OpenClawTray\openclaw-tray.log%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.jsonlDefault gateway: ws://localhost:18789
On first run, Molty launches a guided onboarding wizard that walks you through setup:
For detailed setup instructions, see docs/SETUP.md. For the full onboarding architecture, see docs/ONBOARDING_WIZARD.md.
MIT License - see LICENSE
Formerly known as Moltbot, formerly known as Clawdbot
📷 Camera permission: Desktop builds rely on Windows Privacy settings. Packaged MSIX builds will show the system consent prompt.
🔒 Exec Policy:
system.runis gated by an approval policy on the Windows node at%LOCALAPPDATA%\OpenClawTray\exec-policy.json(schema:{ "defaultAction": "...", "rules": [...] }). This is separate from gateway-side~/.openclaw/exec-approvals.json.Rules are matched against the full command line. Known wrapper payloads such as
cmd /c ...,powershell -Command ...,pwsh -EncodedCommand ..., andbash -c ...are also evaluated before execution. Dangerous environment overrides likePATH,PATHEXT,NODE_OPTIONS,GIT_SSH_COMMAND,LD_*, andDYLD_*are rejected.