# 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

```bash
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