gotify – OpenClaw Skill

---

name: gotify description: Send push notifications via Gotify when long-running tasks complete or important events occur. Use when the user asks to "send a Gotify notification", "notify me when this finishes", "push notification", "alert me via Gotify", or wants to be notified of task completion. version: 1.0.1 metadata: clawdbot: emoji: "🔔" requires: bins: ["curl", "jq"]

Gotify Notification Skill

Send push notifications to your Gotify server when long-running tasks complete or important events occur.

Purpose

This skill enables Clawdbot to send push notifications via Gotify, useful for:

• Alerting when long-running tasks complete
• Sending status updates for background operations
• Notifying of important events or errors
• Integration with task completion hooks

Setup

Create the credentials file: ~/.clawdbot/credentials/gotify/config.json

{
  "url": "https://gotify.example.com",
  "token": "YOUR_APP_TOKEN"
}

• url: Your Gotify server URL (no trailing slash)
• token: Application token from Gotify (Settings → Apps → Create Application)

Usage

Basic Notification

bash scripts/send.sh "Task completed successfully"

With Title

bash scripts/send.sh --title "Build Complete" --message "skill-sync tests passed"

With Priority (0-10)

bash scripts/send.sh -t "Critical Alert" -m "Service down" -p 10

Markdown Support

bash scripts/send.sh --title "Deploy Summary" --markdown --message "
## Deployment Complete

- **Status**: ✅ Success
- **Duration**: 2m 34s
- **Commits**: 5 new
"

Integration with Task Completion

Option 1: Direct Call After Task

# Run long task
./deploy.sh && bash ~/clawd/skills/gotify/scripts/send.sh "Deploy finished"

Option 2: Hook Integration (Future)

When Clawdbot supports task completion hooks, this skill can be triggered automatically:

# Example hook configuration (conceptual)
{
  "on": "task_complete",
  "run": "bash ~/clawd/skills/gotify/scripts/send.sh 'Task: {{task_name}} completed in {{duration}}'"
}

Parameters

• -m, --message <text>: Notification message (required)
• -t, --title <text>: Notification title (optional)
• -p, --priority <0-10>: Priority level (default: 5)
  • 0-3: Low priority
  • 4-7: Normal priority
  • 8-10: High priority (may trigger sound/vibration)
• --markdown: Enable markdown formatting in message

Examples

Notify when subagent finishes

# After spawning subagent
sessions_spawn --task "Research topic" --label my-research
# ... wait for completion ...
bash scripts/send.sh -t "Research Complete" -m "Check session: my-research"

Notify on error with high priority

if ! ./critical-task.sh; then
  bash scripts/send.sh -t "⚠️ Critical Failure" -m "Task failed, check logs" -p 10
fi

Rich markdown notification

bash scripts/send.sh --markdown -t "Daily Summary" -m "
# System Status

## ✅ Healthy
- UniFi: 34 clients
- Sonarr: 1,175 shows
- Radarr: 2,551 movies

## 📊 Stats
- Uptime: 621h
- Network: All OK
"

Workflow

When the user says:

• "Notify me when this finishes" → Add && bash scripts/send.sh "Task complete" to their command
• "Send a Gotify alert" → Run bash scripts/send.sh with their message
• "Push notification for task completion" → Integrate into their workflow with appropriate title/priority

Always confirm the notification was sent successfully (check for JSON response with message ID).

Notes

• Requires network access to your Gotify server
• App token must have "create message" permission
• Priority levels affect notification behavior on client devices
• Markdown support depends on Gotify client version (most modern clients support it)

Reference

• Gotify API docs: https://gotify.net/docs/
• Gotify Android/iOS apps for receiving notifications

Gotify Skill

Send push notifications via Gotify from Clawdbot.

What It Does

• Push notifications — send alerts to your phone/desktop
• Priority levels — control notification importance (0-10)
• Markdown support — rich formatted notifications
• Task completion — notify when long-running tasks finish

Setup

1. Create an Application Token

1. Open your Gotify web UI
2. Go to Apps tab
3. Click Create Application
4. Copy the generated Token

2. Create Credentials File

mkdir -p ~/.clawdbot/credentials/gotify
cp config.json.example ~/.clawdbot/credentials/gotify/config.json
# Edit with your actual values

Or create manually:

{
  "url": "https://gotify.example.com",
  "token": "your-app-token-here"
}

3. Test It

bash scripts/send.sh "Hello from Clawdbot!"

Usage Examples

Basic notification

bash scripts/send.sh "Task completed successfully"

With title

bash scripts/send.sh --title "Build Complete" --message "All tests passed"
# Or shorthand:
bash scripts/send.sh -t "Build Complete" -m "All tests passed"

With priority

# High priority (triggers sound/vibration)
bash scripts/send.sh -t "Critical Alert" -m "Service down" -p 10

# Low priority (silent)
bash scripts/send.sh -m "Background task done" -p 2

Priority levels:

• 0-3: Low (silent)
• 4-7: Normal (default: 5)
• 8-10: High (may trigger sound/vibration)

Markdown formatting

bash scripts/send.sh --markdown -t "Deploy Summary" -m "
## Deployment Complete

- **Status**: ✅ Success
- **Duration**: 2m 34s
- **Commits**: 5 new
"

Integration with commands

# Notify when a command finishes
./deploy.sh && bash scripts/send.sh "Deploy finished"

# Notify on error
./critical-task.sh || bash scripts/send.sh -t "⚠️ Failure" -m "Task failed" -p 10

Parameters

Flag	Description
-m, --message	Notification message (required)
-t, --title	Notification title (optional)
-p, --priority	Priority 0-10 (default: 5)
--markdown	Enable markdown formatting

Environment Variables (Alternative)

export GOTIFY_URL="https://gotify.example.com"
export GOTIFY_TOKEN="your-app-token"

Troubleshooting

"Gotify not configured"
→ Check your config file exists at ~/.clawdbot/credentials/gotify/config.json

Connection refused
→ Verify your Gotify server URL is correct

401 Unauthorized
→ Your token is invalid — create a new app in Gotify

License

MIT