Lemnos Cost Guard

🛡️ AI 智能体实时成本护栏

OpenClaw 智能体实时 API 成本追踪与预算管控工具,支持上下文膨胀检测、模型路由优化及多级预算告警,防止成本失控。

收藏
4.9k
安装
1k
版本
1.2.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Lemnos Cost Guard 是专为 OpenClaw 智能体设计的实时成本监控基础设施,通过三脚本架构实现全链路成本治理:

1. 成本追踪 (`track_cost.py`)

  • 每次任务结束后立即记录 session delta(任务前后 token 用量差值)
  • 支持输入/输出 token 分离计量,自动计算 I/O 比率
  • 输出格式为结构化 JSONL,便于后续分析

2. 报告生成 (`cost_report.py`)

  • 支持日/周/月多时间维度聚合
  • 内置预算百分比预警(80% 警告/100% 硬停)
  • brief 格式专为日报场景优化

3. 上下文分析 (`context_analyzer.py`)

  • 扫描工作空间检测上下文膨胀(bloat)
  • 识别异常 I/O 比率(>50:1)触发压缩建议
  • 配套严格的上下文加载规则,按任务最小化加载文件

模型路由策略基于 references/model_pricing.md 实现智能降级:Haiku($0.80/M)处理简单任务,Sonnet($3/M)作为默认,Opus 禁止自动调用。预算告警采用分级机制:单日 $5 预算的 80% 触发警告并暂停非收益任务,100% 硬停,单次调用超 500K 输入 token 即时告警。

显著优点

  • 安装基础扎实:258+ 次安装验证工具成熟度
  • 场景覆盖完整:从单次调用到月度 rollup 的全周期管理
  • 防御性设计:硬停机制 + 上下文最小加载规则双保险
  • 模型感知路由:价格驱动而非性能驱动的降级策略
  • 开源可审计:GitHub 源码公开,JSONL 格式透明可验证

潜在局限

  • 生态绑定深:专为 OpenClaw 设计,迁移成本不明
  • 价格表维护负担:需手动同步 model_pricing.md,新模型上线存在滞后窗口
  • 告警阈值僵化:$5/天、500K token 等阈值缺乏动态调整机制
  • Premium 功能拆分:完整仪表盘、自动化路由等核心能力需付费订阅
  • 上下文规则执行依赖:"enforce on every session" 为文档约定,无强制技术约束

适合人群

  • AI 原生一人公司:无专职运维,需要自动化成本护栏
  • OpenClaw 运营团队:管理多智能体集群,需集中成本归因
  • 高频 API 调用场景:日调用量 >1000 次,成本敏感型业务
  • 预算约束严格的早期项目:$5/天 级别预算需硬边界保护

常规风险

| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 配置漂移 | `model_pricing.md` 与实际 API 定价不同步 | 设置每周同步检查 |
| 规则绕过 | 上下文加载规则依赖人工遵守 | 结合代码审查或 linter 强制执行 |
| 告警疲劳 | 80% 阈值在日常波动中频繁触发 | 引入滑动平均或置信区间 |
| 数据孤岛 | JSONL 日志分散,长期分析困难 | Premium 仪表盘或自建 ETL |
| 供应商锁定 | OpenClaw/ClawHub 生态深度绑定 | 定期评估迁移成本 |

定价模式

免费版:基础追踪 + 预算告警 | Premium($40-60/月):仪表盘 + 自动化路由 + 优化报告

Lemnos Cost Guard 内容

references文件夹
scripts文件夹
手动下载zip · 15.0 kB
model_pricing.mdtext/markdown
请选择文件