| name | windows-notifier |
| description | Send native Windows desktop notifications for local reminders, alerts, and background-attention events. Use when the user wants a Windows popup, a local toast notification, or when reminder/alert messages should prefer local desktop notification instead of only chat delivery. |
Windows Notifier
Send a local Windows desktop notification on this machine.
This skill is a Windows-focused alias/wrapper around the shared desktop notification flow so agents can trigger a popup consistently when the user asks for a Windows reminder or when a reminder/alert should not rely only on chat visibility.
Use this skill for
- Local reminder popups
- Timer / study / schedule alerts
- Attention-needed notifications when chat may be in the background
- Windows-specific notification tests
Command
Run this from PowerShell with exec:
node "$env:USERPROFILE\.openclaw\workspace\skills\windows-notifier\scripts\send-notification.js" --title "<TITLE>" --message "<MESSAGE>" --timeout 10
Modern card / persistent dialog mode also goes through the same JS entry:
node "$env:USERPROFILE\.openclaw\workspace\skills\windows-notifier\scripts\send-notification.js" --title "<TITLE>" --message "<MESSAGE>" --mode modern --appName "OpenClaw"
Behavior summary:
- Windows + WPF available → prefer the built-in WPF modern card path in
send-notification.js
- Windows fallback → if WPF is unavailable or launch fails, automatically fall back to
node-notifier
- Linux / macOS → use the existing
node-notifier path
- Current modern card behavior: auto-close after about 60 seconds; click the card itself to dismiss
Optional flags:
--wait true|false--timeout <seconds|false|permanent>--sound true|false (default: true)--mode modern|card|dialog--appName <name>
Notes
- Keep the title short and the message concise.
- On Windows,
--mode modern|card|dialog prefers the built-in WPF modern card path when available, and otherwise falls back to node-notifier automatically.
--timeout false|permanent|sticky|0 is treated as a persistent request intent, but final behavior depends on the active backend (built-in WPF on capable Windows, otherwise node-notifier).- Prefer this over chat-only reminders when the request is for a local popup.
- If a reminder or alert may be missed because OpenClaw is running in the background, prefer triggering this notifier in addition to or instead of chat delivery, depending on user intent.
node-notifier remains the default non-Windows path and the cross-platform fallback mechanism.- On first run after install, the script auto-installs dependencies in this skill directory if needed, so users do not need to run npm manually.
