A versatile CLI skill for sending rich, interactive notifications to ntfy.sh topics with full support for attachments and actions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ntfy-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 ntfy-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 ntfy-notify?
ntfy-notify is a specialized tool within the Openclaw Skills collection designed to bridge the gap between AI workflows and real-time mobile or desktop alerts. By leveraging the ntfy.sh protocol, it allows developers and automated agents to push structured notifications directly to a topic, ensuring critical updates are never missed.
Whether you need a simple status ping or a complex interactive alert with action buttons and image previews, this skill provides a robust shell script interface to handle it all. It simplifies the process of integrating external notification services into your AI-driven environment without requiring complex SDKs.
ntfy-notify Use Cases
- Alerting users when a long-running AI task or code deployment has finished.
- Sending interactive notifications with action buttons to trigger downstream workflows.
- Monitoring system health and pushing high-priority warnings with specific tags.
- Attaching generated images or logs from AI agents directly to mobile notifications.
How ntfy-notify Works
- The AI agent or user invokes the send_ntfy.sh script located within the Openclaw Skills directory.
- Parameters such as topic, title, message, and priority are passed as command-line arguments.
- The script processes these arguments and formats them into appropriate HTTP headers for the ntfy.sh API.
- A curl request is executed to POST the data to the specified ntfy topic.
- The notification is instantly delivered to all devices subscribed to that topic.
ntfy-notify Setup
To use this skill within your Openclaw Skills setup, ensure you have curl installed on your environment. You may need to grant execution permissions to the script:
chmod +x skills/ntfy-notify/scripts/send_ntfy.sh
Basic usage command:
skills/ntfy-notify/scripts/send_ntfy.sh --topic MyTopic --message "Hello from Openclaw Skills"
ntfy-notify Data Schema & Taxonomy
The skill utilizes standard CLI parameters to structure the notification payload sent to the ntfy server. Below is the schema for the notification data:
| Parameter | Type | Description |
|---|---|---|
| --topic | String | The destination topic name on ntfy.sh |
| --priority | Integer | Urgency level from 1 (lowest) to 5 (highest) |
| --tags | String | Comma-separated list of tags or emojis |
| --actions | String | Semicolon-separated list of action buttons (e.g., view, http) |
| --attach | String | URL of an image or file to attach to the notification |
ntfy-notify Advanced Features
- Support for rich action buttons to enable interactivity directly from the mobile notification shade.
- Automatic timestamp generation when no message is provided, ideal for simple heartbeat checks.
- High-priority alert support to bypass do-not-disturb settings on compatible devices.
- Multi-tag support for categorized filtering and visual emoji indicators.
SKILL.md
Loading
Related Openclaw Skills
Miro Web SDK
A comprehensive development kit for building web plugins and desktop applications that extend Miro's collaborative whiteboarding capabilities.
Miro MCP Integration
Connect OpenClaw agents to Miro via the Model Context Protocol to bridge the gap between visual brainstorming and technical implementation.
Miro API Integration
A comprehensive developer tool for programmatically managing Miro boards, shapes, cards, and team resources via the v2 REST API.
Agent Matchmaker
Automatically discovers compatible AI agents and posts collaboration recommendations to foster ecosystem growth.
Instacart Browser Automation
Automate grocery ordering and smart replenishment on Instacart using browser-based AI agents.
CalDAV Calendar (vdirsyncer + khal)
A robust CLI calendar integration that synchronizes CalDAV servers with local Linux environments using vdirsyncer and khal.
Featured*
