- name
- token-monitor
- description
- OpenClaw Token 实时监控面板。支持：(1) SQLite 持久化存储历史数据 (2) 实时监控当前 Token 消耗（增量曲线） (3) 历史视图查看任意一天的消耗 (4) 按日/时会话汇总 (5) 人民币费用估算（MiniMax 官方定价） (6) 滚轮缩放 X 轴 (7) 图表采样防卡顿。触发场景：(1) 用户要求查看 Token 消耗 (2) 监控 AI 模型使用量 (3) 分析日/小时级别消耗趋势 (4) 排查 Token 异常消耗。
- author
- OldYoung
- email
- ericyang81@gmail.com
- version
- 1.2.0
- tags
- latest
OpenClaw Token 监控中心
快速开始
# 启动监控服务
node skills/token-monitor/scripts/token-monitor.js
# 访问面板
open http://192.168.50.210:3000
功能一览
| 模块 | 说明 |
|---|
| 📊 实时曲线 | 每 3 秒轮询，蓝线显示每次轮询的 Token 增量，橙线显示速率 (tokens/s) |
| 📈 历史视图 | 点 ← → 或日期下拉，查看任意一天的完整消耗曲线 |
| 🏺 SQLite 持久化 | 数据写入 /workspace/data/token_history.db，刷新页面不丢失 |
| 💰 人民币估算 | 基于 MiniMax 官方定价（输入 ¥2.1/百万，输出 ¥8.4/百万） |
| 📋 会话详情表 | 每会话 Input/Output/Total Tokens、费用、占比条 |
| 🍩 环形图 | 各会话 Token 消耗占比分布 |
| 🔍 滚轮缩放 | 鼠标在图表上滚轮可放大/缩小 X 轴 |
| 📷 导出图片 | 点击"📷 导出图表"下载 PNG |
数据存储
- 数据库:
data/token_history.db（SQLite） - 表:
snapshots（每次轮询各会话明细）、rate_history（每次轮询速率）、daily_summary（每日汇总） - 轮询间隔: 3 秒（可在页面顶部调整）
- 保留策略: 永久保留，按日期查询
技术细节
- 服务器:
token-monitor.js（Node.js，端口 3000） - 前端:
token-monitor.html（Chart.js + chartjs-plugin-zoom，纯前端无需构建） - 数据库: sql.js（WASM 版本，无需本地 SQLite 编译）
- API:
/data（实时快照）、/api/daily?date=YYYY-MM-DD（历史数据）、/api/dates（可用日期列表） - 依赖:
openclaw sessions --active --json（数据来源）
目录结构
skills/token-monitor/
├── SKILL.md # 本文件
├── package.json
└── scripts/
├── token-monitor.js # 服务器（轮询 + SQLite + API）
└── token-monitor.html # 前端仪表盘
