技能名称: greenclaw-usage

详细描述:

GreenClaw 用量分析

你可以使用 greenclaw 命令行工具查询令牌用量、成本分析以及管理预算警报。通过 npx greenclaw 运行（需先执行 pnpm install 和 pnpm build）。所有命令均输出 JSON 格式结果。

可用命令

用量查询

每日汇总：

bash
npx greenclaw usage summary --period day

每周或每月汇总：

bash
npx greenclaw usage summary --period week
npx greenclaw usage summary --period month

按模型、层级或提供商细分：

bash
npx greenclaw usage breakdown --by model --period day
npx greenclaw usage breakdown --by tier --period week
npx greenclaw usage breakdown --by provider --period month

随时间变化的趋势：

bash
npx greenclaw usage trends --period day --last 7
npx greenclaw usage trends --period week --last 4

预算警报

列出警报规则：

bash
npx greenclaw alerts list

设置每日成本预算：

bash
npx greenclaw alerts set --name 每日预算 --metric daily_cost --threshold 50 --unit usd --period day

设置每周令牌限额：

bash
npx greenclaw alerts set --name 每周令牌 --metric weekly_cost --threshold 100 --unit usd --period week

设置按模型成本上限：

bash
npx greenclaw alerts set --name gpt-4 上限 --metric permodelcost --threshold 30 --unit usd --period day --model gpt-4

立即检查警报：

bash
npx greenclaw alerts check

查看警报历史：

bash
npx greenclaw alerts history --last 10

移除警报规则：

bash
npx greenclaw alerts remove <规则ID>

原始追踪

聚合统计：

bash
npx greenclaw traces --stats

按层级或模型筛选：

bash
npx greenclaw traces --tier HEARTBEAT
npx greenclaw traces --model gpt-4o-mini

如何呈现结果

• - 解析 JSON 输出，并以清晰可读的格式呈现
• 对于汇总：显示总令牌数、成本、节省金额和请求数量
• 对于细分：显示包含分组键、令牌数、成本、节省金额的表格
• 对于警报：解释哪些规则被触发以及当前指标值
• 美元金额四舍五入保留两位小数
• 使用自然语言解释节省情况（例如：今天通过将 412 个请求路由到更便宜的模型，您节省了 8.91 美元）

环境

greenclaw 命令行工具使用 GREENCLAWTELEMETRYDB 环境变量指定 SQLite 数据库路径（默认为 data/telemetry.db）。