← Back to Skills Marketplace
gerhardvr26

Token Usage Tracker

by gerhardvr26 · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
338
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install oken-usage-tracker
Description
Token usage logging, alerting, and context-compression utilities for OpenClaw. Use when you want to track per-call token usage, normalize timestamps, and red...
Usage Guidance
This skill appears to do exactly what it says: local token accounting, timestamp conversion, simple summarization, and example alerting. Before installing or deploying: 1) Read the scripts (they are small) and choose a safe log_folder (not a world-readable or system directory). 2) Restrict filesystem permissions for the log folder and consider rotating/retention to avoid unbounded disk growth. 3) Audit what you log — call payloads may include sensitive data; add redaction or avoid logging full contexts if privacy is a concern. 4) Do not enable or add webhook/web network calls (token_alerts hints at this) unless you trust the endpoint and sanitize data. 5) If you deploy the systemd example, update ExecStart path and User from the sample values before enabling. 6) Test in a controlled environment first. Overall: coherent and low-risk if used as-local examples and properly configured.
Capability Analysis
Type: OpenClaw Skill Name: oken-usage-tracker Version: 1.0.0 The skill bundle provides utilities for token usage logging, alerting, and context compression, aligning perfectly with its stated purpose. All scripts perform local file I/O within a designated log folder and read a local configuration file. There is no evidence of data exfiltration, malicious execution, or unauthorized persistence. The `README.md` contains a prompt for the AI agent to 'package' the skill, but this is a benign meta-instruction related to skill management, not a malicious prompt injection attempt.
Capability Assessment
Purpose & Capability
Name/description (token logging, alerts, summarization) match the provided scripts. All scripts operate locally, use only standard Python libraries, and require no external credentials or unrelated binaries.
Instruction Scope
SKILL.md instructs installing/wiring example scripts into your pipeline and using the summarizer. The scripts do perform filesystem actions (create ./skills/logs, append JSONL logs, replace files during migration/dedupe). The README and SKILL.md state the examples are safe and won't change system services automatically — this is true for services, but the scripts do modify local disk state (logs, tmp files). Also token_alerts includes a comment about replacing prints with webhooks; while not active by default, modifying scripts to post externally could exfiltrate logged data. The interceptor will process message payloads (which may contain sensitive content) and forward logging info, so review/redact before use.
Install Mechanism
There is no install spec (instruction-only). The package contains example Python scripts only — no downloads, packaged installers, or remote code execution. Risk from install mechanism is low.
Credentials
The skill requests no environment variables, no credentials, and no config paths beyond the provided skill-config.json. Log files are written under a relative ./skills/logs by default; this is proportional to the stated logging purpose.
Persistence & Privilege
always is false; the skill does not request persistent platform privileges or modify other skills. Scripts write and rotate/replace local log files under their own paths only.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install oken-usage-tracker
  3. After installation, invoke the skill by name or use /oken-usage-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
• Short description: Logs per‑call token usage, normalizes timestamps, and provides simple summarization and alert examples for OpenClaw. • Long description / Changelog (paste into “description” or “changelog”): • v1.0.0 — Initial release. Includes example scripts (token_tracker, token_interceptor, context_summarizer, token_alerts, migrate_timestamps, dedupe_log), skill-config.json (defaults: timezone=UTC, log_folder=./skills/logs), and example systemd unit. Safe examples only — no services enabled by default.
Metadata
Slug oken-usage-tracker
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Token Usage Tracker?

Token usage logging, alerting, and context-compression utilities for OpenClaw. Use when you want to track per-call token usage, normalize timestamps, and red... It is an AI Agent Skill for Claude Code / OpenClaw, with 338 downloads so far.

How do I install Token Usage Tracker?

Run "/install oken-usage-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Token Usage Tracker free?

Yes, Token Usage Tracker is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Token Usage Tracker support?

Token Usage Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Token Usage Tracker?

It is built and maintained by gerhardvr26 (@gerhardvr26); the current version is v1.0.0.

💬 Comments