Agent Budget Governance

为多智能体系统提供API令牌预算管控，核心功能包括每日额度分配、自动重置，设置80%（黄警）、100%（红警）、200%+或3天超支（降级）的多阈值机制，支持审计日志、权限回收及康复流程。适用于多智能体共享API预算、需防控超支的场景。通过BUDGET.json配置额度，可运行脚本完成审计、重置，输出日志、告警或机器可读JSON结果。

nissan

热度 67.62

最近更新 2026-05-11 17:29:14

分类：自动化依赖：代码执行 / 读写文件应用场景：财务 / 自动化脚本 / 报告撰写 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agent-budget-governance

Metadata

name: agent-budget-governance
version: 1.0.0
description: Trust-based budget system for multi-agent teams — daily token limits with automatic midnight resets, yellow/red/demotion thresholds, audit logging, and mesh privilege revocation. Use when running multiple AI agents that share API budgets and need spend controls. Works with any OpenClaw multi-agent setup.
metadata: {"openclaw":{"emoji":"💰","requires":{"bins":["python3"],"env":[]},"primaryEnv":null,"network":{"outbound":false,"reason":"Local file operations only. Reads agent BUDGET.json files and writes governance logs."}}}

Agent Budget Governance

Prevent runaway API spending in multi-agent systems. Each agent gets a daily output token budget. Exceed it and you get warnings. Keep exceeding it and you lose mesh spawn privileges.

How It Works

Agent completes task → tokens logged to BUDGET.json
                          ↓
Heartbeat runs budget_audit.py
                          ↓
├── Under 80%: ✅ Green — business as usual
├── 80-100%: 🟡 Yellow — warning logged
├── 100-200%: 🔴 Red — alert to orchestrator
└── 200%+ or 3 consecutive days over: ⛔ Demotion — mesh privileges revoked

Budget File Format

Each agent has agents/<name>/BUDGET.json:

{
  "daily_limit": 50000,
  "today": "2026-03-01",
  "used_today": 23450,
  "consecutive_over_days": 0,
  "demoted": false
}

Running the Audit

python3 scripts/budget_audit.py          # Full audit with alerts
python3 scripts/budget_audit.py --json   # Machine-readable output
python3 scripts/budget_audit.py --reset-only  # Just reset daily counters

Governance Rules

Daily reset at midnight (configurable timezone)
Yellow at 80% — logged, no action
Red at 100% — logged, orchestrator alerted
Demotion at 200% OR 3 consecutive days over budget
Rehabilitation — demoted agent must go 7 clean days, then orchestrator manually restores privileges

Demotion Mechanics

Demotion removes an agent's subagents.allowAgents list in openclaw.json, preventing them from spawning other agents. They can still be spawned by the orchestrator.

Files

scripts/budget_audit.py — Audit script (run from heartbeat or cron)
references/GOVERNANCE.md — Full governance framework documentation