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

python3 {baseDir}/scripts/budget.py log --amount 10.00 --merchant "Namecheap" --category "domain" --note "arcself.com registration"

Check balance

python3 {baseDir}/scripts/budget.py balance

View spending summary

python3 {baseDir}/scripts/budget.py summary

View recent transactions

python3 {baseDir}/scripts/budget.py history --limit 10

Set budget limit

python3 {baseDir}/scripts/budget.py set-budget --total 200.00

Set alert threshold (warn when balance drops below this)

python3 {baseDir}/scripts/budget.py set-alert --threshold 50.00

Check if a purchase is safe

python3 {baseDir}/scripts/budget.py check --amount 25.00

Export to CSV

python3 {baseDir}/scripts/budget.py export --format csv

Data Storage

Budget data is stored in ~/.openclaw/budget-tracker/budget.json by default. Override with --data-dir /path/to/dir.

The JSON structure:

{
  "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"
    }
  ]
}

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