A specialized skill for sending real-time push notifications to a Gotify server upon task completion or system events.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gotify
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gotify using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Gotify Notification Skill?
The Gotify notification skill is a powerful extension designed for AI agents to bridge the gap between background processing and user awareness. By integrating with a self-hosted Gotify server, this addition to your library of Openclaw Skills allows your coding agent to keep you informed about long-running builds, deployment statuses, or critical errors via mobile and desktop alerts. It ensures that you stay productive without needing to constantly monitor terminal output for task completion.
This skill is engineered to handle everything from basic text alerts to rich, Markdown-formatted status reports. Whether you are managing a complex CI/CD pipeline or simply want a ping when a research subagent finishes its work, this implementation within Openclaw Skills provides a reliable, secure, and private way to manage agent-to-human communications.
Gotify Notification Skill Use Cases
- Monitoring long-running background tasks or script executions without manual polling.
- Receiving instant alerts for critical system failures or high-priority errors during automated workflows.
- Getting formatted deployment summaries and status reports directly on your mobile device.
- Tracking the completion of AI subagent research or intensive data processing sessions.
- Integrating automated status updates into self-hosted home lab and DevOps environments.
How Gotify Notification Skill Works
- The AI agent identifies a request for a notification or a trigger event during a task execution.
- The skill retrieves server credentials and application tokens from the local configuration file located in the user directory.
- A notification request is structured using provided parameters such as message body, title, and priority level.
- The skill executes a bash script that utilizes curl to send the payload to the Gotify API.
- The Gotify server processes the request and broadcasts the push notification to all connected client devices.
- The agent confirms the success of the delivery by parsing the JSON response and checking for a valid message ID.
Gotify Notification Skill Setup
To enable this functionality in your set of Openclaw Skills, you must first ensure curl and jq are installed on your system. Create a configuration file at ~/.clawdbot/credentials/gotify/config.json with your server details:
{
"url": "https://gotify.example.com",
"token": "YOUR_APP_TOKEN"
}
You can generate the token by navigating to Settings -> Apps -> Create Application within your Gotify web interface.
Gotify Notification Skill Data Schema & Taxonomy
The skill manages its operations through a structured configuration and specific command-line parameters. Below is the metadata taxonomy for this skill:
| Parameter | Description | Requirement |
|---|---|---|
| message | The main text content of the notification | Required |
| title | The header displayed at the top of the alert | Optional |
| priority | Numeric value (0-10) defining urgency and device behavior | Default: 5 |
| markdown | Boolean flag to enable rich formatting in the message | Optional |
| url | Your private Gotify instance endpoint | Config Only |
| token | Secure API key for your specific Gotify application | Config Only |
Gotify Notification Skill Advanced Features
- Support for high-priority alerts (levels 8-10) that can trigger sound and vibration on mobile clients.
- Full Markdown integration for creating rich, readable reports with headers, lists, and status emojis.
- Flexible CLI execution for manual triggers inside complex bash scripts and pipelines.
- Native integration for AI subagent tracking, allowing users to be notified when secondary agents complete their tasks.
- Future-proof hook support for automated triggering upon global task completion events.
SKILL.md
Loading
Related Openclaw Skills
TaskMaster
An intelligent project management system that breaks down complex goals and orchestrates AI sub-agents using cost-effective model selection.
Baidu Baike
A specialized knowledge retrieval tool that enables AI agents to query and extract authoritative encyclopedia data from Baidu Baike.
Scrapling Web Fetch
An intelligent web scraping tool that extracts clean main body content and converts it to Markdown for AI processing.
Scrapling Web Fetch
A high-performance web content extractor that transforms messy HTML into clean, LLM-ready Markdown while removing noise and reducing token usage.
Linkding Bookmark Manager
A comprehensive integration for managing, searching, and organizing bookmarks through the Linkding REST API.
Prowlarr
A comprehensive API integration for searching across torrent and Usenet indexers and managing Prowlarr settings.
METADATA
Featured*
