Token导航 LogoToken导航TokenDH.com
开发需要联网clawhub未标认证来源可访问clear审计提醒

windows-api-monitorwindows API monitor 监控告警

Agent Skill

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。它适合让 Agent 梳理 endpoint、生成 OpenAPI 草稿、检查字段命名、整理错误码或辅助前后端联调。使用时需要确认真实业务语义、鉴权方式、分页和错误处理规则;涉及生成接口文档时,应避免凭空补字段,最好从现有代码、schema 或接口样例中提取事实。

总安装

2,712

周安装

113

GitHub Stars

公开资料未说明

下载量

904
OpenClaw

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

MIT-0

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:windows-api-monitor(windows API monitor 监控告警)
来源仓库:https://github.com/guowaa223/windows-api-monitor
安装命令:
openclaw skills install windows-api-monitor
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 OpenClaw 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

ClawHubOpenClaw
openclaw skills install windows-api-monitor

简介

监控并统计Windows环境下OpenClaw API调用,支持实时分析、历史追踪及阈值告警,生成多维度使用报告。

SKILL.md

Windows专用API使用监控技能

概述

这是一个专门为Windows环境设计的API使用监控技能,用于替代依赖macOS CodexBar的model-usage技能。它直接读取OpenClaw日志文件来统计模型使用情况,实现"严格控制API使用效率"的目标。

技能信息

  • 名称: windows-api-monitor
  • 版本: 1.0.0
  • 作者: 阿康的私人助理
  • 创建日期: 2026-03-22
  • 适用平台: Windows (Windows 10/11)
  • 依赖: Python 3.8+, OpenClaw v1.0+

功能特性

Windows原生支持 - 针对Windows文件系统和日志结构优化 ✅ 实时监控 - 支持实时或定期模型使用统计 ✅ 多维度分析 - 按模型、按会话、按时间统计 ✅ 效率报告 - 生成简洁易读的使用报告 ✅ 历史追踪 - 追踪历史使用趋势 ✅ 告警机制 - 可设置使用阈值告警

安装说明

无需额外安装,技能已配置完整:

技能位置: C:\Users\Administrator\.openclaw\workspace\skills\windows-api-monitor

使用方法

基础命令

# 1. 查看当前会话的API使用情况
python scripts/api_monitor.py --mode current

# 2. 查看今日使用统计
python scripts/api_monitor.py --mode today

# 3. 查看本周使用统计
python scripts/api_monitor.py --mode week

# 4. 查看所有会话统计
python scripts/api_monitor.py --mode all

# 5. 按模型排序查看
python scripts/api_monitor.py --mode all --sort cost

# 6. 查看指定模型的详细使用
python scripts/api_monitor.py --model deepseek-ai

# 7. 生成使用报告文件
python scripts/api_monitor.py --mode all --output report.txt

高级功能

# 1. 设置使用阈值告警(例如:每100次调用告警)
python scripts/api_monitor.py --alerts --threshold 100

# 2. 查看成本最高的会话
python scripts/api_monitor.py --mode sessions --limit 10

# 3. 导出为JSON格式(用于自动化处理)
python scripts/api_monitor.py --mode today --format json

# 4. 清理旧日志文件
python scripts/api_monitor.py --cleanup --days 30

自动检查 - "够用/不够用"判断 (Windows编码兼容版)

专为"严格控制API调用"需求设计,自动判断剩余量:

一键检查命令(最简单)

# 方法1:运行PowerShell脚本(推荐)
scripts/check_api.ps1

# 方法2:运行批处理脚本
scripts/check_api_fixed.bat

# 方法3:Python命令
python scripts/auto_checker.py --simple --both

自动判断功能 (Windows兼容)

# 1. 简单检查(够用/不够用 + 剩余量)
python scripts/auto_checker.py --simple --both
# 输出示例:
# [今日] [OK] 充足 - 剩余量充足,可放心使用 (剩余85.0%)
# [本周] [OK] 充足 - 本周剩余量充足 (剩余72.5%)

# 2. 详细报告
python scripts/auto_checker.py --report --both

# 3. 持续自动监控(每30分钟检查一次)
python scripts/auto_monitor.py --continuous --interval 30

# 4. JSON格式(适合自动化处理)
python scripts/auto_checker.py --json

# 5. 仅显示告警
python scripts/auto_checker.py --alerts

输出说明 (Windows编码兼容)

  • [OK] 够用: 剩余量 > 20%
  • [WARN] 不够用: 剩余量 ≤ 20%
  • [ERROR] 耗尽: 剩余量 ≤ 0%

剩余量显示 (Windows编码兼容)

  • 剩余百分比: 85.0%
  • 剩余调用次数: 850次
  • 剩余令牌数: 850,000
  • 预计可用天数: 7天

自动化监控

# 每日定时监控(可添加到计划任务)
python scripts/daily_check.py

# 实时监控模式(持续监控API使用)
python scripts/auto_monitor.py --continuous --interval 30  # 每30分钟检查一次

文件结构

windows-api-monitor/
├── SKILL.md                      # 技能说明文档
├── scripts/
│   ├── api_monitor.py           # 主监控脚本
│   ├── daily_check.py           # 每日检查脚本
│   ├── realtime_monitor.py      # 实时监控脚本
│   └── utils/
│       ├── log_parser.py        # 日志解析工具
│       ├── report_generator.py  # 报告生成工具
│       └── alerts.py            # 告警工具
├── references/
│   ├── windows_logs.md          # Windows日志文件位置说明
│   └── openclaw_usage.md        # OpenClaw使用统计文档
├── templates/
│   ├── report_template.md       # 报告模板
│   └── alert_template.md        # 告警模板
└── config/
    └── settings.yaml            # 配置文件

监控数据源

本技能从以下位置收集API使用数据:

  1. OpenClaw会话日志: ~/.openclaw/logs/*.log
  2. 模型调用记录: ~/.openclaw/cache/model_usage/*.json
  3. 系统日志: Windows Event Logs (OpenClaw相关)
  4. 实时会话: 通过OpenClaw CLI接口获取

输出示例

=== API使用监控报告 (2026-03-22) ===

📊 今日使用统计:
- 总调用次数: 87
- 总令牌数: 12,450
- 估计成本: ~¥0.56

📈 按模型统计:
1. deepseek-ai: 45次 (¥0.31) - 51.7%
2. glm-5: 28次 (¥0.18) - 32.2%
3. 其他: 14次 (¥0.07) - 16.1%

⏰ 时间分布:
- 高峰期: 10:00-12:00 (38次)
- 稳定期: 14:00-18:00 (32次)
- 低峰期: 20:00-08:00 (17次)

⚠️ 告警信息:无异常

配置说明

编辑 config/settings.yaml 自定义监控行为:

# 基础配置
monitor:
  interval: 300  # 监控间隔(秒)
  retention_days: 30  # 数据保留天数

# 告警配置
alerts:
  enabled: true
  threshold_calls: 100  # 单日调用阈值
  threshold_tokens: 10000  # 单日令牌阈值
  notify_method: log  # 通知方式: log, email, webhook

# 报告配置
reports:
  daily_enabled: true
  weekly_enabled: true
  monthly_enabled: true
  output_dir: ./reports

故障排除

常见问题

  1. 无法读取日志文件: 检查文件权限和路径是否正确
  2. 数据不更新: 确认OpenClaw正在运行并生成日志
  3. 报告生成失败: 检查Python依赖是否安装完整

调试模式

python scripts/api_monitor.py --debug --verbose

更新日志

v1.0.0 (2026-03-22)

  • 初始版本发布
  • 支持基础监控功能
  • Windows原生优化
  • 多维度分析报告

注意事项

  1. 本技能仅监控OpenClaw API使用,不涉及其他应用
  2. 数据为估计值,实际成本以官方账单为准
  3. 建议定期清理旧日志文件以释放磁盘空间
  4. 重要告警建议结合其他监控手段验证

相关技能

  • model-usage: macOS环境的替代方案
  • healthcheck: 系统健康检查
  • skill-creator: 技能创建工具

适合场景

01

OpenClaw 用户查找和安装 Skill 时

02

用户想查找某类 Agent Skill 时

03

需要根据任务场景推荐可安装能力包时

04

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

补充不同宿主或平台的使用分布数据

能力 5

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

OpenClaw

71.39%
按下载量换算645

安全审计

VirusTotal

通过

ClawScan

可疑

Static analysis

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills