Agent 成本监控器 — 掌握您的 Agent 实际开销

实时追踪所有 OpenClaw Agent 的 Token 使用量、费用及运行效率，并在预算超支前及时发出告警。

问题所在

同时运行多个 Agent 功能强大——但若缺乏监控，成本可能迅速攀升：

• 哪个 Agent 消耗的 Token 最多？
• 心跳（heartbeats）是否正在昂贵模型上浪费资金？
• 缓存（caching）是否真的为您节省了成本？
• 您将在何时触达本周速率限制（rate limit）？

该技能的作用

当被触发（通过 cron 或手动调用）时，Agent 将执行以下操作：

1. 检查每个 Agent 的 session_status
2. 计算各 Agent 及整体费用
3. 将实际支出与预算阈值进行比对
4. 在接近限额时发送告警
5. 提出优化建议

使用方式

向您的监控 Agent（或任意具备此技能的 Agent）发起如下请求：

"为所有 Agent 生成一份成本报告"
"今天哪个 Agent 消耗的 Token 最多？"
"我这周会触达速率限制吗？"

自动化每日报告（Cron）

{
  "name": "Daily Cost Report",
  "schedule": { "kind": "cron", "expr": "0 20 * * *", "tz": "Europe/Berlin" },
  "payload": {
    "kind": "agentTurn",
    "message": "Run a cost report across all agents. Check session_status for each. Report: total tokens, cost per agent, top spender, budget warnings. Send summary to user."
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce" }
}

成本报告格式

生成报告时，请采用如下结构：

## 💰 Agent 成本报告 — [日期]

### 各 Agent 明细
| Agent | 模型 | Token 数量（24 小时） | 预估费用 | 状态 |
|-------|------|------------------------|-----------|------|
| Central | Opus 4.6 | 125K | $1.87 | ⚠️ 较高 |
| Techops | Opus 4.6 | 89K | $1.33 | ✅ 正常 |
| Atlas | Sonnet 4.5 | 45K | $0.27 | ✅ 较低 |
| Closer | Haiku 4.5 | 23K | $0.02 | ✅ 极低 |
| Heartbeats | Ollama | 12K | $0.00 | ✅ 免费 |

### 汇总
- **24 小时总计：** 294K tokens（约 $3.49）
- **本周预估：** 约 $24.43
- **预算：** $20/周 → ⚠️ 预估超支至 122%

### 优化建议
1. 将 Techops 的常规任务由 Opus 切换至 Sonnet（可降本 40%）
2. 将心跳间隔由 15 分钟延长至 30 分钟
3. 在 Atlas 上启用上下文裁剪（context pruning），避免空闲会话持续消耗缓存

模型费用参考（2026 年起生效）

请依据下表进行费用估算：

Anthropic（Claude OAuth / API）

免费选项

* 免费额度含速率限制

优化手册

快速见效项（优先实施）

1. 心跳任务迁移至 Ollama

{ "heartbeat": { "model": "ollama/llama3.2:3b" } }

节省：100% 的心跳成本（若使用 Opus，每周可节省 $5–$10）

2. 关闭 Haiku 的缓存保留机制

{ "anthropic/claude-haiku-4-5": { "params": { "cacheRetention": "none" } } }

节省：在低成本模型上避免缓存写入开销（不值得缓存）

3. 启用上下文裁剪（Context Pruning）

{ "contextPruning": { "mode": "cache-ttl", "ttl": "5m" } }

节省：每轮对话中避免重复读取过期上下文

4. 为 Opus/Sonnet 启用长期缓存保留

{ "anthropic/claude-opus-4-6": { "params": { "cacheRetention": "long" } } }

节省：避免每轮对话重复发送系统提示词（单次节省幅度最大）

模型分级策略（影响最大）

会话管理

• 每日重置：会话将在指定时间自动清空（降低 Token 积累）

{ "session": { "reset": { "mode": "daily", "atHour": 4, "idleMinutes": 45 } } }

• 记忆刷新：压缩前保存关键上下文

{ "compaction": { "memoryFlush": { "enabled": true } } }

告警阈值

请在监控 Agent 的 memory 中配置：

## 预算告警
- 日预算：$5.00（达 80% 即 $4.00 时告警）
- 周预算：$20.00（达 70% 即 $14.00 时告警）
- 单 Agent 日上限：$2.00
- 告警通道：Telegram 私信

与 DevOps Agent 集成

若您已部署 DevOps/监控 Agent（例如您的 DevOps Agent），请在该 Agent 的 AGENTS.md 中添加：

## 成本监控
- 每日 20:00 执行成本报告
- 若任一 Agent 单日费用超 $2，则立即告警
- 每周一 09:00 发送周度汇总
- 追踪趋势：用量呈上升还是下降？

常见问题（FAQ）

Q：该技能是否会发起 API 调用？
A：不会。它仅调用 OpenClaw 内置的 session_status 工具，不依赖任何外部 API，亦不产生额外费用。

Q：费用估算准确度如何？
A：基于官方发布的模型定价。实际费用可能因缓存命中率而略有浮动；当前估算偏保守（略高于实际）。

Q：能否按单次对话（conversation）追踪费用？
A：暂不支持。费用按会话（session）粒度统计。如需查看各会话 Token 数量，请使用 sessions_list 工具。

Q：是否支持非 Anthropic 模型？
A：支持。Token 统计适用于所有提供商；费用估算需已知定价信息（您可在“模型费用参考”章节中补充自定义费率）。

更新日志

v1.1.0

• 示例中所有 Agent 名称均已泛化处理
• 移除所有特定部署环境的配置引用

v1.0.0

• 初始发布