每日成本报告 📊

生成全面的 OpenClaw 使用与成本报告，按 agent、模型和 channel 进行细分。支持按需手动分析，也支持自动化每日邮件投递。

快速开始

# 生成昨日报告（Markdown 格式）
{baseDir}/scripts/daily-cost-report.sh yesterday

# 生成指定日期的报告
{baseDir}/scripts/daily-cost-report.sh 2026-03-18

# 生成今日报告
{baseDir}/scripts/daily-cost-report.sh today

# 生成 HTML 格式的邮件报告
{baseDir}/scripts/daily-cost-report-email.sh yesterday

# 向指定收件人发送邮件报告
{baseDir}/scripts/send-cost-report.sh kjvarga@gmail.com yesterday

功能说明

每日成本报告分析指定日期范围内 OpenClaw 的会话数据，并生成以下内容：

• 总成本与 Token 使用量：涵盖所有 agent、模型及 channel
• 按 agent 细分：展示资源消耗最多的 agent
• 按模型细分：展示 Claude 系列、Deepseek、GPT 等模型的成本分布
• 按 channel 细分：展示 Telegram、CLI、Web 等渠道的使用情况
• 按成本排序的 Top 会话：识别单次开销最高的会话
• Prompt 缓存指标：展示缓存写入/读取 Token 数量及对应成本节约

报告采用当前定价标准，涵盖以下模型：

• Claude Haiku 4.5
• Claude Sonnet 4.5
• Claude Opus 4.6
• Deepseek V3.2
• OpenAI GPT-4o-mini

缓存读写成本已纳入总成本计算。

脚本说明

daily-cost-report.sh

核心报告生成脚本。通过 openclaw sessions --all-agents --json 查询 OpenClaw 会话数据，按日期范围过滤，结合各模型的单价计算成本，并输出 Markdown 格式结果。

输出路径：/tmp/cost-report-YYYY-MM-DD.md

daily-cost-report-email.sh

将 Markdown 报告封装进 HTML 邮件模板，包含样式化表格、摘要指标与清晰的视觉层级结构。

输出路径：/tmp/cost-report-YYYY-MM-DD.html

send-cost-report.sh

使用 mail 命令发送 HTML 报告邮件；若邮件发送失败，则自动回退为保存文件。

用法：send-cost-report.sh [date]

Cron 调度配置

每日成本报告通常以 Cron 任务形式配置于 ~/.openclaw/cron/jobs.json 中：

{
  "id": "daily-cost-report",
  "agentId": "worker",
  "name": "main-daily-cost-report",
  "enabled": true,
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "America/Vancouver"
  },
  "sessionTarget": "isolated",
  "wakeMode": "now",
  "payload": {
    "kind": "agentTurn",
    "message": "Generate yesterday's cost report and send to kjvarga@gmail.com"
  },
  "delivery": {
    "mode": "announce",
    "channel": "telegram",
    "to": "7918443630"
  }
}

该 Cron 任务触发对应技能，技能再调用相应脚本执行报告生成与投递流程。

从 agent 手动调用

当 Karl 请求生成成本报告时：

# 在具备 exec 权限的任意 agent 中执行
exec(command: "bash ~/.openclaw/workspace/skills/daily-cost-report/scripts/daily-cost-report.sh yesterday")

# 或直接生成并发送邮件
exec(command: "bash ~/.openclaw/workspace/skills/daily-cost-report/scripts/send-cost-report.sh kjvarga@gmail.com yesterday")

报告格式

报告包含以下部分：

1. 摘要部分 — 总成本、总 Token 数、缓存指标与节约金额
2. 按 agent 成本分布 — 活跃度/开销最高的 agent
3. 按模型成本分布 — 各模型级资源消耗详情
4. 按 channel 成本分布 — Telegram、CLI、Web 等渠道的使用统计
5. Top 会话列表 — 单次成本最高的若干会话

所有金额单位为美元（USD），保留四位小数；Token 数量使用千位分隔符提升可读性。

日期处理

脚本支持以下日期参数：

• yesterday（默认）— 上一自然日
• today — 当前自然日
• YYYY-MM-DD — 指定具体日期

日期解析兼容 macOS（date -v-1d）与 Linux（date -d "yesterday"）系统。

依赖要求

• OpenClaw CLI：openclaw sessions --all-agents --json
• jq：用于 JSON 数据处理
• awk：用于数据聚合
• mail 命令：用于邮件投递（可选）
• bash 4+：支持关联数组（associative arrays）

成本说明

本技能完全免费 — 仅读取 OpenClaw 已记录的会话元数据，不发起任何外部 API 调用。

示例输出

# OpenClaw 每日成本报告 🐈‍⬛
**日期：** 2026-03-18  
**生成时间：** 2026-03-19 08:00:00 PDT

---

## 摘要

| 指标 | 数值 |
|--------|-------|
| **总成本** | $2.4567 |
| **总 Token 数** | 1,234,567 |
| **输入 Token 数** | 987,654 |
| **输出 Token 数** | 246,913 |
| **缓存写入 Token 数** | 123,456 |
| **缓存读取 Token 数** | 456,789 |
| **缓存节约成本** | $0.3245 |

---

## 按 agent 成本分布

| Agent | 成本 | Token 数 | 输入 | 输出 |
|-------|------|--------|-------|--------|
| main | $1.2345 | 654,321 | 543,210 | 111,111 |
| worker | $0.8901 | 400,000 | 320,000 | 80,000 |
| research | $0.3321 | 180,246 | 124,444 | 55,802 |
...