核心用法
Lemnos Cost Guard 是一套面向 OpenClaw AI Agent 的实时成本管控体系,解决 LLM API 调用中常见的「账单黑洞」问题。核心功能包括:
1. 成本追踪:通过 track_cost.py 在每次任务后记录输入/输出 Token、模型类型、费用(USD),自动写入按日分割的 JSONL 日志
2. 预算执行:支持 $5/日默认阈值,达到 80% 触发预警、100% 强制暂停,单次调用超 500K Token 或 I/O 比 >50:1 即时告警
3. 上下文膨胀检测:context_analyzer.py 扫描工作目录,识别过度加载的内存文件,推荐最小化加载策略
4. 智能模型路由:根据任务复杂度自动匹配 Haiku($0.8/M)/Sonnet($3/M),默认禁用 Opus 除非显式请求
5. 报告生成:支持日/周/月维度成本汇总,可嵌入每日简报
显著优点
- 细粒度管控:精确到单次调用的 Token 级追踪,而非仅依赖厂商账单延迟
- 主动防御:I/O 比阈值机制提前发现「大海捞针」式上下文浪费
- 自动化工作流:脚本化设计便于集成 CI/CD 或定时任务
- 最小化原则:配套「上下文加载规则」强制按需加载,从源头削减成本
潜在局限
- 人工介入点:
track_cost.py需手动执行,若 Agent 自主调用未封装则可能漏记 - 预算刚性:$5/日硬停止可能影响关键任务,需人工覆盖机制
- 模型定价耦合:依赖
model_pricing.md静态表,厂商调价时需同步更新 - 单用户视角:未涉及多租户配额管理或成本分摊
适合人群
- 高频调用 Claude/OpenAI API 的自动化 Agent 开发者
- 需严格控制运营成本的 AI 原生产品团队
- 对「Token 效率」敏感的技术运维人员
常规风险
| 风险类型 | 说明 |
|---------|------|
| 日志完整性 | 脚本未执行或崩溃导致成本黑洞 |
| 阈值误触发 | 紧急任务被预算硬停止中断 |
| 模型路由误判 | 复杂任务被降级到 Haiku 导致质量下降 |
| 时间戳漂移 | 跨时区日志聚合时出现统计误差 |
> ⚠️ 注:ClawHub 分发版含免费/付费 tier,Premium 功能(自动化路由、仪表盘)需额外订阅。