Telegram Usage Stats

📊 实时监控 API 配额与重置倒计时

实时展示 Telegram bot 会话配额、重置倒计时与 API 使用状态,支持一键获取可视化统计。

收藏
5.7k
安装
2.3k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

该 Skill 通过执行 Node.js 脚本 /home/drew-server/clawd/skills/telegram-usage/handler.js,调用底层 clawdbot models status 命令,实时抓取 API 配额与重置时间数据,并输出为 Telegram 兼容的 HTML 格式消息。

使用场景:当用户询问"剩余配额多少"、"API 什么时候重置"或"会话用了多少 token"时,系统直接执行该脚本返回格式化结果。

显著优点

  • 零配置即用:无需额外参数,单次命令调用即返回完整统计
  • 可视化友好:使用 emoji 指示器(🟢/🔴)与进度百分比,一眼判断配额健康度
  • 实时精准:直接读取 clawdbot 底层状态,非缓存数据
  • 平台适配:原生输出 Telegram HTML parseMode,兼容性强

潜在缺点与局限性

  • 依赖特定环境:硬编码路径 /home/drew-server/clawd/skills/telegram-usage/handler.js,仅适用于 clawd-server 部署环境,迁移需修改路径
  • 功能单一:仅展示 quota 与 reset timer,不包含历史趋势、token 消耗明细或成本估算
  • 无持久化:每次调用独立查询,不存储会话对比数据
  • Node.js 依赖:目标系统必须预装 node 运行时

适合人群

  • Telegram bot 运维人员需快速巡检 API 配额状态
  • clawd-server 用户希望监控会话资源消耗
  • 开发者调试 bot 时确认是否接近 rate limit

常规风险

  • 路径遍历风险:若 handler.js 存在注入漏洞,可能被利用执行非预期 Node 脚本(需配合文件系统权限管控)
  • 信息泄露:配额信息属于运营敏感数据,建议在私聊或受限群中使用
  • 依赖可用性:若 clawdbot models status 命令变更或 clawdbot 服务异常,脚本将失败

Telegram Usage Stats 内容

手动下载zip · 9.2 kB
config-example.jsonapplication/json
请选择文件