（6672期）OpenRouter Analytics – OpenRouter 用量洞察与故障诊断

OpenRouter 用量洞察与故障诊断 通过 OpenRouter API 获取用量分析、支出监控和请求级故障排查数据，支持管理密钥级别的宏观统计与单请求深度诊断。 使用说明 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 数据暴露程度 | 保留应用层原始日志作为备选数据源 | 原始说明 Review OpenRouter usage, analytics, and troubleshooting data via API. Use when the user asks for spend/usage monitoring, activity trends, per-key management...