核心用法
Session Cost 是专为 OpenClaw 设计的 CLI 成本分析工具，自动扫描 ~/.openclaw/agents/ 目录下的 JSONL 会话日志，按 Agent 和模型分组统计 Token 用量与 API 支出。
基础操作：
- 全局汇总：
node scripts/session-cost.js - 详细明细：
--details展示单会话级数据 - 时间过滤：
--offset 24h/7d限制统计范围 - 多维度筛选：
--agent main、--provider anthropic精准定位
输出格式：
- Text：层级清晰的终端报表，含 Agent/模型/总计三段式结构
- Table：紧凑表格视图，适合快速浏览多会话
- JSON：结构化数据，便于二次处理
- Discord：聊天友好的 Markdown 格式，自动聚合 Top 模型与提供商
显著优点
1. 多 Agent 原生支持：自动发现目录结构，跨 Agent 聚合与单 Agent 聚焦无缝切换
2. 精细化成本拆解：区分 input/output/cache read/cache write 四类计费维度，准确反映 Anthropic 等平台的缓存折扣机制
3. 灵活的时空过滤：支持相对时间（30m/2h/7d）、特定会话 ID 检索、自定义路径扫描
4. 多场景输出：从本地终端调试到 Discord Bot 集成，覆盖开发监控与团队汇报场景
潜在局限
- 依赖本地文件系统：仅支持本地 JSONL 日志，无法对接云端日志或实时流
- Node.js 环境限制：需预装 Node 运行时，对纯容器/无 Node 环境不友好
- 定价模型静态：成本计算依赖内置或外部定价表，若提供商调价需手动更新
- 无持久化存储：每次运行重新扫描全量日志，大规模历史数据可能产生 I/O 瓶颈
适合人群
- OpenClaw 多 Agent 开发者：监控各 Agent 实际 API 开销
- 团队成本管理员：按时间/项目/Agent 生成消费报告
- 自动化运维：配合 CI/CD 或定时任务进行成本告警
常规风险
- 数据隐私：扫描本地会话日志可能暴露提示词与模型响应内容，共享输出时需谨慎
- 成本估算误差：缓存命中率、模型版本映射可能存在偏差，实际账单以提供商为准
- 路径遍历风险：若配置
--path指向用户可控目录，需防范恶意 JSONL 文件解析攻击