A unified system notification utility that enables AI agents to send native desktop alerts across Windows, macOS, Linux, and WSL.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cross-platform-notifier
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 cross-platform-notifier 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 Cross-Platform Notifier?
The Cross-Platform Notifier is a highly reliable script designed to bridge the gap between different operating systems and local desktop notification mechanisms. Built for developers using Openclaw Skills, this notification module makes it incredibly simple for automated AI workflows to ping the system operator when attention is required. Whether you are running complex tasks inside Windows Subsystem for Linux (WSL), working natively on macOS, or managing jobs on a Linux server, this utility dynamically adapts to prompt the user locally.
By incorporating this alert capability, you ensure your AI agents never leave you waiting. It resolves the classic developer issue of starting a long-running compile, data analysis, or testing loop in the background, only to forget about it. Adding this helper to your suite of Openclaw Skills bridges the gap between background automated tasks and human-in-the-loop validation.
Cross-Platform Notifier Use Cases
- Long-running Task Completion: Alerting developers immediately after heavy background processes, like docker builds or dataset parsing, are completed.
- Urgent Code Blockers: Notifying developers when automated testing or security scanning scripts encounter failures that require immediate manual attention.
- Action Confirmation: Providing clear visual confirmation after a high-impact CLI task, such as database seeding or infrastructure deployment, has finished successfully.
How Cross-Platform Notifier Works
- Execution Request: The AI agent triggers the notifier via the unified shell command containing the desired message and title.
- Environment & Kernel Detection: The underlying script
notify.shanalyzes the host operating system's environment, checking specifically for native Linux, macOS, Windows, or a Microsoft WSL kernel. - OS-Specific Notification Dispatch:
- Windows: Calls PowerShell and invokes the
System.Windows.Forms.MessageBoxAPI. - macOS: Runs
osascriptto trigger a native AppleScript alert box. - Linux: Dispatches a system notification using
notify-send. - WSL: Passes the execution context cleanly back to the Windows host through
powershell.exeto render a native Windows alert dialog.
- Windows: Calls PowerShell and invokes the
- Completion State: Returns a success exit code, confirming the visual alert has been rendered on the host screen.
Cross-Platform Notifier Setup
To integrate this notification capability with your automated agents, follow these configuration steps:
- Ensure the script has appropriate execute permissions in your terminal:
chmod +x ./skills/cross-platform-notifier/scripts/notify.sh
- Test the alert function directly from your terminal using the following format:
./skills/cross-platform-notifier/scripts/notify.sh "This is a test notification" "Hello World"
Cross-Platform Notifier Data Schema & Taxonomy
This utility is self-contained and operates purely as an execution block without maintaining a stateful database. It accepts positional arguments for standard alert generation as described below:
| Argument Index | Parameter Type | Description | Required |
|---|---|---|---|
$1 |
String | Notification Message: The main text content to display inside the system notification dialog. | Yes |
$2 |
String | Notification Title: The header text displayed on top of the alert box. | No (Optional) |
No dynamic log files or tracking databases are generated by this module.
Cross-Platform Notifier Advanced Features
- WSL Translation Loop: Automatically detects WSL virtualized kernels to correctly route alerts to the host Windows desktop environment seamlessly.
- Zero-Dependency Core: Utilizes native operating system binaries (
osascript,powershell.exe,notify-send) avoiding complex third-party system dependencies. - Agentic Hooking: Easily integrates into automated pipelines and other Openclaw Skills as a post-hook action following task completion.
SKILL.md
Loading
Related Openclaw Skills
Firecrawl Web Scraping Skill
An instruction-based skill that teaches AI agents how to efficiently drive the Firecrawl API to scrape, crawl, search, and extract clean, cited Markdown content from the web.
Tavily Web Search Skill
The Tavily Web Search Skill provides comprehensive instructional knowledge that teaches AI coding agents exactly when and how to leverage Tavily for live web searches, deep site crawls, content extraction, and mapping.
Yilian Android Hospital Booking Automation
A lightweight, high-performance uiautomator2 automation script to book appointments on the Yilian Android app without requiring Appium.
OpenAI Agent Skill
An operations guide and toolset for AI agents integrating OpenAI MCP services to generate text, compute embeddings, run reasoning tasks, produce images, and transcribe audio.
Exa Web Search Skill
A powerful neural and keyword web search skill that equips AI agents with real-time web access, clean content extraction, similarity mapping, and citation-grounded answering via Exa.
FRED Economic Data Skill
An AI agent skill to retrieve, transform, and analyze over 800,000 U.S. and international macroeconomic time-series directly from the Federal Reserve Bank of St. Louis.
Featured*
