name: gotify
description: 当长时间运行的任务完成或发生重要事件时，通过 Gotify 发送推送通知。适用于用户要求“发送 Gotify 通知”、“完成后通知我”、“推送通知”、“通过 Gotify 提醒我”或希望收到任务完成通知的场景。
version: 1.0.1
metadata:
clawdbot:
emoji: "🔔"
requires:
bins: ["curl", "jq"]

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 "任务成功完成"

带标题的通知

bash scripts/send.sh --title "构建完成" --message "skill-sync 测试已通过"

带优先级（0-10）的通知

bash scripts/send.sh -t "关键警报" -m "服务已下线" -p 10

支持 Markdown 格式

bash scripts/send.sh --title "部署摘要" --markdown --message "
## 部署完成

- **状态**: ✅ 成功
- **耗时**: 2分34秒
- **提交**: 5个新提交
"

与任务完成集成

方案一：任务后直接调用

# 运行长时间任务
./deploy.sh && bash ~/clawd/skills/gotify/scripts/send.sh "部署已完成"

方案二：钩子集成（未来）

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

# 示例钩子配置（概念性）
{
  "on": "task_complete",
  "run": "bash ~/clawd/skills/gotify/scripts/send.sh '任务: {{task_name}} 已在 {{duration}} 内完成'"
}

参数说明

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

示例

子代理完成时通知

# 生成子代理后
sessions_spawn --task "研究主题" --label my-research
# ... 等待完成 ...
bash scripts/send.sh -t "研究完成" -m "请检查会话: my-research"

错误时发送高优先级通知

if ! ./critical-task.sh; then
  bash scripts/send.sh -t "⚠️ 关键故障" -m "任务失败，请检查日志" -p 10
fi

丰富的 Markdown 通知

bash scripts/send.sh --markdown -t "每日摘要" -m "
# 系统状态

## ✅ 运行正常
- UniFi: 34 个客户端
- Sonarr: 1,175 个剧集
- Radarr: 2,551 部电影

## 📊 统计信息
- 运行时间: 621 小时
- 网络: 全部正常
"

工作流程

当用户说：
- “完成后通知我” → 在其命令后添加 && bash scripts/send.sh "任务完成"
- “发送 Gotify 警报” → 使用其消息运行 bash scripts/send.sh
- “任务完成的推送通知” → 使用适当的标题/优先级集成到其工作流程中

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

注意事项

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

参考

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