gotify

What This Skill Does

The Gotify notification skill provides an elegant bridge between your background terminal operations and your mobile device. By integrating with the self-hosted Gotify server, this skill allows Clawdbot to dispatch real-time push notifications whenever a specific process concludes, encounters an error, or reaches a critical milestone. It supports message titles, adjustable priority levels from 0 to 10, and rich Markdown rendering, ensuring that the information you receive is formatted for quick readability on your phone. Whether you are running a long-lived machine learning training script, a large file backup, or a complex software compilation, this skill keeps you informed without requiring you to constantly monitor your console.

Installation

To install this skill, run the command: clawhub install openclaw/skills/skills/jmagar/gotify. Once installed, navigate to the ~/.clawdbot/credentials/gotify/ directory. Create a config.json file containing your server's URL and your unique Application Token. You can generate this token through your Gotify web interface by navigating to Settings, then Apps, and selecting "Create Application." Ensure your URL does not include a trailing slash to prevent connectivity errors.

Use Cases

This skill is indispensable for power users who manage automated workflows. Primary use cases include: triggering alerts upon completion of long-running build pipelines, notifying you when a scraping or indexing task has finished, delivering high-priority alerts when a critical cron job fails, and sending periodic system health summaries that utilize Markdown for clean, structured data representation. By abstracting the API calls into a simple bash script, it allows for easy integration into existing shell scripts and terminal aliases.

Example Prompts

1. "Notify me via Gotify when the current backup script finishes running."
2. "Send a high-priority push notification to my phone if the server deployment script fails."
3. "After the compilation finishes, use Gotify to send me a summary of the build results including the total duration."

Tips & Limitations

To maximize the utility of this skill, use the priority flags effectively: reserve priority 10 only for genuine emergencies to avoid notification fatigue. Note that because this relies on an external self-hosted server, notifications will not be delivered if your Gotify instance is offline or inaccessible from your local network. For advanced workflows, try combining this with shell conditional logic, such as appending the notification script to a standard exit command (&&) to ensure it only fires upon successful completion.