Jackzhang Token Watcher

SKILL.md

---
name: jackzhang-token-watcher
description: 监控并提醒 token 使用量，当会话接近 20 万 token 上限时自动提醒用户开新会话。支持所有渠道会话，不只是飞书。触发条件：用户询问"token"、"查一下 token"、"用了多少"、"快满了"等相关问题或主动要求检查时。
---

# Token Watcher

监控 OpenClaw 任意渠道会话的 token 使用量，避免因超过上限导致会话崩溃。**支持所有渠道，不只是飞书**。

## 功能

1. **查询 token** - 快速查看所有最近会话的已用 / 总限制
2. **智能排序** - 按最后活动时间排序，最新会话排在最前
3. **阈值提醒**：
   - 50% 以下：正常
   - 50-80%：提醒"快了"
   - 80%+：强烈建议开新会话
   - 100%：会话已满，必须新建

## 使用方法

### 手动查询

用户说"查一下 token"、"看看用了多少"、"token"等时，运行脚本：

```bash
./skills/token-watcher/scripts/check_token.sh
```

脚本会自动：
- 获取所有会话
- 按最近活动排序
- 输出每个会话的 token 使用情况和状态建议

## 输出示例

```
========================================
会话: feishu:direct:ou_xxxxxx
========================================
已用: 12,345 / 200,000
百分比: 6%
========================================
✅ 正常，可以继续聊
```

## 提醒规则

根据百分比：
- <**50%**：✅ 正常，可以继续聊
- **50-80%**：⚠️ 已用超过一半，建议准备开新会话
- **80-100%**：🚨 已接近上限，强烈建议开新会话！
- **100%+**：💥 已满，必须开新会话！

## 预防建议

1. 重要内容随时说"记下来"，保存到文件
2. 不同话题开不同会话
3. 定期查 token，快满就换新会话