AI Usage

Check AI token usage, quotas, and costs across Anthropic and other providers using Anthropic OAuth API and OpenClaw session logs.

AI Usage Check

Quick Start

python3 scripts/usage_check.py           # Pretty report with gauges
python3 scripts/usage_check.py --json    # JSON output for scripting

Requirements

• Python 3.10+ (no pip dependencies — stdlib only)
• Claude Code installed and authenticated (claude CLI in PATH) — for Anthropic quota
• OpenClaw installed — for session log token/cost stats

What It Shows

Anthropic (real quota from OAuth API):

• Weekly utilization % with reset countdown
• 5-hour rolling window %
• Model-specific weekly (Sonnet, Opus) when available
• Extra usage spend vs monthly limit

Other Providers (from OpenClaw session logs):

• Token counts and call counts per model
• Auto-detects any provider OpenClaw routes through (Ollama, OpenAI, etc.)

OpenClaw Anthropic breakdown:

• Per-model token counts and equivalent API cost

How It Works

• Anthropic quota: GET https://api.anthropic.com/api/oauth/usage using Claude Code's OAuth token from ~/.claude/.credentials.json (requires user:profile scope)
• Token auto-refresh: If the token is expired, the script automatically refreshes it by invoking claude --print -p "ok" (Claude Code refreshes its own OAuth token on any invocation), then re-reads the updated credentials file. If Claude Code isn't installed, Anthropic quota is skipped gracefully.
• Session stats: Parses ~/.openclaw/agents/main/sessions/*.jsonl for per-provider/model token and cost data

Environment Variables

Variable	Default	Description
OPENCLAW_SESSIONS_DIR	~/.openclaw/agents/main/sessions	OpenClaw session log directory
CLAUDE_CREDENTIALS_PATH	~/.claude/.credentials.json	Claude Code credentials file

Tips

• Run via Haiku or a lightweight model for heartbeat/background checks — the script just needs to execute, no reasoning required
• Use --json for programmatic consumption (cron jobs, dashboards, alerts)
• Works with any Anthropic subscription tier (Pro, Max, Team, etc.)