核心功能
session-cost 是一款面向 OpenClaw 生态的成本监控工具，专门用于解析多智能体（multi-agent）会话日志，提供细粒度的 Token 消耗与成本分析。该技能通过扫描 ~/.openclaw/agents/ 目录下的 JSONL 会话文件，自动按代理（agent）和模型（model）层级聚合数据，生成结构化的费用报告。
主要用法
基础统计：无参数执行即可汇总所有代理的总消耗，输出包含会话数、Token 明细（输入/输出/总计）、缓存命中（read/write）及分项成本。
时间窗口筛选：--offset 支持 30m、2h、7d 等相对时间，便于追踪近期支出趋势。
多维过滤：--agent <name> 和 --provider <name> 可组合使用，实现如"仅查看 main 代理的 Anthropic 调用"这类精准查询。
详情与表格模式：--details 展开单会话级数据（会话 ID、持续时间、时间戳）；配合 --table 可获得紧凑的终端表格视图，适合快速扫描。
多格式导出：原生支持 text（人类可读）、json（机器解析）、discord（聊天平台优化）三种输出格式，满足脚本集成、自动化告警、团队汇报等不同场景。
显著优点
1. 原生多代理支持：自动识别目录结构，无需手动指定多个路径，适合 OpenClaw 的模块化架构。
2. 缓存成本精确计算：区分 cache read（折扣价）与 cache write（全价），避免账单预估偏差。
3. 会话级可追溯：单会话查询（--details <id>）自动跨代理搜索，调试特定问题时无需知道文件位置。
4. 平台适配输出：Discord 格式专为聊天场景优化，使用 emoji 和粗体标记，提升可读性。
潜在局限
1. 生态绑定：依赖 OpenClaw 特定的目录结构与 JSONL 日志格式，无法直接用于其他 LLM 框架。
2. 离线计费：成本计算基于内置定价表，若供应商调整价格或存在企业折扣，可能产生偏差。
3. Node.js 依赖：执行环境要求预装 Node，轻量容器场景需额外准备。
4. 无实时告警：仅为事后分析工具，不具备预算阈值预警或 webhook 通知功能。
适用人群
- OpenClaw 重度用户：运行多个专用代理（如
main、codegen、research）需分账核算的团队。 - 成本控制敏感者：希望按模型、按代理监控支出，优化高成本模型（如 Claude Opus）调用策略。
- 自动化运维：需要将成本数据 JSON 化后导入 BI 系统或触发 CI 预算检查。
常规风险
- 隐私暴露：日志文件包含完整会话内容，分析时需确保目录权限正确，避免多用户环境泄露敏感 prompt。
- 路径注入：
--path参数接受任意目录，若被恶意利用可能读取系统其他 JSONL 文件，建议配合 chroot 或最小权限原则。 - 计费误差：缓存命中率与供应商账单可能存在统计口径差异，建议作为估算参考而非对账依据。