faahim/openclaw-skills

Overview

This skill installs and manages a self-hosted ntfy push notification server for real-time alerts from scripts, cron jobs, and monitoring tools. It automates installation, service setup, configuration, authentication, and optional reverse-proxy integration so you can run notifications without third-party services. Use it to send instant messages, attachments, and scheduled alerts to phones, desktops, and browsers.

How this skill works

The skill provides install scripts, systemd service files, and a sample server.yml to configure ntfy. It sets up optional auth, token management, rate limiting, attachment storage, and a web UI. Helper scripts let you send notifications from shell, cron, monitoring loops, webhooks, and any programming language via simple HTTP POSTs.

When to use it

• You need private push alerts without relying on external providers.
• Notify on cron job success/failure or CI/CD events.
• Monitor service uptime and get immediate failures pushed to your phone.
• Deliver attachments, rich mobile actions, or scheduled reminders.
• Expose ntfy behind nginx/caddy with SSL for production use.

Best practices

• Use auth-default-access: deny-all and tokens for private servers.
• Configure a reverse proxy with TLS (nginx/caddy) and set behind-proxy: true.
• Reserve topics and apply topic-level access rules for least privilege.
• Set sensible rate limits and a message cache to avoid abuse and reduce load.
• Test notifications with curl and a subscribed device before automating scripts.

Example use cases

• Send backup success/failure alerts from a cron job with a one-line curl or helper script.
• Notify on CI/CD pipeline results (builds, deploys) with priority and tags.
• Push server health alerts from a monitor script when endpoints return errors.
• Relay GitHub or Grafana webhooks into readable mobile notifications via the webhook relay script.
• Host ntfy behind nginx with LetsEncrypt to serve your team securely.