Usage Monitor

Monitor any service usage dashboard and alert when threshold is reached. User-configurable URL and threshold.

Usage Monitor - 通用用量监控 Skill

通用的用量/配额监控 Skill，支持用户自定义监控面板 URL 和告警阈值。

特性

• 🔗 自定义 URL - 支持任意用量/配额面板页面 URL（如：OpenClaw Token 面板、云服务用量页等）
• 🎯 自定义阈值 - 支持设置任意告警百分比（1-100）
• 📊 多维度监控 - 支持多个时间维度的用量数据
• 🔔 主动提醒 - 达到阈值时自动发送消息

快速开始

步骤 1：配置用户参数

复制 config.example.json 为 config.json 并填写：

{
  "panelUrl": "你的用量面板页面 URL",
  "alertThreshold": 80,
  "serviceName": "服务名称（可选）",
  "checkIntervalHours": 4
}

步骤 2：添加到 HEARTBEAT.md

- [ ] 检查服务用量

步骤 3：运行

node skills/usage-monitor/check.js

配置参数说明

参数	类型	必填	默认值	说明
panelUrl	string	✅	-	用量面板页面 URL（从浏览器地址栏复制）
alertThreshold	number	✅	80	告警阈值百分比（1-100）
serviceName	string	❌	"服务"	服务名称，用于告警消息
checkIntervalHours	number	❌	4	检查间隔（小时）

URL 获取方法

1. 打开你的用量/配额面板页面（如：OpenClaw Token 数量面板、云服务用量页等）
2. 复制浏览器地址栏的完整 URL
3. 粘贴到 config.json 的 panelUrl 字段

URL 示例：

https://example.com/usage/dashboard
https://platform.example.com/token/quota

告警消息示例

⚠️ 服务使用量提醒

📊 服务：OpenClaw Token
📈 当前用量：85%
📈 可用额度：15%
⏰ 剩余天数：30 天
🔗 查看：<你的面板 URL>

当前用量已达告警阈值（80%），请及时关注用量或考虑增加额度。

注意事项

1. URL 必须是完整的 HTTP/HTTPS 地址
2. 阈值范围 1-100
3. 浏览器自动化需要保持登录状态（如需要）
4. 首次使用需手动访问一次页面完成登录（如需要）

适用场景

• ✅ OpenClaw Token 数量监控
• ✅ 云服务用量监控（阿里云、AWS、腾讯云等）
• ✅ API 调用配额监控
• ✅ 资源包用量监控
• ✅ 任何有用量/配额面板的场景