Agent Skills
› NeverSight/learn-skills.dev
› openrouter-usage
openrouter-usage
GitHub从OpenClaw会话日志中追踪OpenRouter API支出，包括信用余额、按模型的成本分解及支出预测。支持查看余额、日报/周报/月报及自定义时间段的详细会话数据。
Trigger Scenarios
用户询问OpenRouter信用、成本、支出、余额或使用情况
用户执行/usage命令
Install
npx skills add NeverSight/learn-skills.dev --skill openrouter-usage -g -y
SKILL.md
Frontmatter
{
"name": "openrouter-usage",
"metadata": {
"openclaw": {
"emoji": "💰",
"requires": {
"bins": [
"openrouter-usage"
]
}
}
},
"description": "Track OpenRouter API spending — credit balance, per-model cost breakdown, and spending projections from OpenClaw session logs."
}
openrouter-usage
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)
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
openrouter-usage credits
Per-model breakdown only
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
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_KEYenv var. - Session parsing is fully local — reads
~/.openclaw/agents/*/sessions/*.jsonl. - Date filters use local timezone by default. Pass
--utcto override. - Zero dependencies beyond Python 3 stdlib.
Version History
- e0220ca Current 2026-07-05 21:44
