核心用法
Token Burn Monitor 是一款专为 OpenClaw 代理设计的零依赖 Node.js 监控仪表板,用于实时追踪各代理的 Token 消耗、成本分摊及缓存命中率。用户可通过浏览器访问 127.0.0.1:3847 查看默认暗色主题界面,或自定义主题满足个性化需求。
核心功能包括:
- 多代理监控:自动发现代理目录,支持配置化显示名称与图标
- 成本细分:按模型维度统计费用,支持自定义定价覆盖
- 历史趋势:30 天成本变化曲线,便于容量规划
- Cron 作业健康:读取调度任务状态,监控自动化流程
- 会话明细:单代理级别的每次调用拆解,含 Token 用量与缓存命中情况
显著优点
1. 零依赖轻量架构:纯 Node.js 实现,无需外部数据库或运行时依赖
2. 安全优先设计:默认绑定 localhost、无 Shell 执行、出站网络隔离、用户提示脱敏
3. 主题可扩展:基于标准 REST API 的前后端分离架构,支持用户自定义界面
4. 配置灵活:环境变量与 JSON 配置双重覆盖,便于容器化部署
潜在局限
- 本地访问限制:默认仅监听 127.0.0.1,跨网络查看需额外代理配置
- 只读数据模型:仅支持 GET 请求,无法通过 API 修改配置或清除数据
- 文件系统依赖:所有数据源于 JSONL 会话文件,高并发场景下 I/O 可能成为瓶颈
- 无告警机制:缺少内置阈值告警或通知推送功能
适合人群
- OpenClaw 多代理用户,需掌握各代理的实际调用成本
- 开发团队进行 LLM 费用分摊与预算管控
- 运维人员监控定时任务执行状态与系统健康
常规风险
- 数据隐私:虽然默认脱敏用户提示,但会话元数据仍包含模型选择、时间戳等敏感信息
- 路径遍历:若
OPENCLAW_AGENTS_DIR被恶意配置,可能导致非授权文件读取(需配合文件权限管控) - 端口暴露风险:修改绑定地址为
0.0.0.0将暴露监控接口,建议在反向代理后使用