LaunchKit · 2026
Back to Skills

openrouter-usage

Fetch real-time OpenRouter usage totals and historical per-model spend.

0
782 downloads
by @rosseyre

Setup & Installation

openclaw skills install @rosseyre/openrouter-usage

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install openrouter-usage

Version History

v1.1.3Feb 12, 2026 - Version note by skill developer:

Minor changes

What This Skill Does

Fetches real-time and historical cost data from the OpenRouter API. Shows today, week, and month spend totals alongside a per-model breakdown of recent activity.

Gives CLI-accessible spend breakdowns without logging into the OpenRouter web dashboard.

When to use it

  • Checking how much you've spent on AI models today
  • Reviewing which models consumed the most budget last week
  • Monitoring monthly spend against your OpenRouter balance
  • Auditing per-model costs before a billing cycle closes
  • Comparing model spend across a recent project

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: How much have I spent on OpenRouter this month and which models cost the most?

AGENT
  1. 1Authenticate with OPENROUTER_API_KEY
  2. 2Fetch live totals from the /auth/key endpoint
  3. 3Fetch per-model activity for the past 7 days from the /activity endpoint using OPENROUTER_MGMT_KEY
  4. 4Rank models by spend
  5. 5Format results into a cost summary
OUTPUT

Today: $0.42 | Week: $3.18 | Month: $11.55 | Balance: $38.45 / $50.00 — Recent Models: gpt-4o: $4.12 (23 requests), claude-3-5-sonnet: $3.91 (18 requests)

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

OPENROUTER_API_KEY from openrouter.aiOPENROUTER_MGMT_KEY from openrouter.ai (optional, enables per-model breakdown)