核心用法
Token Burn Monitor 是一个专为 OpenClaw 多代理系统设计的成本监控仪表盘，采用零依赖 Node.js 架构运行。核心组件 server.js 提供稳定 API，前端主题支持热插拔切换。用户通过 bash start.sh 一键启动，默认监听 3847 端口。
主要功能模块：
- 实时追踪：按代理维度聚合 token 消耗、模型调用分布、缓存命中率
- 成本拆解：支持自定义模型定价 (
modelPricing)，自动计算 30 天历史趋势 - 单代理透视：
GET /api/agent/:id提供单次调用级明细，含用户提示词展开追踪 - 定时任务监控：Cron 作业状态与执行历史独立接口暴露
配置工作流：
1. 复制 config.default.json → config.json 自定义端口、主题、代理显示名
2. 通过 themes/<custom>/index.html 开发自定义主题，参考 API.md 对接端点
3. 环境变量 OPENCLAW_AGENTS_DIR 覆盖代理目录（默认 /home/node/.openclaw/agents）
显著优点
- 架构轻量：零外部依赖，部署简单，Node.js 原生运行
- 扩展性强：主题系统完全解耦，支持用户/代理自主开发前端
- 成本透明：细粒度到单次调用的 token 追踪，便于定位高消耗提示词
- 运维友好：
start.sh封装启停/status 命令，配置热重载需 restart
潜在局限
- 无持久层：依赖文件系统读取代理日志，大规模场景可能存在 I/O 瓶颈
- 认证缺失：文档未提及访问控制，默认部署可能暴露敏感成本数据
- 单节点设计：未体现集群或多实例聚合能力
- 主题开发门槛：需手动阅读
API.md对接，无可视化主题构建器
适合人群
- 运行 OpenClaw 多代理系统的开发者/运维人员
- 需要精细化 LLM 成本控制的中小团队
- 具备前端能力、希望自定义监控视图的进阶用户
常规风险
| 风险点 | 说明 |
|--------|------|
| 数据暴露 | 默认无认证，建议通过反向代理（Nginx/Traefik）加 Basic Auth 或 IP 白名单 |
| 路径遍历 | `OPENCLAW_AGENTS_DIR` 若接受外部输入需校验，避免读取非授权目录 |
| 配置注入 | `config.json` 中的 `modelPricing` 若动态加载需校验数值类型，防止计算异常 |
| 资源耗尽 | 30 天历史查询若数据量大，建议增加查询参数限制或服务端分页 |