Agent Budget Governance 是一个专为多智能体系统设计的管理工具，旨在防止因智能体过度调用 API 而导致的失控支出问题。该系统通过为每个智能体分配每日输出令牌预算，实现对资源使用的精细化管控。当某个智能体的使用量接近或超出预设限额时，系统会自动触发不同级别的预警机制，并根据严重程度采取相应措施，如限制其创建子智能体的权限。这种机制不仅保障了整体系统的稳定性与安全性，也为团队协作提供了透明、可审计的治理框架。 该系统的核心运作流程简单高效：每当一个智能体完成任务并产生输出时，相关令牌消耗会被记录到本地 BUDGET.json 文件中。随后，由 heartbeat 触发的 budget_audit.py 脚本会定期扫描所有智能体的预算使用情况，依据预设规则判断当前状态属于绿色（正常）、黄色（警告）、红色（严重超限）还是降级（权限剥夺）。特别值得注意的是，系统支持在午夜自动重置每日计数器，且时间可配置以适应不同时区需求。此外，一旦某智能体连续多日超支或单日使用量达到预算的两倍以上，将面临被“降级”处理——即从 openclaw.json 中移除其 subagents.allowAgents 列表，使其无法再自主生成其他子智能体。
核心功能特点
- 为每个智能体设定每日输出令牌预算上限，避免无节制调用外部 API
- 基于使用比例自动分级响应：80% 黄灯警告，100% 红灯警报，200%+ 或连续三天超支则降级
- 午夜自动重置每日计数，支持自定义时区配置
- 降级机制冻结智能体的子代理创建权限，仅允许主调度器手动恢复
- 提供完整的审计日志和机器可读 JSON 输出格式，便于集成监控与告警系统
适用场景
Agent Budget Governance 特别适用于需要协调多个协作型 AI 智能体的复杂项目环境，例如大型自动化工作流平台、分布式任务调度系统或多角色模拟仿真场景。在这些环境中，多个智能体可能并行执行搜索、分析、内容生成等任务，频繁调用第三方 API（如 OpenAI、Claude 或自建模型服务），若缺乏有效控制极易导致成本激增甚至服务中断。通过引入此预算治理机制，团队可以在不牺牲效率的前提下，确保资源分配的公平性与可控性。 另一个典型应用场景是内部研发团队的实验性项目测试阶段。开发者常常会为调试目的临时启用大量智能体进行快速迭代，此时很容易忽略对 token 消耗的实时监控。一旦某个实验性智能体陷入无限循环或错误逻辑，迅速耗尽预算可能导致整个系统瘫痪。Agent Budget Governance 提供的降级与康复机制，既能及时遏制异常行为，又保留了人工干预的可能性，使得开发者在保证安全边界的同时仍能灵活探索创新方案。此外，对于面向客户的产品化多智能体应用而言，该工具还能作为成本核算与计费模块的基础组件，帮助运营方精准追踪各功能模块的实际开销。