openrouter-usage
Track OpenRouter API spending — credit balance, per-model cost breakdown, and spending projections from OpenClaw session logs.
Best use case
openrouter-usage is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Track OpenRouter API spending — credit balance, per-model cost breakdown, and spending projections from OpenClaw session logs.
Teams using openrouter-usage should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/openrouter-usage/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How openrouter-usage Compares
| Feature / Agent | openrouter-usage | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Track OpenRouter API spending — credit balance, per-model cost breakdown, and spending projections from OpenClaw session logs.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# openrouter-usage - Author: Daniel Li - Copyright © Daniel Li. All rights reserved. Track your OpenRouter spending directly from your OpenClaw agent. Shows credit balance, per-model cost/token breakdown, and spending projections. ## Trigger Use when the user asks about OpenRouter credits, costs, spending, balance, usage, billing, or the `/usage` command. ## Commands ### Full report (recommended — combines everything) ```bash openrouter-usage report # credits + today's usage + projection openrouter-usage report --week # credits + last 7 days openrouter-usage report --month # credits + last 30 days ``` ### Credit balance only ```bash openrouter-usage credits ``` ### Per-model breakdown only ```bash openrouter-usage sessions --today openrouter-usage sessions --week openrouter-usage sessions --month openrouter-usage sessions --date 2026-02-25 openrouter-usage sessions --from 2026-02-01 --to 2026-02-15 ``` ### Filtering and output ```bash openrouter-usage report --agent main # specific agent only openrouter-usage report --format json # JSON output openrouter-usage sessions --today --utc # use UTC instead of local timezone ``` ## Notes - API key auto-discovered from OpenClaw auth store or `OPENROUTER_API_KEY` env var. - Session parsing is fully local — reads `~/.openclaw/agents/*/sessions/*.jsonl`. - Date filters use local timezone by default. Pass `--utc` to override. - Zero dependencies beyond Python 3 stdlib.
Related Skills
model-usage
Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
model-usage-linux
Track OpenClaw AI token usage and cost per model on Linux by parsing session JSONL files. Use when asked about: token usage, API cost, how much has been spent, which model was used most, usage summary, billing, cost breakdown. Linux replacement for the macOS-only model-usage/CodexBar skill.
wemp-operator
> 微信公众号全功能运营——草稿/发布/评论/用户/素材/群发/统计/菜单/二维码 API 封装
zsxq-smart-publish
Publish and manage content on 知识星球 (zsxq.com). Supports talk posts, Q&A, long articles, file sharing, digest/bookmark, homework tasks, and tag management. Use when publishing content to 知识星球, creating/editing posts, uploading files/images/audio, managing digests, batch publishing, or formatting content for 知识星球.
zoom-automation
Automate Zoom meeting creation, management, recordings, webinars, and participant tracking via Rube MCP (Composio). Always search tools first for current schemas.
zoho-crm-automation
Automate Zoho CRM tasks via Rube MCP (Composio): create/update records, search contacts, manage leads, and convert leads. Always search tools first for current schemas.
ziliu-publisher
字流(Ziliu) - AI驱动的多平台内容分发工具。用于一次创作、智能适配排版、一键分发到16+平台（公众号/知乎/小红书/B站/抖音/微博/X等）。当用户需要多平台发布、内容排版、格式适配时使用。触发词：字流、ziliu、多平台发布、一键分发、内容分发、排版发布。
zhihu-post-skill
> 知乎文章发布——知乎平台内容创作与发布自动化
zendesk-automation
Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.
youtube-knowledge-extractor
This skill performs deep analysis of YouTube videos through **both information channels** Multimodal YouTube video analysis through both audio (transcript) and visual (frame extraction + image analysis) channels. Especially powerful for HowTo videos, tutorials, demos, and explainer videos where what is SHOWN (screenshots, UI demos, diagrams, code, physical actions) is just as important as what is SAID. Use this skill whenever a user wants to analyze, summarize, or create step-by-step guides from YouTube videos, or when they share a YouTube URL and want to understand what happens in the video. Triggers on requests like "Analyze this YouTube video", "Create a step-by-step guide from this video", "What does this video show?", "Summarize this tutorial", or any YouTube URL shared with analysis intent.
youtube-factory
Generate complete YouTube videos from a single prompt - script, voiceover, stock footage, captions, thumbnail. Self-contained, no external modules. 100% free tools.
youtube-automation
Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.