核心用法
OpenClaw Usage Dashboard 是一个零依赖的 Node.js 本地仪表盘,通过读取 ~/.openclaw/agents/*/sessions/*.jsonl 日志文件,提供交互式的 API 用量分析。启动方式极为简单:执行 node server.js 后访问 http://localhost:7842 即可,支持 --port 参数自定义端口。
功能模块
- 时间线图表:支持按模型、代理或双维度筛选的请求趋势
- 模型卡片:各模型的 token 消耗与请求数排行
- 代理活动:分代理的调用量统计
- 时段热力图:24小时活动分布可视化
- Token 效率:缓存命中率与平均 prompt 长度
- 系统健康:内存(macOS 支持 VM 感知)、磁盘、运行时长、版本信息
- 周期选择器:小时/日/周/月/年五档粒度(快捷键 1-5)
显著优点
1. 零依赖架构:纯 Node.js 18+ 标准库实现,无需 npm install,部署成本极低
2. 完全本地化:无外部服务调用,敏感用量数据不出本机,契合隐私合规场景
3. 跨平台支持:macOS、Linux、Windows 全兼容
4. 实时交互:浏览器端动态刷新,支持键盘快捷键高效操作
5. 多维透视:模型、代理、时间三维交叉分析,满足精细化运营需求
潜在局限
- 数据源限制:仅支持 OpenClaw 特定日志格式,其他 LLM 框架需适配
- 单机架构:无多节点聚合能力,分布式部署场景受限
- 持久化缺失:未提及历史数据归档或长期趋势存储机制
- 权限管控:作为本地服务,缺少内置访问控制,多用户环境需谨慎
适合人群
- 个人开发者与小型团队,需要快速了解 OpenClaw 调用成本分布
- 对数据隐私敏感、拒绝 SaaS 化监控方案的企业
- 需要离线环境运行的边缘计算或内网部署场景
常规风险
- 端口暴露:默认 7842 端口若部署于共享环境,可能被局域网内其他用户访问
- 日志解析:直接读取
.jsonl文件存在格式变更导致的解析失败风险 - 资源占用:长时间运行 Node 进程对低配置设备可能产生内存压力