An automated utility for tracking, analyzing, and reporting API token consumption and costs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install token-tracker-daily
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install token-tracker-daily using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Token Tracker?
Token Tracker is a specialized tool designed to monitor and manage API token usage across your AI interactions. It automatically records input and output tokens for every session, providing a clear window into your consumption patterns and helping you plan your usage budget effectively.
Beyond simple logging, the skill utilizes historical data to analyze trends and provide month-end forecasts. This ensures that developers and teams can maintain cost control, identify unusual spikes in usage, and optimize their prompts or model selections based on factual data provided within the ecosystem of Openclaw Skills.
Token Tracker Use Cases
- Monitoring individual usage habits to understand personal AI consumption patterns.
- Tracking team-wide token exhaustion to manage shared API budgets and quotas.
- Real-time cost control to prevent unexpected overage charges from API providers.
- Optimizing LLM workflows by identifying high-consumption sessions that require context pruning.
How Token Tracker Works
- The skill logs input and output token counts after every session using a Python-based execution script.
- Data is persisted locally in a structured JSON format, aggregating multiple sessions into daily totals.
- Analysis scripts process the raw logs to calculate percentage changes, identify peak usage days, and detect anomalies.
- Reporting engines generate Markdown-formatted tables and visual trend indicators (up/down arrows).
- An optional cron-based scheduler pushes these reports to the user at specified intervals.
Token Tracker Setup
To integrate Token Tracker into your environment, follow these steps:
- Copy the skill to your local directory:
cp -r token-tracker /path/to/openclaw/skills/
- Grant execution permissions to the Python scripts:
chmod +x /path/to/openclaw/skills/token-tracker/scripts/*.py
- Restart your agent or reload your configuration to activate the Openclaw Skills integration.
Token Tracker Data Schema & Taxonomy
Token data is stored in data/token_log.json. The structure maintains daily summaries and granular session details:
| Field | Type | Description |
|---|---|---|
date |
String | ISO 8601 format date (YYYY-MM-DD) |
input |
Integer | Total input tokens for the day |
output |
Integer | Total output tokens for the day |
total |
Integer | Sum of input and output tokens |
sessions |
Array | List of objects containing time, input, and output |
Example session entry: {"time": "09:00", "input": 1200, "output": 800}
Token Tracker Advanced Features
- Trend Indicators: Visual markers like 📈 (Up), 📉 (Down), and 🔥 (Anomaly) based on percentage deviations.
- Automated Scheduling: Built-in support for cron tasks to deliver daily summaries at 22:00 or weekly reports on Monday mornings.
- Monthly Forecasting: Predictive modeling that estimates total monthly consumption based on the current run rate.
- Local Privacy: All consumption data is stored locally on your machine and never uploaded to external servers.
SKILL.md
Loading
Related Openclaw Skills
benchmark-lobster-forge
A metacognitive architect skill that identifies high-value AI agent opportunities and converts them into standardized benchmark lobster blueprints.
Urban Daoist Navigator
A high-performance daily planning assistant that blends Eastern philosophy with modern urban life to provide mental framing for developers, traders, and founders.
Move to China Living Guide
A comprehensive practical companion for expats and digital nomads navigating the cultural, social, and daily logistics of long-term living in China.
Tavily Search
A high-performance web search skill that integrates the Tavily API to provide AI agents with real-time web data and concise answer summaries.
PDF Toolkit
A comprehensive suite of scripts for professional-grade PDF manipulation, conversion, and optimization.
H-Anime Search Scraper
A specialized web scraping utility designed to monitor and retrieve update information from specific media platforms.
Featured*
