openclaw-usage-exporter/README.md

openclaw-daily-tokens-exporter

Tiny FastAPI Prometheus exporter for OpenClaw daily token totals.

What it exports

Reads OpenClaw session JSONL files and exposes today's totals at /metrics:

• openclaw_daily_total_tokens
• openclaw_daily_input_tokens
• openclaw_daily_output_tokens
• openclaw_daily_cache_read_tokens
• openclaw_daily_cache_write_tokens
• openclaw_daily_reasoning_tokens
• openclaw_daily_usage_entries

Timezone defaults to Europe/Berlin.

Run locally

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
uvicorn app:app --host 127.0.0.1 --port 9487

Env

• OPENCLAW_SESSIONS_DIR default: /root/.openclaw/agents/main/sessions
• OPENCLAW_EXPORTER_TZ default: Europe/Berlin
• PORT ignored by app directly; set it in the service/uvicorn command