Clawdbot官方出品的Telegram会话统计工具，实时展示API配额、会话时长等关键指标，帮助用户精准掌控资源消耗。
说明：
## 核心用法
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 阻塞。
会员专属
