Uptime Kuma监控管理

技能简介

Uptime Kuma 是一款开源的服务器监控工具，本技能通过 Python CLI 封装其 Socket.IO API，支持查看监控状态、增删监控项、暂停/恢复检测、查询心跳历史等操作。

能做什么

• 获取整体监控状态摘要与详细列表
• 添加 HTTP、Ping、端口、数据库等多种类型监控
• 暂停或恢复指定监控项
• 删除不再需要的监控配置
• 查看监控项的历史心跳记录
• 列出已配置的告警通知渠道

使用说明

安装依赖

pip install uptime-kuma-api

环境变量配置（在 shell 或 Clawdbot 配置中设置）：

• UPTIME_KUMA_URL – 服务器地址，如 http://localhost:3001
• UPTIME_KUMA_USERNAME – 登录用户名
• UPTIME_KUMA_PASSWORD – 登录密码

常用命令

# 查看整体状态
python scripts/kuma.py status

# 列出所有监控项
python scripts/kuma.py list

# 添加 HTTP 监控（30秒间隔）
python scripts/kuma.py add --name "API Health" --type http --url https://api.example.com/health --interval 30

# 暂停/恢复监控
python scripts/kuma.py pause <id>
python scripts/kuma.py resume <id>

# 查看24小时心跳历史
python scripts/kuma.py heartbeats <id> --hours 24

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管 UPTIME_KUMA_PASSWORD，避免明文暴露在共享环境中
• 批量暂停监控可能影响故障发现时效，维护完成后请及时恢复
• 删除监控操作不可逆，建议先确认监控 ID 无误
• 高频调用 API 可能对 Uptime Kuma 服务器造成负载压力

来源信息

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