Telegram Usage Stats

核心用法

该 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 是一款轻量级的会话统计工具，专用于 Clawdbot/Telegram Bot 运维场景。用户通过执行单条命令 node handler.js 即可获取格式化的 HTML 状态报告，直接适配 Telegram 的消息解析模式。

输出包含两大核心指标：

• 配额剩余：以百分比形式展示当前 API 调用额度（如 🟢 47%），附带可视化状态 emoji
• 重置倒计时：精确到分钟的剩余窗口期（如 53m），便于运维预判流量洪峰

显著优点

1. 零依赖架构：仅依赖 Node.js 内置模块（fs/path/child_process），彻底规避供应链攻击风险
2. 本地化数据链路：通过 clawdbot models status 本地命令拉取数据，全程无外部网络请求
3. Telegram 原生兼容：输出预设 HTML 格式，可直接嵌入 Telegram 消息体，无需二次转换
4. 轻量即开即用：595 行代码、2 个文件，无需配置即可运行

潜在局限

• 功能单一：仅支持配额与计时查询，无历史趋势分析或告警阈值设置
• 平台绑定：深度依赖 Clawdbot CLI 环境，无法独立运行于其他 Bot 框架
• 交互缺失：纯命令行触发，无交互式菜单或定时自动推送能力

适合人群

• Bot 运维者：需要快速查看 API 消耗状态的 Telegram 开发者
• 资源敏感型用户：关注 API 配额耗尽风险的小型项目团队
• 合规优先场景：对第三方依赖有严格审计要求的企业环境

常规风险

| 风险点 | 等级 | 说明 |

|--------|------|------|

| 本地命令执行 | Low | 使用 `execSync` 调用硬编码的 `clawdbot` 命令，无用户注入路径，风险可控 |

| 环境变量读取 | Info | 读取 `HOME`/`USERPROFILE` 以定位配置目录，标准做法 |

| 数据隐私 | Negligible | 仅访问 `~/.clawdbot` 下的配额文件，不涉及用户聊天内容 |

建议：当前版本已通过全维度安全扫描（S 级/85 分），适合生产环境直接部署。