下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/model-usage

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install model-usage

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 model-usage。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 模型使用情况？

model-usage 技能是一个专门的实用工具，旨在填补原始 CodexBar 成本日志与可操作的各模型财务洞察之间的空白。通过利用 Openclaw Skills 框架，开发人员可以以编程方式提取 Codex 和 Claude 等供应商的每日使用量或累计模型分类，从而实现更严格的预算管理和资源分配。此技能确保 Openclaw Skills 用户能够完全透明地了解哪些模型正在驱动其开发成本。

模型使用情况 应用场景

• 跟踪 GPT-4 或 Claude 3.5 Sonnet 等特定 LLM 模型的每日支出。
• 在多模型开发工作流中识别最昂贵的模型。
• 将成本数据导出为 JSON，以便集成到自定义报告仪表板中。
• 通过 Openclaw Skills 生态系统中的可脚本化 CLI 命令审计 AI 使用情况。

模型使用情况 工作原理

1. 该技能触发对 CodexBar CLI 的调用，以获取结构化 JSON 格式的本地成本日志。
2. 它执行捆绑的 Python 脚本来解析输入中的 modelBreakdowns 或 modelsUsed 字段。
3. 逻辑会识别最近的每日条目，或根据所选模式遍历所有历史数据。
4. 它计算每个模型的总成本，在可用时优先考虑特定的细分数据，并在必要时回退到模型列表。
5. 最终汇总以人类可读的文本格式或机器可解析的 JSON 对象呈现，用于进一步的 Openclaw Skills 自动化。

模型使用情况 配置指南

首先，确保您的系统中安装了 CodexBar。目前，此技能通过 Homebrew 支持 macOS：

brew tap steipete/tap
brew install --cask codexbar

安装完成后，您可以从 Openclaw Skills 目录运行模型使用脚本：

# 示例：获取 Claude 的完整细分数据
python scripts/model_usage.py --provider claude --mode all --format json --pretty

模型使用情况 数据架构与分类体系

该技能处理由 CodexBar 生成的 JSON 数据。主要数据结构包括：

字段	描述
provider	正在跟踪的 AI 供应商（codex 或 claude）。
modelBreakdowns	包含映射到模型名称的特定成本数据的对象。
modelsUsed	缺失详细细分数据时使用的备选模型列表。
cost	代表该条目总支出的数字财务值。

name: model-usage
description: 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.
metadata: {"clawdbot":{"emoji":"??","os":["darwin"],"requires":{"bins":["codexbar"]},"install":[{"id":"brew-cask","kind":"brew","cask":"steipete/tap/codexbar","bins":["codexbar"],"label":"Install CodexBar (brew cask)"}]}}

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.

TODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.

Quick start

1. Fetch cost JSON via CodexBar CLI or pass a JSON file.
2. 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 modelsUsed when breakdowns are missing.
• Override with --model <name> when you need a specific model.

Inputs

• Default: runs codexbar cost --format json --provider <codex|claude>.
• 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.md for CLI flags and cost JSON fields.