服务可用性监控

技能简介

uptime-monitor 是一套静默运行的 OpenClaw/Gateway 服务可用性监控方案。通过每5分钟执行一次心跳检测，自动记录服务中断事件（dead.json）或连续正常运行满7天（168小时）的里程碑（uptime.json）。所有状态文件存放于工作区 uptime/ 目录。

能做什么

• 自动检测 OpenClaw 会话与网关连接状态
• 累计连续正常运行时长，达成7天后生成 uptime.json 证明
• 服务中断时立即写入 dead.json 并标记故障起始时间
• 支持 Cron 定时触发，无需人工值守
• 提供独立脚本供手动调用或外部集成

使用说明

安装与配置（必须执行）

1. 添加5分钟周期定时任务：
   📊 cron add uptime-5m '{"kind":"every","everyMs":300000}' '{"kind":"systemEvent","text":"UPTIME CHECK 👻"}' --sessionTarget main
2. 验证任务已注册：
   📊 cron list
3. 查看执行历史：
   📊 cron runs uptime-5m

触发方式

• 自动：Cron 每5分钟推送 “UPTIME CHECK 👻” 系统事件
• 手动：发送消息 message "UPTIME CHECK 👻"

工作流程

1. 执行 📊 session_status 与 openclaw gateway status 双检
2. 成功：累加 streak_hours（每次+0.083h），≥168h 时生成 uptime.json
3. 失败： streak 归零，写入 dead.json 记录时间戳
4. 首次运行 streak 从0开始；Cron 漏执行不会误判为宕机

输入与输出

见下方输入与输出表格。

风险提示

• Cron 任务需手动添加，未配置则监控不生效
• 仅生成本地 JSON 文件，无邮件/短信等主动告警通道
• streak 计算依赖持续运行，重启 OpenClaw 会中断计时逻辑
• workspace/uptime/ 目录若被清理，历史记录丢失
• 网关状态检测依赖 exec 权限，受限环境可能失效

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kunoiiv/uptime-monitor/SKILL.md
来源类型：GitHub 仓库