核心用法
该 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 服务异常,脚本将失败