Openclaw Skills turns long-running agent work into a native desktop notification with sound, with cross-platform fallback handling built in.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install desktop-notify
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install desktop-notify using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Desktop Notify?
Desktop Notify is an Openclaw Skills utility for signaling task completion with a native system toast plus an audible cue. It detects Windows, macOS, and Linux at runtime and uses the most appropriate system API, so your agent can signal completion without any third-party notification dependency.
It is especially valuable for long-running builds, background scripts, and assistant workflows where visual feedback matters. The skill also supports a one-time setup that writes a persistent auto-notify rule into the user's own ~/.workbuddy/MEMORY.md, making future conversations and projects automatically emit completion alerts.
Desktop Notify Use Cases
- A long-running coding task, report, or batch job finishes and you want a visible + audible completion cue.
- You need a simple "call me when it's done" workflow for background agent work.
- A script or tool completes outside the foreground and should alert the user immediately.
- You want a cross-platform notification path that works on Windows, macOS, and Linux without third-party apps.
- You want to enable a persistent, user-level auto-notify rule once and reuse it across future conversations.
How Desktop Notify Works
- The task or agent finishes and invokes the notifier with a message and optional title.
- The script detects the operating system and routes to the native path: WinRT Toast on Windows,
osascripton macOS, ornotify-sendon Linux. - Windows also plays a completion sound; Linux falls back to a terminal bell and console output if
notify-sendis unavailable. - Optional setup writes a durable auto-notify instruction into
~/.workbuddy/MEMORY.mdunder the<!-- desktop-notify-auto -->marker. - Because the rule lives in user memory, future projects and chats inherit the behavior automatically without repeat manual steps.
Desktop Notify Setup
- Place the skill directory in your skills repository or agent skill path so
SKILL.mdandscripts/are discoverable. - Run the one-time setup script for your OS; it writes the auto-notify rule into your user memory file and is safe to run repeatedly.
- Trigger notifications manually with the notifier script whenever you want an explicit desktop alert.
- To disable global auto-notify, remove the
<!-- desktop-notify-auto -->block from~/.workbuddy/MEMORY.md.
Windows
PowerShell -File "<skill_dir>/scripts/setup.ps1"
macOS / Linux
bash "<skill_dir>/scripts/setup.sh"
Manual notification examples
PowerShell -File "<skill_dir>/scripts/notify.ps1" -Message "Report generated" -Title "WorkBuddy"
bash "<skill_dir>/scripts/notify.sh" "Report generated" "WorkBuddy"
Note: the PowerShell scripts are saved as UTF-8 with BOM to avoid Windows PowerShell 5.1 encoding issues.
Desktop Notify Data Schema & Taxonomy
| Artifact | Role | Data / metadata |
|---|---|---|
SKILL.md |
Skill manifest | Declares the skill name (desktop-notify), description, operational guidance, and platform notes. |
scripts/notify.ps1 |
Windows notifier | Accepts -Message and -Title; defaults to title WorkBuddy and a task-complete body when omitted. |
scripts/notify.sh |
macOS/Linux notifier | Accepts $1 as message/body and $2 as title; uses osascript on macOS and notify-send on Linux. |
scripts/setup.ps1 |
Windows bootstrap | Writes the auto-notify rule into the user's memory file; idempotent. |
scripts/setup.sh |
macOS/Linux bootstrap | Writes the auto-notify rule into the user's memory file; idempotent. |
~/.workbuddy/MEMORY.md |
Persistence layer | Stores the global rule block flagged by <!-- desktop-notify-auto -->. |
- Notification payload taxonomy:
title,message/body, delivery backend, and fallback mode. - Persistence taxonomy: user-level memory block plus the
<!-- desktop-notify-auto -->marker. - Runtime taxonomy:
WinRT Toast,AppleScript/osascript,notify-send, or terminal bell fallback. - Deployment model: local-only, offline, and no third-party package dependencies.
Desktop Notify Advanced Features
- Cross-platform OS detection with native APIs and graceful fallback.
- One-time global automation that persists through the user's own memory file.
- Idempotent setup scripts; repeated runs do not duplicate the rule block.
- Manual and automated notification entrypoints for both PowerShell and Bash.
- Offline, dependency-free operation suitable for secure agent environments.
- UTF-8 BOM-safe PowerShell scripts for Windows PowerShell 5.1 compatibility.
- Built as an Openclaw Skills-ready notification primitive for reusable agent workflows.
SKILL.md
Loading
Related Openclaw Skills
AgentHost Publishing
Openclaw Skills for AgentHost publishes static sites, HTML, or Markdown docs to a private, pre-authenticated share URL in one command.
HTTP API Tester
Openclaw Skills turns endpoint descriptions into reusable curl smoke tests with timing, status assertions, and CI-ready shell output.
Animated Sticker Maker
Openclaw Skills turns one reference image and one motion prompt into a validated, transparent, loop-ready animated sticker package.
Obsidian Vault Cleaner
An Openclaw Skills utility that audits Obsidian and Markdown vaults for duplicates, orphan notes, broken links, and unused attachments, then recommends safe fixes.
Open Computer Use MCP
A policy-gated macOS computer-use skill that drives approved desktop apps through Openclaw Skills with explicit UI state tracking.
YAML Config Validator
Openclaw Skills for YAML validation that catches Kubernetes, Docker Compose, and GitHub Actions errors before they break deployment.
Featured*
