| name | openclaw-usage-dashboard |
| description | Generate an interactive local HTML dashboard showing OpenClaw API usage, costs, and rate-limit quotas across multiple LLM providers (Anthropic, OpenAI, Google, Moonshot, Mistral, Cohere, Groq). Reads session transcripts directly — no external service needed. Use when a user asks about API costs, token usage, model spend, quota/rate limits, usage by model or time period, or wants a cost overview dashboard. Triggers on "usage dashboard", "API kosten", "wie viel kostet", "kontingent", "rate limit", "token verbrauch", "cost dashboard", "openclaw costs", "spending overview". |
OpenClaw Usage Dashboard
Generate a self-contained HTML dashboard from OpenClaw session transcripts. Zero dependencies — Python 3.8+ stdlib only.
Usage
python3 scripts/usage-dashboard-generic.py [output.html]
python3 scripts/usage-dashboard-generic.py [output.html] --demo
Default output: ~/openclaw-usage-dashboard.html
Override sessions path: set OPENCLAW_ROOT env var.
What It Shows
- Cost KPIs: Total spend, today's cost, API calls, active model, cache hit rate, monthly projection
- Model config: Active / default / fallback models from
openclaw.json
- Anthropic quota gauges: 5h and 7d rate limit utilization (requires
ANTHROPIC_API_KEY)
- Donut chart: Cost distribution by model
- Hourly sparkline: Today's call volume by hour
- Stacked bars: Cost by period (daily / weekly / monthly / yearly)
- Model table: Per-model breakdown with token counts and cost
- Detail table + chart: Toggle between table and bar chart view per period
- Budget tracker: Set monthly limit, progress bar, localStorage persistence
- CSV export: Download any period view as CSV
- Provider dropdown: Filter by provider
Supported Providers
Anthropic, OpenAI, Google, Moonshot/Kimi, Mistral, Cohere, Groq — 30+ models with built-in pricing.
Customization
Add models
Edit PRICES dict in the script (price per 1M tokens):
"provider/model-name": {"input": 2.50, "output": 10.00, "cache_read": 1.25, "cache_write": 2.50}
Add to MODEL_COLORS and ALIAS_MAP as needed.
Pricing reference
See references/prices.md for current prices across all providers.
Requirements
- Python 3.8+ (stdlib only)
ANTHROPIC_API_KEY in env (optional, for live quota gauges)
