← Back to Skills Marketplace
1098
Downloads
1
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install token-budget-monitor
Description
Track and control token consumption across OpenClaw cron jobs
Usage Guidance
This skill appears to do what it says: it reads config.json in the skill folder and writes a local usage file to ~/.openclaw/workspace/outputs/token-usage.json. It asks for no credentials and makes no network calls. Before installing: 1) Review and, if desired, change the OUTPUT_DIR path to a location you control and ensure appropriate file permissions. 2) Do not paste untrusted values into the integration command as shown; avoid building shell commands by concatenation. Instead invoke the script with a safe argument array (child_process.spawn or execFile) or validate/sanitize job and model names to prevent command injection. 3) If you plan to run this under different users or CI, verify how HOME is set (code falls back to /home/ubuntu). 4) Run it in a sandbox or test environment first to confirm it writes only the expected JSON file. Overall this skill is internally consistent and low-risk for typical usage.
Capability Analysis
Type: OpenClaw Skill
Name: token-budget-monitor
Version: 1.0.0
The SKILL.md file contains an 'Integration' example that demonstrates a shell injection vulnerability. The `exec` call constructs a shell command by directly concatenating potentially untrusted inputs (`<job-name>` and `model`) without proper sanitization. This flaw could allow an attacker to execute arbitrary commands on the host system if they can control these input parameters, for example, through a malicious LLM response. This is a critical vulnerability, but there is no clear evidence of intentional malicious behavior (e.g., data exfiltration, backdoors) within the provided code or instructions, thus classifying it as suspicious rather than malicious.
Capability Assessment
Purpose & Capability
Name and description (token-budget monitoring for cron jobs) align with the files and code: track-usage.js implements per-job tracking, daily limits, alerts, and model recommendations. Required resources (no env vars, no external binaries) are proportionate to the stated functionality.
Instruction Scope
Runtime instructions stay within scope (run the CLI commands and add a call after LLM calls). One minor concern: the Integration example recommends building a shell command via string concatenation passed to exec (exec('node /path/to/track-usage.js track <job-name> ' + usage.input_tokens + ' ' + usage.output_tokens + ' ' + model)). That pattern can lead to shell-injection if job or model values are attacker-controlled. Otherwise the SKILL.md does not instruct reading unrelated files or sending data externally.
Install Mechanism
Instruction-only skill with no install steps and no downloads — lowest-risk install model. There are local code files but nothing is fetched from external URLs.
Credentials
No environment variables, no secrets, and only minimal use of HOME (to choose output dir) — consistent with the purpose. The code reads a local config.json in the skill directory; no unexpected credential or config paths are requested.
Persistence & Privilege
Does not request permanent/always-on privileges, does not modify other skills or system-wide config. It writes usage data to ~/.openclaw/workspace/outputs/token-usage.json which is a limited persistence scope and expected for this tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install token-budget-monitor - After installation, invoke the skill by name or use
/token-budget-monitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release – track and control token consumption for OpenClaw cron jobs.
- Monitor and report token usage by job, with daily and per-job limits.
- Alerts when budgets are close to or exceeded.
- Integration hooks for cron jobs and OpenClaw fallback chains.
- Configuration options for limits, thresholds, and free model recommendations.
- Includes command-line utilities to check status, check budgets, raise alerts, and get model recommendations.
Metadata
Frequently Asked Questions
What is Token Budget Monitor?
Track and control token consumption across OpenClaw cron jobs. It is an AI Agent Skill for Claude Code / OpenClaw, with 1098 downloads so far.
How do I install Token Budget Monitor?
Run "/install token-budget-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Token Budget Monitor free?
Yes, Token Budget Monitor is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Token Budget Monitor support?
Token Budget Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Token Budget Monitor?
It is built and maintained by aviclaw (@aviclaw); the current version is v1.0.0.
More Skills