核心用法
clawculator 是一款面向 OpenClaw 用户的成本审计工具，专用于分析配置、会话和工作空间中的计费隐患。用户可通过关键词触发（如 clawculator、check my costs、analyze spend、cost report），工具将以纯 Node.js 脚本形式本地执行，生成 Markdown 或 JSON 格式的成本报告。
执行方式：
node {baseDir}/run.js --md # 生成可读报告
node {baseDir}/run.js --json # 机器可读格式检测范围涵盖：
- 心跳机制误用付费模型（未切换至 Ollama）
- Skill 轮询循环消耗付费模型额度
- WhatsApp 群组自动加入主模型
- Hooks（boot-md、command-logger、session-memory）挂载于 Sonnet
- 孤儿会话持续占用 token
- maxConcurrent 过高导致突发成本乘数
- 工作区根目录膨胀推高上下文成本
每项发现均附带精确的修复命令，降低用户操作门槛。
---
显著优点
| 特性 | 说明 |
|------|------|
| **完全离线执行** | 源码已全量打包，零运行时网络请求，零外部依赖 |
| **可审计性** | 所有文件可在执行前人工审查，符合安全敏感场景需求 |
| **隐私保护** | 会话密钥输出截断处理（前8位+省略号），避免敏感标识泄露 |
| **精准定位** | 针对 OpenClaw 架构设计，覆盖高频成本陷阱场景 |
| **零权限风险** | 不执行任何 shell 命令，仅读取指定配置文件与元数据 |
---
潜在缺点与局限性
- 生态绑定：专为 OpenClaw 设计，无法迁移至其他平台
- 检测覆盖有限：仅针对已知计费模式，新型成本陷阱需版本更新
- 无实时告警：离线分析工具，不具备持续监控能力
- Node 环境依赖：需目标系统预装 Node.js 二进制文件
- 仅读工作区元数据：不分析文件内容，可能遗漏上下文成本细节
---
适合人群
- OpenClaw 重度用户，需定期审计账单异常
- 多 Skill/Hook 配置的复杂场景用户
- 对成本敏感、追求确定性计费控制的开发者
- 安全合规要求严格、需完全离线工具的企业环境
---
常规风险
| 风险类型 | 评估 |
|---------|------|
| 数据泄露 | 极低 — 无网络传输，密钥已脱敏 |
| 权限提升 | 无 — 仅读取用户自有配置，无系统级操作 |
| 供应链攻击 | 低 — 全量打包源码，无运行时下载 |
| 误报/漏报 | 中 — 依赖规则库更新，复杂场景可能覆盖不全 |