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.