Cost Tracking for Models

# OpenClaw Cost Tracker

## 概述

通过按日期和模型类型提供的详细报告，精确追踪 OpenClaw 的使用成本。此技能使用 jq 工具直接从 OpenClaw 会话日志中解析 JSON 数据，提取准确的成本信息。

支持多种报告格式： - 日报（今日/昨日成本） - 周报（本周总计/与上周对比） - 月报（本月总计/环比增长）

## 快速开始

```bash # Today's cost report bash {baseDir}/scripts/cost_report.sh --today

# Yesterday's cost report bash {baseDir}/scripts/cost_report.sh --yesterday

# Weekly cost report bash {baseDir}/scripts/cost_report.sh --week

# Date range report bash {baseDir}/scripts/cost_report.sh --from 2026-01-01 --to 2026-01-31 ```

## 成本计算方法

此脚本直接从 OpenClaw 会话日志文件 (`~/.openclaw/agents/*/sessions/*.jsonl`) 中提取成本数据： 1. 使用 jq 解析 JSON 数据，定位 `message.usage.cost.total` 字段 2. 计算按日期和模型分组的总计 3. 确保每次 API 调用的成本仅被计算一次

## Discord 输出格式

``` 💰 OpenClaw Cost Report (2026-02-04) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Today's Total Cost: $XX.XX (🟢 -XX% vs yesterday)

📊 Model Details: • claude-opus-4-5: $XX.XX (XX%) • gpt-4o: $X.XX (X%) • ...

📈 Weekly Total: $XXX.XX ```

## 安装要求

- jq：JSON 解析工具（`brew install jq` 或 `apt install jq`） - 对 OpenClaw 日志文件的访问权限