Agent Skills
› openclaw/openclaw
› model-usage
model-usage
GitHub用于汇总 CodexBar 本地成本日志中按模型（Codex 或 Claude）划分的费用。支持当前模型或全量摘要，可输出文本或 JSON 格式，适用于监控和审计 AI 使用成本。
触发场景
查询 AI 模型使用成本
分析 CodexBar 费用日志
安装
npx skills add openclaw/openclaw --skill model-usage -g -y
SKILL.md
Frontmatter
{
"name": "model-usage",
"metadata": {
"openclaw": {
"os": [
"darwin",
"linux"
],
"emoji": "📊",
"install": [
{
"id": "brew-cask",
"bins": [
"codexbar"
],
"kind": "brew",
"label": "Install CodexBar CLI (Homebrew)",
"formula": "steipete\/tap\/codexbar"
}
],
"requires": {
"bins": [
"codexbar"
]
}
}
},
"description": "Summarize CodexBar local cost logs by model for Codex or Claude, including current or full breakdowns."
}
Model usage
Overview
Get per-model usage cost from CodexBar's local cost logs. Supports "current model" (most recent daily entry) or "all models" summaries for Codex or Claude.
CodexBar ships CLI builds for macOS and Linux. When codexbar is on PATH, the skill reads local usage directly; the bundled Python summarizer also accepts exported CodexBar JSON through --input anywhere Python is available.
Quick start
- Fetch cost JSON via CodexBar CLI or pass a JSON file.
- Use the bundled script to summarize by model.
python {baseDir}/scripts/model_usage.py --provider codex --mode current
python {baseDir}/scripts/model_usage.py --provider codex --mode all
python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty
Current model logic
- Uses the most recent daily row with
modelBreakdowns. - Picks the model with the highest cost in that row.
- Falls back to the last entry in
modelsUsedwhen breakdowns are missing. - Override with
--model <name>when you need a specific model.
Inputs
- Default: runs
codexbar cost --format json --provider <codex|claude>. - macOS and Linux: use the bundled Homebrew formula installer above for live local usage reads. Linux users can also use CodexBar's AUR package or official release tarballs.
- Other platforms: use
--inputwith exported CodexBar JSON. - File or stdin:
codexbar cost --provider codex --format json > /tmp/cost.json
python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current
Output
- Text (default) or JSON (
--format json --pretty). - Values are cost-only per model; tokens are not split by model in CodexBar output.
References
- Read
references/codexbar-cli.mdfor CLI flags and cost JSON fields.
版本历史
- 3374458 当前 2026-08-20 13:32
