FlowClaw — LLM Usage Monitor & Load Balancer

Track usage. Balance routing. Never waste a credit.

Unified dashboard + auto-routing for all your LLM subscriptions. Uses Earliest Deadline First scheduling — accounts resetting soonest are prioritized so unused credits aren't wasted.

Supported Providers

| Provider | Auth | Data Source | |----------|------|------------| | Anthropic Claude Max | OAuth (unlimited accounts) | api.anthropic.com/api/oauth/usage | | Google Gemini CLI | OAuth via OpenClaw | cloudcode-pa.googleapis.com | | Google Antigravity | codexbar | codexbar usage API | | OpenAI Codex | OAuth via OpenClaw | chatgpt.com/backend-api/wham/usage | | GitHub Copilot | OAuth via OpenClaw | api.github.com/copilot_internal/user | | Ollama | Local (auto-detected) | localhost:11434/api/tags |

Commands

# 📊 Usage Monitoring
flowclaw status [--fresh] [--json]     # Full provider dashboard
flowclaw monitor [--json] [--cached]   # Clean usage report (no scoring)

# 🧠 Load Balancing
flowclaw score [--json]                # Scored ranking of all accounts
flowclaw optimize [--dry-run]          # Reorder OpenClaw model priority
flowclaw auto                          # Optimize silently (for cron jobs)

# 🛠 Utilities
flowclaw test                          # Run scoring engine unit tests
flowclaw history [N]                   # Routing decision history

Setup

Anthropic (Claude Max) — unlimited accounts

claude login
bash {baseDir}/scripts/save-account.sh
# Repeat for each account

Google Gemini CLI

openclaw models auth login --provider google-gemini-cli

Google Antigravity

openclaw models auth login --provider google-antigravity
brew install --cask steipete/tap/codexbar   # Required for usage metrics

OpenAI Codex

openclaw models auth login --provider openai-codex

GitHub Copilot

openclaw models auth login-github-copilot

Ollama

brew install ollama && ollama pull qwen3:235b
# Auto-detected — no config needed

Cron Automation

# Optimize routing every 30 minutes
*/30 * * * * bash ~/clawd/skills/flowclaw/scripts/flowclaw.sh auto

Scoring Algorithm

score = urgency(0.30) + availability(0.25) + proximity(0.15) + weekly_headroom(0.20) + tier(0.10)

| Factor | Formula | Measures | |--------|---------|----------| | Urgency | remaining / hours_to_reset | Credits wasting per hour | | Availability | √(remaining) | Dampened capacity | | Proximity | 1 - (hours / window) | Deadline pressure | | Weekly headroom | (100 - weekly%) / 100 | 7-day capacity reserve | | Tier bonus | Free=+0.8, Sub=0, Local=-0.3 | Cost preference |

Perishable inventory: Both 5h session and 7d weekly windows expire. When ≤6h to weekly reset, penalty is removed — burn remaining credits. Family-aware: Only swaps within same capability class (Opus↔Opus, not Opus↔Gemini).