介绍
# Uptime Kuma Skill
通过围绕 Socket.IO API 的 CLI 包装器来管理 Uptime Kuma 监控。
## 设置
需要 `uptime-kuma-api` Python 包： ```bash pip install uptime-kuma-api ```
环境变量（在 shell 或 Clawdbot 配置中设置）： - `UPTIME_KUMA_URL` - 服务器 URL（例如 `http://localhost:3001`） - `UPTIME_KUMA_USERNAME` - 登录用户名 - `UPTIME_KUMA_PASSWORD` - 登录密码
## 用法
脚本位置：`scripts/kuma.py`
### 命令
```bash # Overall status summary python scripts/kuma.py status
# List all monitors python scripts/kuma.py list python scripts/kuma.py list --json
# Get monitor details python scripts/kuma.py get <id>
# Add monitors python scripts/kuma.py add --name "My Site" --type http --url https://example.com python scripts/kuma.py add --name "Server Ping" --type ping --hostname 192.168.1.1 python scripts/kuma.py add --name "SSH Port" --type port --hostname server.local --port 22
# Pause/resume monitors python scripts/kuma.py pause <id> python scripts/kuma.py resume <id>
# Delete monitor python scripts/kuma.py delete <id>
# View heartbeat history python scripts/kuma.py heartbeats <id> --hours 24
# List notification channels python scripts/kuma.py notifications ```
### 监控类型
- `http` - HTTP/HTTPS 端点 - `ping` - ICMP ping - `port` - TCP 端口检查 - `keyword` - HTTP + 关键词搜索 - `dns` - DNS 解析 - `docker` - Docker 容器 - `push` - 推送（被动） - `mysql`, `postgres`, `mongodb`, `redis` - 数据库检查 - `mqtt` - MQTT 代理 - `group` - 监控组
### 常见工作流
**检查哪些服务宕机：** ```bash python scripts/kuma.py status python scripts/kuma.py list # Look for 🔴 ```
**添加 30 秒间隔的 HTTP 监控：** ```bash python scripts/kuma.py add --name "API Health" --type http --url https://api.example.com/health --interval 30 ```
**维护模式（暂停所有）：** ```bash for id in $(python scripts/kuma.py list --json | jq -r '.[].id'); do python scripts/kuma.py pause $id done ```