核心用法
Token Alert Skill 通过调用 Clawdbot 的 session_status 工具实时获取会话 token 用量,提供三种交互方式:
1. 交互式仪表盘:通过「Show token dashboard」或运行 show_dashboard.py 启动 HTML 可视化面板,含动画效果与颜色渐变进度条
2. 终端速查:自然语言指令(如「Wie viele Tokens habe ich noch übrig?」)或运行 check.py 获取即时状态
3. 自动预警:后台监控并在 25%/50%/75%/90%/95%/100% 六级阈值触发 Telegram 推送
显著优点
- 六级阈值体系:从早期提醒到紧急预警全覆盖,避免单点失效
- Material Design 进度条:盒式字符(▰/▱)配合颜色渐变,终端与消息中均可清晰识别
- 无状态设计:无需持久化文件,每次计算最新状态
- 会话预估:基于 ~50k token/会话的均值估算剩余对话次数
- HEARTBEAT 集成:可嵌入日常检查清单实现自动化监控
潜在局限
- 监控范围受限:仅覆盖 Clawdbot 会话 token,不监控 Claude.ai API 独立额度
- 依赖活跃会话:需保持 Clawdbot 连接才能获取状态
- 阈值附近噪音:若用量在临界值波动,可能产生重复预警
适合人群
- 高频使用 Clawdbot 进行长对话或复杂任务的用户
- 需要精准控制会话成本、避免任务中断的开发者与内容创作者
- 多项目管理场景下需统筹 token 分配的 team lead
常规风险
- 误报与漏报平衡:六级阈值虽细,但用户仍需理解「预估会话数」基于均值,实际消耗因任务复杂度差异较大
- 外部通知依赖:Telegram 预警需预先配置通道,否则仅能在终端/仪表盘查看
- 权限与隐私:脚本需访问
session_status工具,用户应确认来源可信
扩展性
预留与 token-router 技能集成接口,未来可能支持 Claude.ai API 额度爬取及历史用量追踪。