← Back to Skills Marketplace
1915
Downloads
3
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install tokenguard
Description
API cost guardian for AI agents. Track spending, enforce limits, prevent runaway costs. Essential for any agent making paid API calls.
Usage Guidance
TokenGuard appears coherent and limited to local budgeting: it reads/writes JSON under ~/.tokenguard and exposes check/log commands you can call from agents or scripts. Before installing, review the complete scripts/tokenguard.py file (the submitted copy was truncated), verify the repository/homepage match the distributed file, and confirm there are no hidden network calls or unexpected file accesses. Use a dedicated non-sensitive directory for TOKENGUARD_DIR, keep file permissions minimal, and be aware that an automated agent with permission to run the script could set the 'override' flag to bypass limits — ensure your agent's policy/control flow prevents unintended overrides.
Capability Analysis
Type: OpenClaw Skill
Name: tokenguard
Version: 1.0.0
The OpenClaw AgentSkills skill bundle 'tokenguard' is a benign utility designed to track and limit API spending for AI agents. The `SKILL.md` documentation clearly outlines its purpose and usage, without any prompt injection attempts or instructions for the agent to perform unauthorized actions. The core script `scripts/tokenguard.py` implements the described functionality, storing its data (limit, session, override flag) in a dedicated directory (`~/.tokenguard` by default) within the user's home directory. It uses standard Python libraries, reads only its own configuration environment variables, and does not exhibit any signs of data exfiltration, malicious execution, persistence mechanisms, or obfuscation. All file operations and capabilities are strictly aligned with its stated purpose of API cost management.
Capability Assessment
Purpose & Capability
The name/description (API cost guardian) aligns with the included code and SKILL.md: the script implements set/check/log/history/reset/extend/override and stores state under ~/.tokenguard (or TOKENGUARD_DIR). No unrelated services, credentials, or system subsystems are requested.
Instruction Scope
Runtime instructions are scoped to running the local Python script and storing/retrieving JSON in its own directory. Integration guidance uses subprocess to call the script (expected). The SKILL.md does not instruct reading other system config, secrets, or sending data to external endpoints.
Install Mechanism
There is no automatic install action (instruction-only). Manual install steps simply copy the SKILL.md and the script; that is low-risk. The package declares a GitHub repository but does not pull remote code during install.
Credentials
No required environment variables or credentials are declared; SKILL.md documents optional env vars (TOKENGUARD_DIR, TOKENGUARD_DEFAULT_LIMIT, TOKENGUARD_WARNING_PCT) used only to configure storage and defaults. No secrets or external API keys are requested.
Persistence & Privilege
The skill writes only to its own directory (~/.tokenguard by default) and does not request always:true or modify other skills. It can be invoked autonomously (platform default), which is normal for skills; note that the 'override' feature allows a one-time bypass and could be invoked programmatically if an agent is permitted to run commands.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tokenguard - After installation, invoke the skill by name or use
/tokenguard - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is TokenGuard?
API cost guardian for AI agents. Track spending, enforce limits, prevent runaway costs. Essential for any agent making paid API calls. It is an AI Agent Skill for Claude Code / OpenClaw, with 1915 downloads so far.
How do I install TokenGuard?
Run "/install tokenguard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is TokenGuard free?
Yes, TokenGuard is completely free (open-source). You can download, install and use it at no cost.
Which platforms does TokenGuard support?
TokenGuard is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created TokenGuard?
It is built and maintained by G0HEAD (@g0head); the current version is v1.0.0.
More Skills