Skill Cost

追踪OpenClaw会话日志中各技能的Token用量与成本。当用户询问技能级消费、最高成本技能或需要分技能明细时使用。

安装

概览

什么是Skill Cost

Skill Cost 是一个专为 OpenClaw 会话日志设计的命令行分析工具,用于追踪和统计各技能(skill)在运行过程中消耗的 Token 数量及其对应的成本。该工具直接读取本地存储的会话 JSONL 文件,无需依赖外部 API 或网络请求,即可生成详细的资源使用报告。通过解析助手消息中的工具调用记录,Skill Cost 能够准确地将 Token 消耗归因于具体技能,并支持多种灵活的查询模式。无论是想了解某个技能在过去一周内的开销,还是需要对比两个技能的效率差异,该工具都能提供清晰的数据洞察。其核心优势在于完全离线运行、零额外依赖,并且输出格式灵活,既支持人类可读的文本报表,也支持机器友好的 JSON 格式。对于开发者或系统管理员而言,它是一个轻量级但功能强大的运维与监控辅助工具。

核心功能特点

  1. 追踪每个技能在 OpenClaw 会话中消耗的 Token 数量与对应成本
  2. 支持按时间范围筛选,如最近7天或指定起始日期的数据汇总
  3. 可生成技能成本排行榜,快速识别高开销技能
  4. 提供单个技能的详细使用明细,包括模型类型和使用频率
  5. 支持两个技能之间的成本对比分析,便于性能评估
  6. 输出格式可选文本或 JSON,满足不同场景下的集成需求

适用场景

Skill Cost 最适用于需要精细化管理 AI 代理资源消耗的场景。例如,在一个多技能协作的自动化工作流中,管理员可以通过运行 ‘skill-cost.sh report –days 7’ 快速查看过去一周内哪些技能最耗费计算资源,从而优化技能调用策略或调整模型配置以控制成本。当团队引入新技能时,使用 ‘compare poe-connector web-search’ 命令可以直观比较新旧技能的单位任务成本,辅助技术选型决策。此外,在调试阶段,若发现某次会话异常卡顿或费用激增,执行 ‘detail poe-connector’ 能定位到该技能的具体使用情况和 token 分布,帮助排查问题根源。由于所有数据均来自本地日志文件,该工具特别适合对隐私和延迟敏感的生产环境,确保分析过程不泄露敏感信息且响应迅速。无论是日常运维监控还是深度成本审计,Skill Cost 都是一款高效、可靠的开源解决方案。