← Back to Skills Marketplace
1264
Downloads
1
Stars
3
Active Installs
5
Versions
Install in OpenClaw
/install openrouter-usage
Description
Fetch real-time OpenRouter usage totals and historical per-model spend. Use when the user asks for usage, spend, cost breakdown, or OpenRouter stats. Not for system health or non-LLM metrics.
Usage Guidance
This skill appears to do what it says: it uses OPENROUTER_API_KEY (and optionally OPENROUTER_MGMT_KEY) to call only openrouter.ai endpoints and print usage and model breakdowns. Before installing: (1) confirm you trust the skill owner/source (homepage is absent and owner ID looks unfamiliar); (2) prefer providing keys via environment variables rather than creating a credentials.env file in a shared filesystem; (3) be aware the registry metadata does not list the required env vars or primary credential — ask the publisher to correct that mismatch; (4) you can review scripts/stats.py yourself (it's small and readable) or run it in an isolated environment if you want to limit risk.
Capability Analysis
Type: OpenClaw Skill
Name: openrouter-usage
Version: 1.1.3
The skill is designed to fetch OpenRouter usage data, which it does by making authenticated API calls to `openrouter.ai`. It loads API keys from environment variables (recommended) or a `credentials.env` file as a fallback. While using a `credentials.env` file is a less secure practice for handling secrets compared to environment variables, it is explicitly documented and not indicative of malicious intent. The `SKILL.md` instructions are clear and directly relate to the skill's stated purpose, without any prompt injection attempts to subvert the agent. The Python script performs its function transparently, without unauthorized file access, network communication to external domains, or system modifications.
Capability Assessment
Purpose & Capability
The skill claims to fetch OpenRouter usage and per-model spend and the included script calls only openrouter.ai endpoints (/auth/key, /credits, /activity). However, registry metadata lists no required environment variables or primary credential while SKILL.md and the script do require OPENROUTER_API_KEY (and optionally OPENROUTER_MGMT_KEY). This mismatch is a metadata inconsistency (not functional misbehavior).
Instruction Scope
Runtime instructions and the Python script are narrowly scoped: they load credentials from environment or a credentials.env file in the skill directory, call OpenRouter endpoints, aggregate and print results. The instructions do not request unrelated files, system state, or external endpoints beyond openrouter.ai.
Install Mechanism
No install spec (instruction-only + a small script). Nothing is downloaded or written by an installer; risk from installation is low. The script may read credentials.env in the skill directory if present.
Credentials
The only secrets requested are OPENROUTER_API_KEY (required) and OPENROUTER_MGMT_KEY (optional) which are proportional to the stated functionality. Note: the registry metadata did not declare these required env vars or primary credential, while SKILL.md and the script do — this inconsistency should be resolved. The skill suggests storing keys in a credentials.env file in the skill directory (convenient but less secure than environment variables).
Persistence & Privilege
The skill does not request persistent system privileges, does not set always:true, and does not modify other skills or system-wide configs. It only reads a credentials.env file in its own directory (if present).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openrouter-usage - After installation, invoke the skill by name or use
/openrouter-usage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.3
Minor changes
v1.1.2
Align metadata with var requirements.
v1.1.1
Updated metadata to align with env var requirements
v1.1.0
Version 1.1 adds credential file support and clarifies environment variable configuration.
- Added support for providing credentials via a credentials.env file in the skill directory as an alternative to environment variables.
- Updated documentation to better explain required and optional environment variables and credential delivery methods.
- No code changes made; SKILL.md improvements only.
v1.0.0
Initial release of OpenRouter Usage Monitor.
- Fetches real-time usage totals (daily, weekly, monthly) via OpenRouter's API endpoints.
- Provides historical per-model spend breakdown for completed UTC days.
- Supports both Python (primary) and Bash (curl/jq) usage.
- Requires API key (OPENROUTER_API_KEY); optional management key for detailed stats.
- Handles authentication errors, rate limits, and network failures.
- Designed for easy setup and secure configuration management.
Metadata
Frequently Asked Questions
What is OpenRouter Usage?
Fetch real-time OpenRouter usage totals and historical per-model spend. Use when the user asks for usage, spend, cost breakdown, or OpenRouter stats. Not for system health or non-LLM metrics. It is an AI Agent Skill for Claude Code / OpenClaw, with 1264 downloads so far.
How do I install OpenRouter Usage?
Run "/install openrouter-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenRouter Usage free?
Yes, OpenRouter Usage is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OpenRouter Usage support?
OpenRouter Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenRouter Usage?
It is built and maintained by rosseyre (@rosseyre); the current version is v1.1.3.
More Skills