SuperAPI AI 工具集

gotify

通用与其它

查看项目

更新于 10-15 23:33

技能介绍

用途:该技能让 Clawdbot 通过 Gotify 服务器发送推送通知,适用于长任务完成提醒、后台操作状态更新、重要事件或错误通知,以及与任务完成钩子集成。

主要能力:支持发送基本通知、自定义标题、优先级(0-10,默认5,8-10可能触发声音或振动)以及 Markdown 格式消息。通知内容要求包含项目/工作目录、任务描述、会话 ID(如可用)和状态/下一步动作。

使用方式:先在 ~/.homelab-skills/.env 中配置 GOTIFY_URL(服务器地址,无尾斜杠)和 GOTIFY_TOKEN(应用令牌,在 Gotify 设置→应用→创建应用获取)。基本调用:bash scripts/send.sh "Task completed successfully";带标题:bash scripts/send.sh --title "Build Complete" --message "skill-sync tests passed";带优先级:bash scripts/send.sh -t "Critical Alert" -m "Service down" -p 10;Markdown:bash scripts/send.sh --title "Deploy Summary" --markdown --message "..."。参数包括 -m/--message(必填)、-t/--title、-p/--priority、--markdown。可通过 && 与长任务串联,或在错误时用 if ! 判断后发送高优先级通知。

适用场景:长任务(>5分钟)完成、计划实现结束、被阻塞需用户决策、任务转换需审批,以及用户明确要求通知时。

限制:需要能访问 Gotify 服务器的网络;应用令牌需具备创建消息权限;Markdown 支持取决于 Gotify 客户端版本;通过 zsh-tool 调用脚本时必须使用 pty: true,否则输出不可见。官方 API 文档见 https://gotify.net/docs/。