实时监控 Clawdbot 会话 token 用量,在 75%/90%/95% 临界点自动推送预警,防止对话中途因额度耗尽而丢失上下文
说明:
## 核心用法
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 额度爬取及历史用量追踪。






