Gotify 通知技能

当长时间运行的任务完成或发生重要事件时，向您的 Gotify 服务器发送推送通知。

目的

此技能使 Clawdbot 能够通过 Gotify 发送推送通知，可用于：

• 长时间运行的任务完成时发出警报
• 发送后台操作的状态更新
• 通知重要事件或错误
• 与任务完成钩子集成

设置

创建凭据文件：~/.clawdbot/credentials/gotify/config.json

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

• url：您的 Gotify 服务器 URL（无尾部斜杠）
• token：来自 Gotify 的应用令牌（设置 → 应用 → 创建应用）

用法

基本通知

bash scripts/send.sh "Task completed successfully"

带标题

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

带优先级（0-10）

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

Markdown 支持

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

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

与任务完成集成

选项一：任务完成后直接调用

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

选项二：钩子集成（未来）

当Clawdbot支持任务完成钩子时，此技能可被自动触发：

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

参数

• -m, --message <文本>：通知消息（必需）
• -t, --title <文本>：通知标题（可选）
• -p, --priority <0-10>：优先级（默认值：5）
  • 0-3：低优先级
  • 4-7：普通优先级
  • 8-10：高优先级（可能触发声音/振动）
• --markdown：在消息中启用Markdown格式

示例

子代理完成时通知

# 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"

错误发生时高优先级通知

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

富文本Markdown通知

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
"

工作流程

当用户说：

• “完成后通知我”→ 添加&& bash scripts/send.sh "任务完成"到他们的命令中
• "发送一个Gotify提醒"→ 运行bash scripts/send.sh附带他们的消息
• "任务完成的推送通知"→ 使用适当的标题/优先级将其集成到他们的工作流程中

务必确认通知已成功发送（检查是否返回包含消息ID的JSON响应）。

注意事项

• 需要网络访问您的Gotify服务器
• 应用令牌必须具备"创建消息"权限
• 优先级级别会影响客户端设备上的通知行为
• Markdown支持取决于Gotify客户端版本（大多数现代客户端都支持）

参考

• Gotify API文档：https://gotify.net/docs/
• 用于接收通知的Gotify Android/iOS应用程序