核心用法
token-budget-monitor 是一款面向 OpenClaw 自动化工作流的 token 消耗追踪与预算管理工具。它通过命令行接口和 JavaScript 集成方式，为 cron 任务、fallback 链路和会话提供细粒度的用量监控。
基础操作：通过 track-usage.js 脚本执行状态查询（status）、单任务预算检查（check）、超额告警（alert）及模型推荐（recommend）四大功能。开发者可在 LLM 调用完成后，将 input/output tokens 及模型信息写入追踪系统，实现自动化埋点。
配置体系：采用层级化限额策略——全局日限额（dailyLimit）+ 任务级限额（jobLimits）+ 告警阈值（alertThreshold），并内置免费模型白名单（freeModels）用于成本优化。
显著优点
- 细粒度管控：支持 per-job 独立配额，避免单任务异常拖垮整体预算
- 零侵入集成：仅需在现有代码中追加一行 exec 调用即可接入，无需重构架构
- 成本感知：内置免费模型推荐机制，在高消耗场景自动提示降本方案
- 告警前置：80% 阈值触发预警，预留干预窗口而非事后熔断
潜在局限
- 单点依赖：作为外部脚本调用，若 track-usage.js 本身故障或路径变更，埋点数据丢失
- 无持久化说明：未明确说明数据存储机制（文件/数据库），高频写入可能存在性能或并发问题
- 权限盲区：exec 调用需确保 Node 进程具备目标路径执行权限，多租户环境需谨慎配置
- 模型白名单静态：freeModels 为硬编码配置，无法动态感知服务商免费额度变化
适合人群
OpenClaw 重度用户、需精细控制 API 成本的自动化运维团队、以及运行多 LLM 任务 cron job 的开发者。特别适合已有成熟工作流、不愿引入复杂监控基础设施的轻量级场景。
常规风险
- 配置泄露风险：
config.json若包含敏感限额策略或模型密钥路径，需限制文件读取权限 - 命令注入隐患：
exec拼接参数时若未对job-name、token 数值做校验，存在被污染风险 - 预算绕过：纯客户端/脚本层限额，服务端若无二次校验，可被直接调用绕过
- 误告警疲劳：阈值设置不当或任务波动大时，可能导致频繁告警降低响应敏感度