核心用法
telegram-usage 是一个轻量级的用量统计技能，通过 Node.js 脚本调用底层 clawdbot models status 命令，实时获取 Telegram Bot API 的配额信息。用户只需执行单条命令即可获得格式化的 HTML 输出，直接兼容 Telegram 的消息解析模式。
典型使用场景包括：高频消息发送后的配额检查、自动化工作流中的用量监控、以及会话管理时的资源评估。输出包含配额百分比（带颜色标识）、重置倒计时等关键指标，采用 Emoji 可视化设计，便于快速扫读。
显著优点
1. 即时反馈：无需登录外部面板，命令行直接获取实时数据
2. 格式友好：原生支持 Telegram HTML parseMode，可直接推送至聊天窗口
3. 零配置：依赖系统预装的 clawdbot 工具链，无需额外鉴权
4. 轻量高效：单次调用即返回，无持久化存储或网络延迟
潜在缺点与局限性
- 功能单一：仅覆盖配额与计时，不包含历史趋势、用量分析或预警机制
- 依赖特定环境：硬编码路径
/home/drew-server/clawd/skills/telegram-usage/handler.js，迁移或容器化时需手动调整 - 无错误处理说明：文档未提及 API 限流、网络中断或命令执行失败的降级策略
- 平台绑定：输出格式针对 Telegram 优化，迁移至其他 IM 平台需改写格式化逻辑
适合人群
- 自托管 Telegram Bot 的开发者与运维人员
- 需要频繁确认 API 配额的自动化脚本编写者
- 追求「命令行即仪表盘」极简工作流的技术用户
常规风险
- 信息泄露风险：配额数据本身敏感度低，但若脚本输出被记录到公共日志，可能暴露系统路径结构
- 依赖链风险：
clawdbot工具链若更新或弃用，技能将失效 - 权限风险：执行脚本需读取系统状态，部署时需注意文件权限最小化原则