Agent Cost Dashboard

Real-time cost and performance tracking across all OpenClaw sessions and agents.

Commands

Run via: python3 scripts/agent-cost-dashboard.py [options]

Commands

• summary — Current cost summary (today, this week, this month)
• agents — Cost breakdown by agent/session
• models — Cost breakdown by model with efficiency scores
• budget — Check budget thresholds and alert status
• optimize — Model optimization recommendations
• export — Export cost data for finance teams (CSV/JSON)
• track — Record a cost event manually
• reset — Reset tracking for current period

Options

• --workspace PATH — Workspace path (default: auto-detect)
• --format text|json|csv — Output format (default: text)
• --period today|week|month|all — Time period (default: today)
• --budget-daily AMOUNT — Daily budget in USD (default: $5)
• --budget-monthly AMOUNT — Monthly budget in USD (default: $180)
• --output PATH — Save export to file

Pricing Reference

See references/model-pricing.md for current API pricing used in cost calculations.

Integration

Reads OpenClaw session_status data and cron run logs. Works alongside claw-api-manager for budget enforcement.