Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Pulls usage and billing data from OpenRouter via its API. Covers account-level credit tracking, per-key consumption reporting, and request-level debugging by generation ID. Two API key types control access: a Management key for aggregate data, a standard API key for individual request logs.
Combines account-level management reporting and per-request debug detail in one CLI tool, replacing manual API calls or navigating the OpenRouter dashboard.
When to use it
- Reviewing daily OpenRouter spend over a custom date range
- Identifying which API keys are consuming the most credits
- Debugging a slow or failed request using its generation ID
- Exporting monthly usage data to CSV for billing review
- Checking remaining credits before hitting a spending limit
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Which of my API keys spent the most on OpenRouter last month?
- 1Run `activity --from 2026-02-01 --to 2026-02-28 --summary` to get overall spend for the period
- 2Run `keys --limit 50 --summary` to list per-key usage and identify top consumers
- 3Run `report --from 2026-02-01 --to 2026-02-28 --format markdown` to generate a formatted summary
A ranked breakdown of API keys with spend and request counts for the specified month
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.