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

40 lines
1.1 KiB
Markdown

# 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 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