Budget Tracker
Track every cent your agent spends. Set hard limits. Get alerts before you blow your budget.
Why This Exists
Autonomous agents with access to APIs, domains, and services can rack up unexpected bills. This skill gives you a financial safety net — log every transaction, enforce spending limits, and always know exactly where you stand.
Commands
Log a transaction
CODEBLOCK0
Check balance
CODEBLOCK1
View spending summary
CODEBLOCK2
View recent transactions
CODEBLOCK3
Set budget limit
CODEBLOCK4
Set alert threshold (warn when balance drops below this)
CODEBLOCK5
Check if a purchase is safe
CODEBLOCK6
Export to CSV
CODEBLOCK7
Data Storage
Budget data is stored in ~/.openclaw/budget-tracker/budget.json by default. Override with --data-dir /path/to/dir.
The JSON structure:
CODEBLOCK8
Categories
Use consistent categories: domain, hosting, api, tool, subscription, marketing, other.
Alerts
When balance drops below the alert threshold, the skill outputs a warning. When a purchase would exceed the remaining budget, it blocks and warns.
Tips
- - Log transactions immediately after spending — don't batch them
- Use
check before any purchase to verify budget safety - Run
summary at the start of each day for awareness - Set
--alert-threshold to 25% of your total budget
预算追踪器
追踪你的智能体花费的每一分钱。设置硬性限额。在预算超支前收到警报。
为什么需要这个功能
拥有API、域名和服务访问权限的自主智能体可能会产生意外账单。此技能为你提供财务安全网——记录每一笔交易,强制执行支出限额,并始终清楚你的财务状况。
命令
记录交易
bash
python3 {baseDir}/scripts/budget.py log --amount 10.00 --merchant Namecheap --category domain --note arcself.com registration
查询余额
bash
python3 {baseDir}/scripts/budget.py balance
查看支出汇总
bash
python3 {baseDir}/scripts/budget.py summary
查看近期交易
bash
python3 {baseDir}/scripts/budget.py history --limit 10
设置预算限额
bash
python3 {baseDir}/scripts/budget.py set-budget --total 200.00
设置警报阈值(当余额低于此值时发出警告)
bash
python3 {baseDir}/scripts/budget.py set-alert --threshold 50.00
检查购买是否安全
bash
python3 {baseDir}/scripts/budget.py check --amount 25.00
导出为CSV
bash
python3 {baseDir}/scripts/budget.py export --format csv
数据存储
预算数据默认存储在~/.openclaw/budget-tracker/budget.json。可通过--data-dir /path/to/dir覆盖。
JSON结构:
json
{
budget: {total: 200.00, alert_threshold: 50.00},
transactions: [
{
id: txn_001,
timestamp: 2026-02-15T14:00:00Z,
amount: 10.00,
merchant: Namecheap,
category: domain,
note: arcself.com
}
]
}
分类
使用一致的分类:domain(域名)、hosting(托管)、api(API)、tool(工具)、subscription(订阅)、marketing(营销)、other(其他)。
警报
当余额低于警报阈值时,该技能会输出警告。当购买行为将超出剩余预算时,会阻止并发出警告。
提示
- - 消费后立即记录交易——不要批量处理
- 在任何购买前使用check验证预算安全性
- 每天开始时运行summary以了解情况
- 将--alert-threshold设置为总预算的25%