Skill: genortg/ntfy-cli (version 1.0.0)

--- 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: [REDACTED_SECRET]\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*


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)