核心用法
Telegram Usage Stats 是一款专为 Clawdbot 用户设计的本地会话统计工具。用户通过执行 node handler.js 即可在 Telegram 中获取格式化的实时使用数据，包括 API 配额剩余百分比、配额重置倒计时等关键信息。该工具直接调用本地 clawdbot models status 命令获取数据，并以 HTML 格式输出，完美适配 Telegram 的 parseMode 显示。
显著优点
本地化安全架构：完全基于本地文件系统运作，读取 ~/.clawdbot// 目录下的会话数据，无需网络连接即可运行，杜绝了数据外泄风险。零依赖设计：仅使用 Node.js 内置模块（fs、path、child_process），无外部 npm 依赖，避免了供应链攻击面。即时反馈体验：每次调用均实时计算当前配额状态，配合视觉化 emoji 指示器（🟢/🟡/🔴），让用户一眼掌握资源健康度。硬编码安全：系统命令完全固化，不存在用户输入注入漏洞。
潜在缺点与局限性
平台绑定性强：深度依赖 Clawdbot 生态，需预先安装并配置 clawdbot CLI 工具，独立使用价值有限。数据孤岛问题：所有统计信息仅存于本地，无法跨设备同步，会话重置后历史数据即丢失。功能单一：仅提供只读查询能力，不支持配额预警设置、自动通知等进阶功能。Telegram 场景局限：输出格式专为 Telegram 优化，在其他 IM 平台或终端直接查看时体验欠佳。
适合的目标群体
- 高频使用 Clawdbot API 的开发者与运维人员
- 需要实时监控配额消耗、避免服务中断的 Telegram Bot 运营者
- 注重数据隐私、偏好本地化处理方案的安全敏感型用户
- 轻量级使用场景下不愿部署复杂监控系统的个人用户
使用风险
环境依赖风险：若 clawdbot 命令未加入系统 PATH 或本地配置文件损坏，将导致功能完全失效。版本兼容性：随 Clawdbot 核心升级，本地数据格式可能变更，需关注版本匹配。无持久化保障：配额追踪文件位于用户目录，系统重装或误删将导致历史统计丢失。性能边界：高频调用 execSync 虽无安全风险，但在极端并发场景下可能产生轻微 I/O 阻塞。