Send push notifications via ntfy.sh or self-hosted ntfy server. Supports priorities, titles, tags, icons, and attachments.
---
name: ntfy-cli
description: Send push notifications via ntfy.sh or self-hosted ntfy server. Supports priorities, titles, tags, icons, and attachments.
metadata:
openclaw:
emoji: "🔔"
requires:
bins:
- ntfy
---
# ntfy CLI Skill
Send push notifications using the `ntfy` command-line tool. Agents can use this to alert Genor on his devices.
## Installation
Ensure `ntfy` is installed on the system:
```bash
# On Debian/Ubuntu
sudo apt install ntfy
# Or download binary from https://ntfy.sh/
```
Verify with `ntfy --version`.
## Basic Usage
The simplest form: push a message to a topic (which is just a URL endpoint).
```bash
ntfy send <topic_url> "<message>"
```
Example (as tested by Genor):
```bash
ntfy send http://genorbox1:9101/email-notification "HEJ"
```
## Advanced Options
### Title
```bash
ntfy send --title "Alert from Email Emily" <topic_url> "message"
```
### Priority
Priorities: `max`, `high`, `default`, `low`, `min`
```bash
ntfy send --priority high <topic_url> "Important message"
```
### Tags (emojis)
```bash
ntfy send --tags warning,skull <topic_url> "Something went wrong"
```
### Markdown formatting
```bash
ntfy send --markdown <topic_url> "**Bold** and *italic* text"
```
### Click action (open URL when tapped)
```bash
ntfy send --click "https://example.com" <topic_url> "Open dashboard"
```
### Attachments (from URL)
```bash
ntfy send --attach "https://example.com/image.png" <topic_url> "See attached"
```
### Combining options
```bash
ntfy send \
--title "Server down" \
--priority max \
--tags warning,skull \
--click "https://statuspage.example.com" \
<topic_url> "Server xy01 is unreachable"
```
## Topic URL Format
- Self-hosted: `http://your-server:port/topic-name` or `https://your-server/topic-name`
- ntfy.sh cloud: `https://ntfy.sh/topic-name`
Topics are essentially passwords; choose something not easily guessable.
## When to Use
- Urgent alerts that need immediate attention (use `--priority max` or `high`)
- Informational notifications (use `low` or `min`)
- Email notifications (Email Emily)
- System health warnings
- Monitoring alerts
## Best Practices
- Always include a clear, concise message
- Use priority appropriately to avoid alert fatigue
- Tag messages with relevant emojis for quick visual scanning
- For critical alerts, consider adding a click action to open a dashboard or runbook
- Keep topic names secret if you want to restrict who can send notifications
## Agent Integration
When an agent needs to notify Genor via ntfy:
1. Build the message content
2. Use `ntfy send` with appropriate flags
3. Choose priority based on urgency
4. Add tags for context (e.g., `email-emily`, `health-check`)
Example from Email Emily:
```bash
ntfy send \
--title "New important email" \
--priority high \
--tags email,important \
http://genorbox1:9101/email-notification "From: john@example.com\nSubject: Project update..."
```
## Security Note
The ntfy topic URL is effectively a shared secret. Do not expose it in logs or public channels. Only use it within secure environments.
---
*ntfy-cli skill for OpenClaw agents - Updated 2026-04-02*don't have the plugin yet? install it then click "run inline in claude" again.