Software · Agent plugin

CostClaw

A local telemetry dashboard for understanding the token and monetary cost of persistent AI-agent work.

Compendium article 015 Revision 0.6 · July 2026

Persistent agents can turn computational spending into background noise. A long-running system may be productive, wasteful, or both, but without telemetry the difference is difficult to see until after the bill arrives.

The project takes the form of a TypeScript, SQLite, and dashboard tool that collects and summarizes cost telemetry from an OpenClaw-style agent environment. Its purpose is to make agent operating costs visible enough to budget, compare, and debug.

The question behind CostClaw

CostClaw was designed as an observability layer for that problem. Instead of treating token usage as an incidental provider statistic, it organizes cost around agent work so an operator can compare runs, notice unusual consumption, and ask whether autonomy is economically justified. People operating autonomous or long-running agents may benefit. Logs can contain sensitive prompts or identifiers, so public analytics must be scrubbed or synthetic.

How CostClaw took shape

The implementation used TypeScript, SQLite, collection hooks, summaries, and a local dashboard inside an OpenClaw-style environment. A v0.1 release and public discussion demonstrated interest in the problem, though not durable compatibility or verified savings. Josiah identified the cost-visibility problem, set the product direction, evaluated the tool in practice, and used coding agents for implementation.

What the evidence supports

A v0.1 implementation shipped in 2026 and its launch discussion received substantial attention, but the current repository and integrations have not yet been revalidated. Its present value depends on an audit. Agent platforms and pricing models change quickly, so a historical telemetry plugin can look functional while reporting the wrong thing. If CostClaw is now obsolete, the honest article still records an early attempt to make agent economics observable.

The tool may be obsolete as agent platforms change, and known repository issues have not been audited. No private logs or credentials belong in the public case study. Its next decision point is a modern technical audit: viable paths can be repaired, while a tool made redundant by current platforms can be archived with a clear explanation.