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:

Setup

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

```json

{

"url": "https://gotify.example.com",

"token": "YOUR_APP_TOKEN"

}

```

Usage

Basic Notification

```bash

bash scripts/send.sh "Task completed successfully"

```

With Title

```bash

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

```

With Priority (0-10)

```bash

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

```

Markdown Support

```bash

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

Deployment Complete

"

```

Integration with Task Completion

Option 1: Direct Call After Task

```bash

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:

```bash

Example hook configuration (conceptual)

{

"on": "task_complete",

"run": "bash ~/clawd/skills/gotify/scripts/send.sh 'Task: {{task_name}} completed in {{duration}}'"

}

```

Parameters

- 0-3: Low priority

- 4-7: Normal priority

- 8-10: High priority (may trigger sound/vibration)

Examples

Notify when subagent finishes

```bash

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

```bash

if ! ./critical-task.sh; then

bash scripts/send.sh -t "⚠️ Critical Failure" -m "Task failed, check logs" -p 10

fi

```

Rich markdown notification

```bash

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

System Status

✅ Healthy

📊 Stats

"

```

Workflow

When the user says:

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

Notes

Reference