Gotify

核心用法

Gotify 技能为 Clawdbot 提供自托管推送通知能力，核心场景是长任务完成后主动告警。用户配置个人 Gotify 服务器 URL 与应用 Token 后，可通过 send.sh 脚本发送通知，支持标题自定义、0-10 优先级分级、Markdown 富文本格式。

典型调用模式：

• 管道式：./long-task.sh && bash scripts/send.sh "完成"
• 条件告警：if ! task; then send.sh -p 10 -t "失败"; fi
• 富文本报告：--markdown 参数渲染结构化状态摘要

显著优点

1. 完全自主可控：数据流经用户自托管服务器，规避 Pushover/PushBullet 等商业服务的隐私泄露风险
2. 优先级智能分级：8-10 级高优先级可触发设备强提醒（声音/振动），适合关键错误告警
3. 零外部依赖：仅需 curl + jq，不依赖 Python/Node 运行时
4. Markdown 原生支持：现代 Gotify 客户端可渲染标题、列表、表情符号，提升可读性

潜在局限

• 基础设施成本：需自行部署并维护 Gotify 服务端，对无服务器运维经验的用户有门槛
• 网络可达性要求：发送端必须能直连 Gotify 服务器，内网/防火墙场景需额外配置反向代理
• 无原生重试机制：脚本单次请求失败即退出，关键任务需用户自行包装重试逻辑
• Token 管理负担：应用令牌明文存储于 ~/.clawdbot/credentials/，权限粒度较粗（仅有"创建消息"开关）

适合人群

• 已拥有 Homelab / NAS / VPS 的进阶用户
• 对通知数据主权敏感（医疗、金融、研发场景）
• 需将 CLI 工作流（编译、部署、爬虫）与移动端联动的开发者

常规风险

| 风险点 | 说明 | 缓解建议 |

|--------|------|----------|

| Token 泄露 | 配置文件权限不当导致他人冒发通知 | `chmod 600` 配置文件，避免版本控制提交 |

| 服务器伪造 | 攻击者劫持 DNS/网络层重定向至恶意端点 | 启用 HTTPS 证书固定，内网使用 VPN/WireGuard |

| 消息泛滥 | 高频脚本错误导致通知轰炸 | 设置优先级阈值过滤，或引入速率限制逻辑 |

| 依赖缺失 | 目标环境缺少 `curl`/`jq` | 部署前置检查脚本，或改用纯 Bash HTTP 客户端 |

综合评估

该技能是隐私优先型通知方案的代表，将云端 SaaS 的功能等价迁移至用户可控基础设施。适合技术能力足以自运维 Gotify 服务端、且对数据出境有严格顾虑的用户群体。对于追求开箱即用的普通用户，商业推送服务在便捷性上仍具优势。

核心用法

Gotify Skill 通过调用自托管的 Gotify 服务器，实现任务完成时的即时推送通知。用户只需配置服务器 URL 和应用 Token，即可通过简单的 Shell 命令发送通知，支持标题自定义、优先级分级（0-10）以及 Markdown 富文本格式。

显著优点

1. 完全自主可控：不同于 Firebase Cloud Messaging 等第三方云服务，Gotify 要求用户自行部署服务器，数据主权完全归用户所有，无隐私外泄风险。

2. 极简依赖架构：仅依赖系统标准工具 curl 和 jq，零第三方库引入，大幅缩减攻击面，维护成本极低。

3. 灵活的集成能力：通过 && 链式调用或未来支持的 Hook 机制，可无缝嵌入任意长任务工作流，支持跨设备（Android/iOS/Web）实时推送。

4. 丰富的通知能力：支持 Markdown 格式化、多优先级分级（低/普通/高优先级触发不同提示效果），满足从日常状态更新到紧急故障告警的全场景需求。

潜在局限

• 运维门槛：需用户自行部署维护 Gotify 服务端，对技术能力有一定要求，不适合纯终端用户。
• Token 传输方式：遵循 Gotify API 设计，Token 通过 URL 查询参数传递，存在被服务器日志记录的风险。
• 网络依赖：依赖用户服务器的公网可达性或内网穿透方案，网络故障时通知失效。

适合人群

• 拥有自托管基础设施的 Homelab 玩家与系统管理员
• 对数据隐私敏感、拒绝第三方云服务的用户
• 需要将 CLI 工具链与移动端联动的自动化工作流构建者

常规风险

Token 若被截获可导致恶意消息推送，建议配合 HTTPS 强制加密、定期轮换 Token、限制服务器访问日志留存期等防护措施。来源为个人开发者（T3），建议生产环境使用前进行代码审计。