openrouter-usage 是一个用于追踪 OpenRouter API 花费的工具，可直接在 OpenClaw 智能体中使用。它能够显示信用余额、按模型划分的成本与 token 明细，以及基于 OpenClaw 会话日志的花费预测。
用途
该工具用于追踪 OpenRouter 的 API 花费，帮助用户了解信用余额、各模型的成本与 token 消耗情况，并基于 OpenClaw 会话日志生成花费预测。
触发条件
当用户询问 OpenRouter 信用、成本、花费、余额、用量、账单，或使用 /usage 命令时触发。
主要能力与命令
完整报告（推荐，组合所有信息）：
openrouter-usage report # 信用余额 + 当日用量 + 预测 openrouter-usage report --week # 信用余额 + 最近 7 天 openrouter-usage report --month # 信用余额 + 最近 30 天
仅查询信用余额：
openrouter-usage credits
仅查询按模型明细：
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
筛选与输出：
openrouter-usage report --agent main # 仅限特定智能体 openrouter-usage report --format json # JSON 输出 openrouter-usage sessions --today --utc # 使用 UTC 而非本地时区
使用方式与说明
API 密钥自动从 OpenClaw 认证存储或 OPENROUTER_API_KEY 环境变量中发现。
会话解析完全在本地进行，读取 ~/.openclaw/agents//sessions/.jsonl。
日期筛选默认使用本地时区，可通过 --utc 覆盖。
除 Python 3 标准库外无其他依赖。
适用场景
适用于需要监控 OpenRouter API 花费、查看信用余额、分析各模型成本与 token 用量、按时间范围或特定智能体筛选用量，以及生成花费预测的场景。
限制
资料未提供关于收费、价格、平台支持范围、具体效果或额外使用步骤的更多信息。