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 分析