OpenClaw Skill: Model-Usage¶

Skill 简介¶

在人工智能开发和使用的过程中，了解不同模型的使用成本和资源消耗情况对于优化预算、提高效率至关重要。OpenClaw Skill 的 model-usage 功能正是为了解决这一问题而设计的。该 Skill 基于 CodexBar 命令行工具（CLI），可以汇总并展示每个模型的使用成本数据，帮助开发者更直观地了解模型的使用情况。

无论是使用 Codex 还是 Claude 模型，model-usage 都能提供详细的成本分析。它能够根据 CodexBar 的本地成本日志，生成当前模型（即最新日使用记录）或者所有模型的详细使用报告。这样一来，开发者可以轻松掌握不同模型的使用频率和费用情况，从而做出更明智的资源分配决策。

主要功能¶

model-usage Skill 提供了以下几个核心功能：

1. 按模型汇总成本数据
   该功能能够根据 CodexBar 的本地成本日志，汇总并展示每个模型的使用成本。无论是 Codex 还是 Claude 模型，开发者都可以通过该功能快速获取每个模型的费用详情。

bash python {baseDir}/scripts/model_usage.py --provider codex --mode all

1. 获取当前模型的使用成本
   通过分析最新的每日日志条目，model-usage 可以自动识别并展示当前使用中的模型及其成本。如果日志中缺少详细的模型分解数据，它会回退到 modelsUsed 列表中的最后一个条目作为默认选择。

bash python {baseDir}/scripts/model_usage.py --provider claude --mode current

1. 支持自定义模型选择
   如果开发者需要查看特定模型的使用成本，可以使用 --model <name> 参数进行覆盖。例如：

bash python {baseDir}/scripts/model_usage.py --provider codex --mode all --model "codex-davinci-002"

1. 灵活的输入方式
   除了默认的 CodexBar CLI 调用方式，model-usage 还支持通过文件或标准输入（stdin）传递成本 JSON 数据。这为开发者提供了更大的灵活性，尤其是在处理大量日志数据时。

bash codexbar cost --provider codex --format json > /tmp/cost.json python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all

1. 多种输出格式
   model-usage 支持文本和 JSON 两种输出格式，并且可以通过 --pretty 参数生成格式化的 JSON 输出，方便开发者进行后续的数据处理和分析。

bash python {baseDir}/scripts/model_usage.py --provider codex --mode all --format json --pretty

1. 支持脚本化操作
   该 Skill 的设计充分考虑了脚本化操作的需求，开发者可以将其集成到现有的工作流或自动化脚本中，实现对模型使用成本的持续监控和分析。

使用场景¶

1. 预算管理与成本控制
   在项目开发过程中，开发者需要实时了解不同模型的使用成本，以便进行预算管理和成本控制。model-usage 可以提供详细的成本数据，帮助团队优化资源分配。

2. 模型性能评估
   通过分析不同模型的使用成本，开发者可以评估模型的性能表现。例如，高成本的模型是否带来了相应的性能提升，或者是否可以通过优化模型选择来降低成本。

3. 自动化监控与报告生成
   model-usage 可以集成到自动化监控系统中，定期生成模型使用成本的报告。这对于需要持续跟踪模型使用情况的团队尤为重要。

4. 资源优化与效率提升
   通过分析模型的使用模式，开发者可以识别出资源消耗较大的模型，并进行优化。例如，调整模型调用频率或选择更经济的替代方案。

5. 多模型项目管理
   在多模型并行使用的项目中，model-usage 可以帮助开发者快速了解每个模型的使用情况，确保项目资源的合理分配和高效利用。

如何使用¶

安装与配置¶

1. 安装 CodexBar CLI
   model-usage 依赖于 CodexBar CLI，因此首先需要安装 CodexBar。可以通过 Homebrew 安装：

bash brew install steipete/tap/codexbar

1. 安装 Python 依赖
   确保系统中已安装 Python 3.x 版本。然后，导航到 Skill 的安装目录并安装必要的 Python 依赖：

bash pip install -r requirements.txt

使用命令¶

• 获取当前模型的使用成本：

bash python {baseDir}/scripts/model_usage.py --provider codex --mode current

• 获取所有模型的使用成本：

bash python {baseDir}/scripts/model_usage.py --provider codex --mode all

• 以 JSON 格式输出并格式化：

bash python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty

• 通过文件输入：

bash codexbar cost --provider codex --format json > /tmp/cost.json python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all

• 通过标准输入传递数据：

bash cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current

示例¶

示例 1：获取 Codex 当前模型的使用成本¶

python {baseDir}/scripts/model_usage.py --provider codex --mode current

输出示例：

Current Model: codex-davinci-002
Cost: $120.50

示例 2：获取 Claude 所有模型的使用成本，并以 JSON 格式输出¶

python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty

输出示例：

{
  "models": [
    {
      "name": "claude-sonata-001",
      "cost": 85.75
    },
    {
      "name": "claude-sonata-002",
      "cost": 150.00
    }
  ]
}

总结¶

OpenClaw Skill 的 model-usage 功能为开发者提供了一种高效、灵活的方式来跟踪和分析不同模型的使用成本。通过该 Skill，团队可以更好地进行预算管理、资源优化和成本控制。无论是日常开发还是大型项目，model-usage 都能为开发者提供有价值的洞察，帮助他们做出更明智的决策。

该 Skill 适用于需要管理多模型项目的团队、希望优化成本的开发者以及任何希望深入了解模型使用情况的 AI 从业者。通过 model-usage，开发者可以轻松获取详细的成本数据，并将其集成到现有的工作流中，实现对模型使用情况的持续监控和分析。