用途：跟踪 Clawdbot 所有会话的 token 用量，并按模型定价估算 API 成本，适合生成每日或每周成本报告、分析跨会话 token 使用、监控 AI 支出。
主要能力：通过 sessions_list 获取会话 token 数据（如 sessions_list --limit 20 --messageLimit 0），从每个会话提取 totalTokens 与 model；按模型单价估算成本，公式为 cost = tokens * (0.3 * input_price + 0.7 * output_price) / 1,000,000（假设 30% 输入、70% 输出）。资料给出的模型单价（美元/百万 token，输入/输出）：claude-opus-4-5 为 $15/$75，claude-sonnet-4 为 $3/$15，codex-mini-latest 为 $1/$5，gpt-4o 为 $2.5/$10，gpt-4o-mini 为 $0.15/$0.6。
使用方式：可将每日快照保存到 memory/usage/YYYY-MM-DD.json，记录 date、timestamp、各会话的 model/totalTokens/channel 及 summary（totalTokens、byModel）；通过比较相邻两天数据得到每日用量：daily_tokens = today.totalTokens - yesterday.totalTokens，再调用 estimate_cost 估算成本。提供脚本 scripts/snapshot-usage.js（node scripts/snapshot-usage.js [output-dir]，默认输出 memory/usage/YYYY-MM-DD.json）和 scripts/calculate-cost.js（node scripts/calculate-cost.js [date]，默认今天，输出含 token 增量与估算成本的 JSON）。可集成到 HEARTBEAT.md 的每日报告流程：调用 sessions_list 获取当前 token、加载前一天快照、计算增量并估算成本，按示例格式输出。中文财务显示约定：红色表示上升/增加，绿色表示下降/减少。
限制：成本为基于假设输入输出比例的估算值，非实际账单；资料未提供安装方式、依赖要求、支持的平台范围及定价更新机制。