model-usage-monitor Skill

OpenClaw 模型使用监控与告警技能

⚠️ Security & Permissions Declaration

This skill monitors log files and sends alerts. All operations are read-only except notifications:

| Operation | Purpose | Scope | |-----------|---------|-------| | Read semantic router log (semantic_check.log) | Parse model usage statistics | Read-only, local file | | Read OpenClaw logs | Detect usage anomalies | Read-only, local files | | Send alert notifications via OpenClaw messaging | Notify user of cost spikes | Local OpenClaw API only |

What this skill does NOT do:

• Does NOT modify any configuration or log files
• Does NOT access external servers or APIs
• Does NOT access model credentials directly
• Does NOT require elevated privileges
• Read-only monitoring — zero side effects on system state

功能

• 解析语义路由日志，统计模型使用分布
• 估算各模型调用次数和成本
• 计算缓存命中率
• 每小时自动告警检查
• 支持实时监控模式

安装

# 技能已包含监控脚本和自动配置
# 安装后自动创建每小时检查的 Cron Job

使用

查看监控报告

# 完整报告
python3 ~/.openclaw/workspace/.lib/model_usage_monitor_v2.py

# JSON 格式
python3 ~/.openclaw/workspace/.lib/model_usage_monitor_v2.py --format json

# 仅检查告警
python3 ~/.openclaw/workspace/.lib/model_usage_monitor_v2.py --alert-check

实时监控

python3 ~/.openclaw/workspace/.lib/model_usage_monitor_v2.py --live

告警阈值

| 类型 | 阈值 | 说明 | |------|------|------| | Opus 调用频繁 | >5 次/小时 | 防止意外大量使用昂贵模型 | | Opus 成本过高 | >$0.50/小时 | 成本控制 | | 总成本过高 | >$2.00/小时 | 总体预算控制 |

文件结构

.skills/model-usage-monitor/
├── SKILL.md              # 本文件
├── monitor.py            # 核心监控脚本
├── setup.py              # 自动安装/配置
└── config.json           # 默认配置

技术细节

• 全部使用本地 Ollama 模型，零 API 调用
• 只读日志文件，零侵入
• 基于 semantic_check.log 和 gateway.log 分析