Openrouter Analytics OpenClaw Plugin & Skill | ClawHub
Looking to integrate Openrouter Analytics into your AI workflows? This free OpenClaw plugin from ClawHub helps you automate coding agents & ides tasks instantly, without having to write custom tools from scratch.
What this skill does
Review OpenRouter usage, analytics, and troubleshooting data via API. Use when the user asks for spend/usage monitoring, activity trends, per-key management reporting, or deep investigation of specific request IDs (latency, provider fallback, finish reason, token/cost breakdown).
Install
openclaw skills install @plgonzalezrx8/openrouter-analyticsnpx clawhub@latest install openrouter-analyticsFull SKILL.md
Open original| name | description |
|---|---|
| openrouter-analytics | Review OpenRouter usage, analytics, and troubleshooting data via API. Use when the user asks for spend/usage monitoring, activity trends, per-key management reporting, or deep investigation of specific request IDs (latency, provider fallback, finish reason, token/cost breakdown). |
SKILL.md content below is scrollable.
OpenRouter Analytics
Use this skill to pull management-level usage data and request-level troubleshooting details from OpenRouter.
Quick Start
Run from this skill folder:
cd ~/clawd/skills/openrouter-analytics
Management key operations (set OPENROUTER_MANAGEMENT_KEY):
python3 scripts/openrouter_analytics.py activity --limit 20
python3 scripts/openrouter_analytics.py activity --date 2026-02-18
python3 scripts/openrouter_analytics.py activity --from 2026-02-01 --to 2026-02-18 --summary --csv /tmp/activity.csv
python3 scripts/openrouter_analytics.py credits
python3 scripts/openrouter_analytics.py keys --limit 50 --summary
python3 scripts/openrouter_analytics.py report --from 2026-02-01 --to 2026-02-18 --format markdown
Request-level troubleshooting (set OPENROUTER_API_KEY):
python3 scripts/openrouter_analytics.py generation --id <generation_id>
Use --raw on any command to print full JSON.
Workflow
- Check macro activity
- Run
activityfor daily spend/traffic patterns.
- Run
- Check account-level usage
- Run
creditsto review consumed vs remaining credits.
- Run
- Find key-level consumers
- Run
keysto identify which keys are driving usage.
- Run
- Investigate incidents
- Run
generation --id ...for detailed logs on one request (latency, fallback providers, finish reason, token and cost details).
- Run
Notes
activity,credits,keys, andreportrequire a Management API key.generationuses a standard OpenRouter API key and requires the requestid.- The script auto-loads
~/.openclaw/.envand current-directory.envbefore execution. - Use
--retriesand--timeoutto tune robustness under transient API/network issues. - Keep generation IDs in your application logs to support reliable post-incident analysis.
Resources
- Endpoint reference and field guide:
references/endpoints.md - CLI helper script:
scripts/openrouter_analytics.py