Back to Details

clawdbot-cost-tracker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Clawdbot Cost Tracker

Clawdbot成本追踪工具

Track token usage and estimate API costs across all Clawdbot sessions.
追踪所有Clawdbot会话中的token使用情况并估算API成本。

Quick Start

快速开始

Get Current Usage

获取当前使用情况

bash
undefined
bash
undefined

Use sessions_list to get token data

Use sessions_list to get token data

sessions_list --limit 20 --messageLimit 0

Extract `totalTokens` and `model` from each session.
sessions_list --limit 20 --messageLimit 0

从每个会话中提取`totalTokens`和`model`字段。

Calculate Cost

计算成本

Model pricing (USD per million tokens):
ModelInputOutputAvg Ratio
claude-opus-4-5$15$7530/70
claude-sonnet-4$3$1530/70
codex-mini-latest$1$530/70
gpt-4o$2.5$1030/70
gpt-4o-mini$0.15$0.630/70
Cost formula (assuming 30% input, 70% output):
cost = tokens * (0.3 * input_price + 0.7 * output_price) / 1,000,000
模型定价（每百万token美元计价）：
ModelInputOutputAvg Ratio
claude-opus-4-5$15$7530/70
claude-sonnet-4$3$1530/70
codex-mini-latest$1$530/70
gpt-4o$2.5$1030/70
gpt-4o-mini$0.15$0.630/70
成本计算公式（假设输入占30%，输出占70%）：
cost = tokens * (0.3 * input_price + 0.7 * output_price) / 1,000,000

Daily Tracking

每日追踪

Save Usage Snapshot

保存使用情况快照

Store daily snapshots in 
memory/usage/YYYY-MM-DD.json
:
json
{
  "date": "2026-01-29",
  "timestamp": "2026-01-29T08:20:00+08:00",
  "sessions": {
    "session_key": {
      "model": "claude-opus-4-5",
      "totalTokens": 123456,
      "channel": "discord"
    }
  },
  "summary": {
    "totalTokens": 250000,
    "byModel": {
      "claude-opus-4-5": 220000,
      "codex-mini-latest": 30000
    }
  }
}
将每日快照存储在
memory/usage/YYYY-MM-DD.json
中：
json
{
  "date": "2026-01-29",
  "timestamp": "2026-01-29T08:20:00+08:00",
  "sessions": {
    "session_key": {
      "model": "claude-opus-4-5",
      "totalTokens": 123456,
      "channel": "discord"
    }
  },
  "summary": {
    "totalTokens": 250000,
    "byModel": {
      "claude-opus-4-5": 220000,
      "codex-mini-latest": 30000
    }
  }
}

Calculate Daily Cost

计算每日成本

Compare consecutive days to get daily usage:
daily_tokens = today.totalTokens - yesterday.totalTokens
daily_cost = estimate_cost(daily_tokens, model)
对比连续两天的数据得到当日使用量：
daily_tokens = today.totalTokens - yesterday.totalTokens
daily_cost = estimate_cost(daily_tokens, model)

Scripts

脚本工具

scripts/snapshot-usage.js

scripts/snapshot-usage.js

Creates a usage snapshot from current session data.
bash
node scripts/snapshot-usage.js [output-dir]
从当前会话数据生成使用情况快照。
bash
node scripts/snapshot-usage.js [output-dir]

Default output: memory/usage/YYYY-MM-DD.json

Default output: memory/usage/YYYY-MM-DD.json

undefined
undefined

scripts/calculate-cost.js

scripts/calculate-cost.js

Calculates cost for a date range.
bash
node scripts/calculate-cost.js [date]
计算指定日期范围内的成本。
bash
node scripts/calculate-cost.js [date]

Default: today

Default: today

Output: JSON with token delta and estimated cost

Output: JSON with token delta and estimated cost

undefined
undefined

Integration with Daily Report

与日报集成

Add to HEARTBEAT.md:
  1. Call 
    sessions_list
    to get current tokens
  2. Load previous day's snapshot from 
    memory/usage/
  3. Calculate delta and estimate cost
  4. Include in daily report format: 
    💰 **Clawdbot Cost** (yesterday)
• Used: 45.2k tokens
• Estimated: ~$1.23
添加至HEARTBEAT.md：
  1. 调用
    sessions_list
    获取当前token数据
  2. 从
    memory/usage/
    加载前一日的快照
  3. 计算增量并估算成本
  4. 按照以下格式纳入日报： 
    💰 **Clawdbot成本**（昨日）
• 使用量：45.2k tokens
• 估算成本：~$1.23

Color Conventions (Chinese Style)

中文场景下的颜色约定

For financial displays in Chinese context:
  • 🔴 Red = Up/Increase
  • 🟢 Green = Down/Decrease
针对中文语境下的财务展示：
  • 🔴 红色 = 上升/增加
  • 🟢 绿色 = 下降/减少