核心用法
Token Cost Estimator 是一个本地化成本分析工具，用于从 OpenClaw 代理会话转录中计算真实 API 费用。它通过扫描 ~/.openclaw/agents/<agent>/sessions/*.jsonl 文件，解析每轮对话的 token 消耗，并基于 Anthropic 官方定价（Opus/Sonnet）输出成本预估。
关键操作步骤：
1. 运行 Python 脚本遍历所有代理目录
2. 解析 JSONL 中的 role/content 字段，按字符数÷4 估算 token
3. 自动计算「上下文重发」成本——这是对话式 API 的最大隐性支出（每轮新消息都会重新发送完整历史）
4. 支持 60%-90% 缓存命中率模拟，输出多场景对比
显著优点
- 真实成本还原：考虑上下文重发机制，比简单累加 token 更准确
- 订阅决策支持：明确对比 API 按量计费 vs Claude Max ($100/$200) 订阅的盈亏平衡点
- 全代理覆盖：一次性分析所有历史会话，识别高消耗代理
- 离线运行：纯本地脚本，无需上传敏感对话数据
潜在局限与风险
| 局限类型 | 说明 |
|---------|------|
| 估算偏差 | 系统提示、工具定义、内部重试未计入，实际成本通常为估算值的 **1.5-2 倍** |
| 字符÷4 近似 | 真实 token 化规则更复杂，长中文内容误差可能达 ±20% |
| 定价时效性 | 需手动更新 PRICING 字典，未及时跟进 Anthropic 调价 |
| 订阅政策风险 | Anthropic 已限制第三方工具的 OAuth token 使用，Max 订阅未必可用 |
适合人群
- 高频使用 OpenClaw/Claude Code 的开发者，月 API 费用超 $50
- 需要向团队/管理层证明订阅方案经济性的技术负责人
- 希望识别「对话设计优化空间」以降本增效的 AI 应用架构师
常规风险提醒
- 隐私：脚本读取本地完整会话历史，建议在可信环境运行
- 决策延迟：API 定价与订阅政策变动频繁，建议定期重新评估
- 缓存假设：90% 缓存命中率是理想值，复杂多轮对话可能仅达 60%