Files
openclaw-usage-exporter/README.md
T
2026-07-08 21:11:23 +00:00

1.1 KiB

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 0.0.0.0 --port 9487

Runtime

  • Canonical repo path: /root/projects/openclaw-usage-exporter
  • systemd user unit: ~/.config/systemd/user/openclaw-daily-tokens-exporter.service
  • Direct metrics: http://100.74.255.106:9487/metrics
  • Tailscale Serve path: https://luna.taile7522.ts.net/openclaw-daily-tokens

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