Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Tagged electron-essential, updated README with ClawHub install
What This Skill Does
Tracks LLM token usage and calculates API-equivalent costs, storing all data locally in SQLite at ~/.tokenmeter/usage.db. Session files from OpenClaw and Claude Code are parsed to produce per-model cost breakdowns, including prompt cache read and write tokens. Shows how much a flat-rate subscription like Claude Max saves compared to pay-as-you-go API billing.
It accounts for prompt cache read and write tokens separately, which most cost calculators ignore, giving a more accurate API-equivalent spend figure.
When to use it
- Checking how much you spent on Claude this week
- Comparing Claude Max plan value against API billing costs
- Finding which models account for the largest share of spending
- Monitoring daily token usage across multiple agent instances
- Month-end billing reconciliation before the billing cycle closes
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: how much did we spend this week?
- 1Checks if tokenmeter is installed at ~/clawd/tokenmeter, clones and sets up the Python venv if missing
- 2Activates the venv and runs tokenmeter import --auto to pull in latest session files
- 3Runs tokenmeter costs --period week to get a per-model cost breakdown
- 4Parses output to extract totals and per-model percentages
- 5Responds with a plain-English summary including Max plan savings estimate
Weekly API-equivalent cost broken down by model, with savings compared to the flat subscription cost