OpenRouter Analytics 技能评估
核心用法
该技能提供双层级数据访问能力：管理级用量统计与请求级故障排查。用户可通过 Management API 密钥获取账户级活动趋势、信用额度消耗、API 密钥分发情况；通过标准 API 密钥则可深入单条请求（generation）的完整生命周期数据，包括延迟指标、供应商回退路径、终止原因及 token/成本明细。
CLI 设计覆盖典型运维场景：按日期范围聚合 (--from/--to)、摘要模式 (--summary)、CSV/Markdown 导出、原始 JSON 输出 (--raw)。generation --id 子命令专为事后根因分析设计，可交叉验证应用日志中的请求 ID。
显著优点
- 数据粒度灵活：从宏观趋势到微观单请求，满足不同层级决策需求
- 运维友好：内置重试机制 (
--retries)、超时控制 (--timeout)、多格式导出 - 配置自动化：自动加载
~/.openclaw/.env与当前目录.env，降低手动配置负担 - 故障诊断闭环：建议应用层保留 generation ID，实现从告警到根因的完整追踪链
潜在局限
- 双密钥体系复杂度高：管理密钥与普通 API 密钥权限分离，用户易混淆适用场景
- 依赖外部服务稳定性：OpenRouter API 的可用性直接影响技能功能
- 无实时流式数据：基于拉取模式，非事件驱动，延迟取决于查询频率
- 本地存储风险：CSV/JSON 导出至
/tmp等路径时，敏感财务数据可能残留于临时文件
适合人群
- 需要监控多密钥用量分布的团队管理员
- 负责 LLM 成本优化与预算跟踪的 FinOps 工程师
- 需排查特定请求异常（延迟突增、供应商切换、意外计费）的运维/SRE 人员
- 构建内部用量看板的平台工程师（可通过
--raw获取结构化数据）
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | Management Key 权限较高，泄露可导致账户级数据暴露 | 配置 `.env` 时确保文件权限 600，避免提交至版本控制 |
| 数据残留 | `--csv` 导出文件可能包含敏感成本数据 | 定期清理 `/tmp`，或使用管道直接处理避免落盘 |
| 配额误判 | 缓存或延迟导致信用额度显示与实际消费不一致 | 关键决策前交叉验证 OpenRouter 官方仪表盘 |
| 供应商锁定 | 过度依赖单一代理聚合层，诊断能力受限于 OpenRouter 数据暴露程度 | 保留应用层原始日志作为备选数据源 |