核心用法
Claude Usage Calculator 是一款面向 Claude Max 订阅用户的用量追踪工具，通过解析 OpenClaw 本地会话数据，帮助用户精准掌握订阅配额消耗情况。
主要功能：
- 周预算监控：可视化展示已用积分 vs 周限额（Pro/5×/20× 三档计划），带进度条直观呈现剩余空间
- 5小时滑动窗口预警：基于逆向工程的速率限制机制，实时预警短期高频使用风险
- 会话级明细：支持按会话 ID 或关键词查询单一会话的 Token 消耗、模型分布及占比分析
- 多格式输出：默认终端表格 + JSON 接口，便于二次开发集成
技术实现：
- 基于 she-llac.com 逆向研究的积分计算公式（Input/Cache Write/Output 差异化费率）
- 自动检测
~/.openclaw/agents/main/sessions/本地数据目录 - 支持时区与计划类型灵活配置
显著优点
- 数据本地化：完全基于本地 JSONL 文件，无需上传敏感对话内容至第三方
- 计费透明化：破解 Claude 官方不公开的积分消耗机制，消除黑箱焦虑
- 轻量无依赖：纯 Python3.9+ 实现，无额外运行时负担
潜在局限
- 依赖 OpenClaw：需配合第三方客户端使用，官方 Claude 用户无法直接应用
- 逆向工程风险：积分公式源自社区逆向研究，Anthropic 官方调整计费策略时可能失效
- 适用范围窄：仅服务 Claude Max 订阅者，免费层用户无实际价值
适合人群
- 高频使用 Claude Opus/Sonnet 的开发者与研究员
- 需精细管控 API 等效成本的企业订阅用户
- 对计费机制有强洞察需求的 Claude Max 5×/20× 重度用户
常规风险
- 本地会话文件包含完整对话历史，需确保
~/.openclaw目录权限管控 - 工具本身不加密存储配置（周重置时间、计划类型），多用户环境建议隔离