← Back to Skills Marketplace
670
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install token-watch
Description
Track and analyze token usage and costs across AI providers with budget alerts, model cost comparison, optimization tips, and local data storage.
Usage Guidance
This package appears internally consistent with its stated purpose: a local-only token/cost monitor that needs no API keys. Before installing or enabling it for an agent, do the following: 1) Inspect the full tokenwatch.py file (and run it in a sandbox) to verify there are no network calls or unexpected behavior—while the imports shown are standard-library-only, you should confirm the truncated part of the shipped file is syntactically correct; 2) Be aware it writes usage and alerts to a .tokenwatch directory on disk—avoid recording sensitive prompt content there or protect the directory with file system permissions; 3) If you plan to pass provider response objects into the monitor, confirm those response objects do not themselves contain secrets you don't want stored; 4) Because the included file preview showed what looks like a truncated/typoed default (e.g., 'per_call_usd: Optional[float] = N'), run the package (or a linter) to ensure it runs without error—if an error exists, contact the maintainer or review the source on the linked repository before use. Overall this looks coherent and appropriate for the described function, but audit the shipped Python file and storage path before trusting it in production.
Capability Analysis
Type: OpenClaw Skill
Name: token-watch
Version: 1.2.3
The OpenClaw AgentSkills skill bundle 'token-watch' is classified as benign. The Python code (`tokenwatch.py`) strictly adheres to its stated purpose of tracking AI token usage and costs locally. It makes no external network calls, does not access sensitive system files or environment variables, and stores all data in a dedicated local directory (`.tokenwatch/`). The `SKILL.md` and `README.md` files contain no prompt injection attempts or instructions for the agent to perform actions outside the skill's described functionality. All claims of 'Zero telemetry', 'Local-only storage', and 'No API keys required' are verified by the code and manifest.
Capability Assessment
Purpose & Capability
The skill's name, README, manifest and SKILL.md all describe local-only token tracking, budgeting, model comparison and export features; the single Python file contains a pricing table and classes to record usage and budgets. No external credentials, binaries, or unrelated capabilities are requested, so the required resources are proportionate to the stated purpose.
Instruction Scope
SKILL.md instructs the agent to import TokenWatch, record usage (manually or via provider response objects), set budgets, and export reports. The instructions reference only a local storage path (.tokenwatch) and provider response objects; they do not instruct reading unrelated system files or accessing external endpoints. The autohooks to parse Anthropic/OpenAI response objects are expected for this purpose.
Install Mechanism
This is an instruction-only skill with source included; there is no install spec and no downloads. It relies only on the standard library. That is the lowest-risk install model and consistent with the claim of 'zero dependencies'.
Credentials
The skill requests no environment variables, no credentials, and no config paths. That aligns with the manifest and SKILL.md claim that it works locally and needs no API keys.
Persistence & Privilege
The skill stores data locally under the .tokenwatch directory (documented). It is not always-enabled and does not request elevated system privileges. Note: local storage of detailed usage could contain sensitive prompts/data depending on what you record—this is expected for a monitoring tool but worth being aware of.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install token-watch - After installation, invoke the skill by name or use
/token-watch - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.3
### [1.2.3] - 2026-02-16
- Bug fixes
v1.2.2
### [1.2.2] - 2026-02-16
- 📋 Updated SKILL.md model table to match code: 44 models across 10 providers
No code or functionality changes. Documentation update only.
v1.2.1
## Changelog
### [1.2.1] - 2026-02-16
- Updated SKILL.md to list 44 models across 10 providers (matching current code and pricing)
- No code or functional changes; documentation update only
v1.2.0
- Added DeepSeek, Meta Llama, MiniMax — 44 models across 10 providers; updated all Anthropic/OpenAI/Google/Mistral pricing to Feb 2026 rates
v1.0.0
- Initial release of TokenWatch.
- Track and analyze token usage and costs across major AI providers.
- Set budgets with automatic alerts for daily, weekly, monthly, and per-call thresholds.
- Compare model pricing, estimate API call costs, and receive actionable optimization tips.
- Automatically record usage from OpenAI and Anthropic SDK responses.
- Export full usage reports to JSON and view a dashboard with budget status.
- No dependencies, stores data locally, requires no API keys, and is fully open-source (MIT License).
Metadata
Frequently Asked Questions
What is Token Watch?
Track and analyze token usage and costs across AI providers with budget alerts, model cost comparison, optimization tips, and local data storage. It is an AI Agent Skill for Claude Code / OpenClaw, with 670 downloads so far.
How do I install Token Watch?
Run "/install token-watch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Token Watch free?
Yes, Token Watch is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Token Watch support?
Token Watch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Token Watch?
It is built and maintained by vs (@vedantsingh60); the current version is v1.2.3.
More Skills