← Back to Skills Marketplace
272
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install token-usage-monitor
Description
Monitor and display token usage metrics for AI models. Use when you need to track token consumption rates, view historical usage data, or get alerts about hi...
Usage Guidance
This skill appears coherent and local-only: it records token counts to a JSON file and offers CLI and integration points to instrument your model calls. Before installing: (1) inspect the Python file if you will run it; (2) note it will write usage data to a local file (documented as ~/.openclaw/token_usage.json) — the current implementation does not expand '~', so you may want to fix path handling (use os.path.expanduser) to ensure the file ends up where you expect; (3) integrating automatic tracking requires adding calls into your session wrapper/heartbeat as described — review those changes to avoid unintended behavior; (4) be cautious if you extend _check_thresholds to send emails or webhooks since that will require network endpoints and credentials; store any such credentials securely. Overall this is internally consistent with its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: token-usage-monitor
Version: 1.0.0
The token-usage-monitor skill is a legitimate utility designed to track and report AI model token consumption. The core logic in scripts/token_usage_tracker.py manages usage data locally in ~/.openclaw/token_usage.json and provides standard reporting and threshold alerting features without any evidence of data exfiltration, malicious execution, or unauthorized access to sensitive system resources.
Capability Assessment
Purpose & Capability
Name/description align with included code and docs: the repo provides a Python tracker, CLI examples, and integration guidance for instrumenting model calls. No unrelated credentials, binaries, or services are requested.
Instruction Scope
Runtime instructions and SKILL.md focus on tracking, reporting, and alerting. The script persists data to a file (documented as ~/.openclaw/token_usage.json) and integration guidance instructs modifying session startup/heartbeat to call the tracker—this is expected for the stated purpose. Implementation detail: the script calls os.makedirs(os.path.dirname(self.data_file)) but does not expand the tilde (~) in the default path, so it may create a literal directory named '~' relative to the working directory instead of ~/.openclaw; this is a bug to be aware of but not a security red flag.
Install Mechanism
Instruction-only skill with an included Python script. No install spec or remote downloads; nothing will be fetched or executed from external URLs during install.
Credentials
The skill requests no environment variables, credentials, or config paths. All data is local to a JSON file. The integration examples mention optional email/webhook alerts but those are commented/outlines — adding those would require adding credentials later, so review any extensions before enabling.
Persistence & Privilege
The skill does not request 'always' inclusion and does not modify other skills or global agent settings. It writes a single local data file for its own usage and is invocable by the user or by explicit integration code.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install token-usage-monitor - After installation, invoke the skill by name or use
/token-usage-monitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of token-usage-monitor.
- Monitor real-time token consumption per request, session, and model.
- Analyze historical token usage with daily, weekly, and monthly reports.
- Set custom token usage thresholds and receive alerts when limits are exceeded.
- Estimate costs based on token usage and model pricing to help optimize expenses.
- Includes a Python script for tracking, reporting, and managing token usage data.
Metadata
Frequently Asked Questions
What is Token Usage Monitor?
Monitor and display token usage metrics for AI models. Use when you need to track token consumption rates, view historical usage data, or get alerts about hi... It is an AI Agent Skill for Claude Code / OpenClaw, with 272 downloads so far.
How do I install Token Usage Monitor?
Run "/install token-usage-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Token Usage Monitor free?
Yes, Token Usage Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Token Usage Monitor support?
Token Usage Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Token Usage Monitor?
It is built and maintained by ttjsndx (@ttjsndx); the current version is v1.0.0.
More Skills