Ntfy Cli

Send push notifications via ntfy.sh or self-hosted ntfy server. Supports priorities, titles, tags, icons, and attachments.

Krzysztof@genortg

Install

openclaw skills install @genortg/ntfy-cli

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:

Build the message content
Use ntfy send with appropriate flags
Choose priority based on urgency
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