什么是GreenClaw
GreenClaw 是一款专为推理代理（reasoning agent）设计的 Token 用量分析与预算管理工具，通过命令行界面提供对 AI 模型调用成本的全面监控。它基于 SQLite 数据库记录所有 LLM 请求的遥测数据，支持按时间、模型、供应商等维度进行成本分析。用户可以通过简单的命令查询每日、每周或每月的消费汇总，并获取详细的支出分布情况。该工具特别适用于需要精细控制 AI 服务开销的开发团队和项目，帮助识别高成本模型的使用模式，从而优化资源分配。GreenClaw 的核心优势在于其轻量级架构和实时告警机制，能够在预算超支前及时通知用户，避免意外的高额账单。
核心功能特点
- 支持按日、周、月周期生成 Token 使用与成本汇总报告
- 可按模型类型、计费层级或供应商进行多维度费用拆解分析
- 提供趋势追踪功能，可视化展示近7天/4周内的用量变化
- 内置预算告警系统，可设置每日/每周成本上限或特定模型的消费限额
- 自动记录并计算节省金额，突出显示通过路由策略实现的节流效果
- 输出结构化 JSON 数据，便于集成到现有监控系统或自定义仪表板
适用场景
GreenClaw 特别适合那些在生产环境中部署了多个 LLM 推理代理且面临成本控制压力的场景。例如，一个使用 OpenAI GPT-4 和 Claude 3 混合调用的智能客服系统，可以通过 GreenClaw 实时监控各模型的调用频次与费用占比，及时发现异常峰值并调整路由策略。对于初创公司或中小型企业而言，在缺乏专职 DevOps 的情况下，GreenClaw 提供的每日预算告警能有效防止因 API 滥用导致的财务风险。此外，当团队尝试实施‘降级路由’策略（如将复杂任务导向 cheaper models）时，GreenClaw 能清晰量化节省效果，为技术决策提供数据支撑。无论是本地开发环境还是云部署的推理服务，只要配置了 GREENCLAW_TELEMETRY_DB 路径，即可无缝接入这套轻量级分析体系。