💰 火一五成本追踪器 (huo15-cost-tracker)#

作者: 火一五信息科技有限公司

版本: v1.1.0

---

一、简介#

成本追踪器用于记录 AI API 调用统计，包括：

• Token 消耗（输入/输出）
• API 调用次数
• 成本计算
• 会话时长

核心功能#

功能说明📊 Token 统计记录输入/输出 Token 数量💵 成本计算基于模型定价计算 USD 成本📈 调用统计记录 API 调用次数⏱️ 时长追踪记录会话/任务时长📋 报表生成生成可视化成本报表

---

二、工作原理#

text

API 调用 → 记录 Token → 计算成本 → 存储统计 → 生成报表

每次 API 调用时记录：

• 输入 Token 数量
• 输出 Token 数量
• 调用时间
• 模型名称
• 响应时长

---

三、使用方式#

3.1 查看当前成本#

bash

cd ~/.openclaw/workspace/skills/huo15-cost-tracker
./scripts/report.sh

3.2 重置统计#

bash

./scripts/reset.sh

3.3 记录 API 调用#

bash

./scripts/track.sh record \
  --input-tokens 1000 \
  --output-tokens 500 \
  --model "MiniMax-M2.1" \
  --duration 1500

3.4 添加到 HEARTBEAT#

在 HEARTBEAT.md 中添加定时报告：

markdown

## 💰 成本检查（每30分钟）
./scripts/report.sh

---

四、配置说明#

4.1 模型定价#

配置文件： config/pricing.json

json

{
  "MiniMax-M2.1": {
    "inputTokens": 0.01,
    "outputTokens": 0.01,
    "unit": "per 1M tokens"
  },
  "gpt-4o": {
    "inputTokens": 2.5,
    "outputTokens": 10,
    "unit": "per 1M tokens"
  }
}

4.2 报告格式#

bash

========================================
💰 成本追踪报表
========================================
会话: 2026-04-05 02:00
----------------------------------------
总 API 调用: 42 次
总 Input Tokens: 125,000
总 Output Tokens: 89,500
----------------------------------------
预估成本: $0.42 USD
----------------------------------------
模型使用分布:
  MiniMax-M2.1: 35 次 (83%)
  其他: 7 次 (17%)
----------------------------------------
最耗时调用: 3,200ms
平均响应时间: 850ms
----------------------------------------

---

五、成本阈值警告#

当成本超过阈值时自动提醒：

bash

# 设置警告阈值（默认 $1.00）
./scripts/track.sh set-threshold 1.0

# 查看当前阈值
./scripts/track.sh get-threshold

阈值配置在 config/threshold.json：

json

{
  "thresholdUSD": 1.0,
  "alertEnabled": true,
  "alertChannel": "wecom"
}

---

六、定时报告#

6.1 添加到 Cron#

bash

# 每小时报告
0 * * * * /Users/jobzhao/.openclaw/workspace/skills/huo15-cost-tracker/scripts/report.sh

# 每天报告（早上9点）
0 9 * * * /Users/jobzhao/.openclaw/workspace/skills/huo15-cost-tracker/scripts/daily-report.sh

6.2 每日报告功能#

bash

# 生成每日成本摘要
./scripts/daily-report.sh

输出：

text

📅 每日成本报告 - 2026-04-05
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
今日 API 调用: 42 次
今日 Token: 215,000
今日成本: $0.42 USD
━━━━━━━━━━━━━━━
较昨日: +15% 📈

---

七、脚本清单#

脚本功能track.sh记录 API 调用report.sh生成成本报表reset.sh重置统计数据config.sh配置管理

---

六、集成方式#

6.1 集成到 API 调用层#

在调用 LLM API 时自动记录：

bash

# 调用 API 前
START_TIME=$(date +%s%3N)

# 调用 API...

# 调用 API 后
END_TIME=$(date +%s%3N)
DURATION=$((END_TIME - START_TIME))

# 记录
./scripts/track.sh record \
  --input-tokens $INPUT \
  --output-tokens $OUTPUT \
  --model "MiniMax-M2.1" \
  --duration $DURATION

6.2 集成到 Dream Agent#

在 dream.sh 中添加成本追踪：

bash

# Dream Agent 执行后
./scripts/track.sh record \
  --input-tokens $(cat /tmp/dream_input_tokens) \
  --output-tokens $(cat /tmp/dream_output_tokens) \
  --model "MiniMax-M2.1" \
  --duration $(cat /tmp/dream_duration)

---

七、版本历史#

版本日期更新内容v1.1.02026-04-05新增中文别名：火一五成本追踪，新增阈值警告，新增每日报告v1.0.12026-04-05修复 shell 变量解析警告v1.0.02026-04-05初始版本