Gotify消息推送

技能简介

Gotify消息推送技能用于在长时间运行的任务完成或重要事件发生时，向用户手机或桌面客户端发送即时通知。通过自建Gotify服务器，实现低延迟、无依赖的消息推送服务。

能做什么

• 任务完成后自动推送状态通知
• 后台操作进度实时更新
• 异常事件高优先级告警
• 支持Markdown格式的富文本消息
• 多优先级分级（0-10级）

使用说明

安装准备

# 确认系统已安装依赖
curl --version
jq --version

# 若无jq，安装命令：
# Ubuntu/Debian: sudo apt-get install jq
# macOS: brew install jq
# CentOS: sudo yum install jq

配置凭证

创建配置文件 ~/.clawdbot/credentials/gotify/config.json：

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

获取token：登录Gotify管理后台 → Settings → Apps → Create Application

基础用法

# 简单通知
bash scripts/send.sh "任务执行完毕"

# 带标题的通知
bash scripts/send.sh --title "构建完成" --message "测试已通过"

# 高优先级告警（会触发声音/震动）
bash scripts/send.sh -t "严重警告" -m "服务不可用" -p 10

# Markdown格式消息
bash scripts/send.sh --markdown -t "部署摘要" -m "## 部署成功
- **耗时**: 2分34秒
- **提交**: 5个新commit"

与任务结合

# 方式一：命令链式调用
./deploy.sh && bash ~/clawd/skills/gotify/scripts/send.sh "部署完成"

# 方式二：错误捕获通知
if ! ./critical-task.sh; then
  bash scripts/send.sh -t "⚠️ 执行失败" -m "请检查日志" -p 10
fi

输入与输出

见下方输入与输出表格。

风险提示

• 需确保Gotify服务器网络可达，内网部署时需配置公网访问或VPN
• App token需具备”create message”权限，泄露后他人可向你的设备推送消息
• 高优先级消息（8-10级）可能频繁触发设备声音/震动，避免滥用
• Markdown渲染效果因客户端版本而异，关键信息建议用纯文本
• curl/jq未安装时脚本会直接报错，需提前检查依赖

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jmagar/gotify/SKILL.md
来源类型：开源社区技能