clawculator

clawculator

Cost forensics for OpenClaw. Finds billing issues in your config, sessions, and workspace. Pure deterministic logic — no AI, no network calls, no external dependencies.

Source code is fully bundled in this skill folder. Nothing is fetched at runtime. You can audit every file before running.

Files this skill reads:

• ~/.openclaw/openclaw.json — your OpenClaw config
• ~/.openclaw/agents/main/sessions/sessions.json — session token usage
• ~/clawd/ — workspace root file count only (no file contents read)
• /tmp/openclaw — log directory (read only, if present)

Files this skill may write (only when --md is used):

• ./clawculator-report.md — markdown report
• Custom path via --out=PATH

No network requests are made. No shell commands are spawned.

Session keys are truncated in all output (first 8 chars + ellipsis) to avoid exposing sensitive identifiers.

---

Usage

When the user types clawculator, check my costs, analyze spend, or cost report, run:

node {baseDir}/run.js --md

Return the full markdown report to the user inline.

When the user types snapshot, share my grade, cost grade, clawculator snapshot, or what's my grade, run:

node {baseDir}/run.js --snapshot

Return the terminal card output to the user. This shows their grade (A+ to D), cost range, setup complexity, and findings — designed to be screenshot and shared.

Flags

• --snapshot — shareable grade card (terminal output, screenshot-ready)
• --md — write markdown report and print to stdout
• --json — machine-readable JSON to stdout
• --out=PATH — custom output path for --md
• node {baseDir}/run.js --help — full usage

What it catches

• 💓 Heartbeat running on paid model instead of Ollama
• 🔧 Skill polling loops on paid model
• 📱 WhatsApp groups auto-joined on primary model
• 🪝 Hooks (boot-md, command-logger, session-memory) on Sonnet
• 💬 Orphaned sessions still holding tokens
• 🤖 maxConcurrent too high — burst cost multiplier
• 📁 Workspace root bloat inflating context
• ⚙️ Primary model cost awareness

All findings include exact fix commands.