Cost Guardian — OpenClaw 成本监控与优化器

实时掌握您的智能体开销，在问题发生之前即刻知晓。

适用场景

✅ 请在以下情况使用该技能：

• “我当前花了多少钱？”
• “我的 API 调用成本是多少？”
• “哪些会话消耗最多？”
• “我是否已超预算？”
• “如何降低成本？”
• 配置每日/每周成本报告
• 为 cron 任务和自动化任务优化模型使用策略

❌ 请勿将该技能用于：

• Anthropic / OpenAI 的账单问题（请直接联系对应服务商）
• API 密钥管理（请使用 OpenClaw 的 secrets 系统）

快速上手

获取全量成本报告（历史累计）

python3 scripts/cost-report.py --all

过去 24 小时成本报告

python3 scripts/cost-report.py --hours 24

启用预算告警（$5/天）

python3 scripts/cost-report.py --budget 5.00

JSON 格式输出（适用于仪表盘集成）

python3 scripts/cost-report.py --all --json

报告内容说明

• 按模型与会话估算的成本
• Token 拆分统计 — 输入 Token、输出 Token、上下文缓存（cached）Token
• 高消耗会话排行 — 快速定位 Token 消耗大户
• 模型效率分析 — 若将常规任务迁移至更低成本模型，预计可节省的费用
• 预算告警机制 — 🟡 使用率达 80% 时预警，🔴 超出预算时触发严重告警
• cron 任务成本追踪 — 自动化作业常占总支出的 30–50%

配置自动化报告

通过 Cron 配置每日成本报告

向您的智能体下达指令：

“配置一个每日成本报告，于上午 8 点自动运行，并在我当日支出超过 $5 时发出提醒。”

智能体应创建如下 cron 任务：

1. 执行 python3 /scripts/cost-report.py --hours 24 --budget 5.00
2. 通过您指定的渠道（如邮件、Slack 等）投递报告

模型优化建议

报告将识别出在常规任务中误用高价模型（如 Opus）的情形——此类任务完全可由 Sonnet 高效完成：

• 邮件检查类 cron → 改用 Sonnet
• 心跳健康检查 → 改用 Sonnet
• 网站健康监控 → 改用 Sonnet 或 Haiku
• 复杂推理、战略规划、长文本生成等 → 继续使用 Opus

支持的模型及定价

以上价格为估算值，实际可能有所变动。如需更新最新费率，请修改 scripts/cost-report.py 中的 MODEL_PRICING 字典。

路线图

• 按会话类型自动推荐最优模型切换策略
• 历史趋势分析（日/周/月维度）
• 成本异常检测（识别突发性激增）
• 按项目粒度进行成本分摊
• 提供带可视化图表的 Web 仪表盘