agent-budget-controller
by chloepark85
Control LLM API spending per agent. Set daily/weekly/monthly limits with real-time tracking and alerts.
安装
claude skill add --url github.com/openclaw/skills/tree/main/skills/chloepark85/agent-budget-controller必需命令行工具
uvpython3文档
Agent Budget Controller
💰 Stop LLM cost overruns before they happen
Track, limit, and alert on LLM API costs per agent with daily/weekly/monthly budgets.
What It Does
- Set budget limits — Global or per-agent, daily/weekly/monthly
- Track usage — Automatic cost calculation for 10+ LLM models
- Alert on thresholds — 70% warning, 90% critical, 100% blocked
- Generate reports — Usage summaries and cost breakdowns
- Zero dependencies — Pure Python stdlib, local-only
Quick Start
# Initialize
budget init
# Set limits
budget set --daily 3.00 --weekly 15.00 --monthly 50.00
budget set --agent ubik-pm --daily 1.00
# Log usage (manual - see Integration below)
budget log --agent ubik-pm --model "claude-sonnet-4-5" \
--input-tokens 5000 --output-tokens 1500
# Check status
budget status
budget status --agent ubik-pm
# Check limits (exit code)
budget check # exit 0=ok, 1=exceeded
Commands
| Command | Purpose |
|---|---|
init | Initialize budget tracking |
set | Set budget limits |
log | Log API usage |
status | Show current usage vs limits |
check | Check if limits exceeded (exit code) |
report | Generate detailed period report |
agents | List agents with limits or activity |
pricing | Show/update model pricing |
history | Show recent usage history |
Supported Models
Built-in pricing for:
- OpenAI: gpt-4o, gpt-4o-mini, o1, o1-mini
- Anthropic: claude-sonnet-4-5, claude-opus-4, claude-haiku-3.5
- Google: gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash
Custom models:
budget pricing --update --model my-model \
--input-price 1.50 --output-price 5.00
Integration
OpenClaw Heartbeat
Add to HEARTBEAT.md:
## Budget Monitoring
Every 4 hours:
1. Check budget status: `budget status`
2. If any agent >90%, notify Director
3. If any exceeded, escalate immediately
Pre-call Hook (Future)
# In agent wrapper script
budget check --agent $AGENT_NAME || {
echo "❌ Budget exceeded for $AGENT_NAME"
exit 1
}
# Call LLM API...
# Log after call
budget log --agent $AGENT_NAME \
--model "$MODEL" \
--input-tokens $INPUT_TOKENS \
--output-tokens $OUTPUT_TOKENS
Cron (Daily Report)
# Send daily report to Telegram
0 9 * * * budget report --period day | \
openclaw msg --channel telegram --target @director
Alert Levels
| Usage | Level | Symbol | Action |
|---|---|---|---|
| <70% | OK | ✅ | Continue |
| 70-89% | Warning | ⚠️ | Monitor |
| 90-99% | Critical | 🔴 | Alert Director |
| ≥100% | Exceeded | 🚫 | Block calls |
Data Storage
~/.openclaw/budget/
├── config.json # Budget limits
├── pricing.json # Model pricing (optional override)
└── usage.jsonl # Append-only usage log
Privacy: All data stored locally. No network calls.
Examples
See EXAMPLE.md for complete usage scenarios.
Testing
cd ~/ubik-collective/systems/ubik-pm/skills/agent-budget-controller
python3 tests/test_budget.py
Security
- ✅ Zero external dependencies
- ✅ No network calls
- ✅ Local-only data storage
- ✅ Pure Python stdlib
Safe for ClawHub distribution.
License
MIT-0 (public domain equivalent)
相关 Skills
Claude接口
by anthropics
面向接入 Claude API、Anthropic SDK 或 Agent SDK 的开发场景，自动识别项目语言并给出对应示例与默认配置，快速搭建 LLM 应用。
✎ 想把Claude能力接进应用或智能体，用claude-api上手快、兼容Anthropic与Agent SDK，集成路径清晰又省心
提示工程专家
by alirezarezvani
覆盖Prompt优化、Few-shot设计、结构化输出、RAG评测与Agent工作流编排，适合分析token成本、评估LLM输出质量，并搭建可落地的AI智能体系统。
✎ 把提示优化、LLM评测到RAG与智能体设计串成一套方法，适合想系统提升AI开发效率的人。
智能体流程设计
by alirezarezvani
面向生产级多 Agent 编排，梳理顺序、并行、分层、事件驱动、共识五种工作流设计，覆盖 handoff、状态管理、容错重试、上下文预算与成本优化，适合搭建复杂 AI 协作系统。
✎ 帮你把多智能体流程设计、编排和自动化统一起来，复杂工作流也能更稳地落地，适合追求强控制力的团队。
相关 MCP 服务
顺序思维
编辑精选by Anthropic
Sequential Thinking 是让 AI 通过动态思维链解决复杂问题的参考服务器。
✎ 这个服务器展示了如何让 Claude 像人类一样逐步推理，适合开发者学习 MCP 的思维链实现。但注意它只是个参考示例，别指望直接用在生产环境里。
知识图谱记忆
编辑精选by Anthropic
Memory 是一个基于本地知识图谱的持久化记忆系统，让 AI 记住长期上下文。
✎ 帮 AI 和智能体补上“记不住”的短板，用本地知识图谱沉淀长期上下文，连续对话更聪明，数据也更可控。
PraisonAI
编辑精选by mervinpraison
PraisonAI 是一个支持自反思和多 LLM 的低代码 AI 智能体框架。
✎ 如果你需要快速搭建一个能 24/7 运行的 AI 智能体团队来处理复杂任务（比如自动研究或代码生成），PraisonAI 的低代码设计和多平台集成（如 Telegram）让它上手极快。但作为非官方项目，它的生态成熟度可能不如 LangChain 等主流框架，适合愿意尝鲜的开发者。