（6205期）Token Budget Monitor – 智能管控 token 消耗预算

智能管控 token 消耗预算 OpenClaw 定时任务的 token 用量监控与预算控制工具，支持按任务配额管理、阈值告警及免费模型推荐 使用说明 核心用法 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 数值做校验，存在被污染风险 预算绕过：纯客户端/脚本层限额，服务端若无二次校验，可被直接调用绕过 误告警疲劳：阈值设置不当或任务波动大时，可能导致频繁告警降低响应敏感度 原始说明 Track and control token consumption across OpenClaw cron jobs