Token Alert

What This Skill Does

The Token Alert skill by r00tid is a vital monitoring tool designed for OpenClaw AI users to keep track of their LLM session token limits. By proactively monitoring your token consumption, the skill helps prevent the common frustration of being cut off mid-conversation or losing context due to hard usage caps. It provides a sophisticated, real-time calculation of your remaining tokens, utilizing a 6-level threshold system to keep you informed at every stage of your session. Featuring a rich visual dashboard with progress bars and automated notification triggers, this tool ensures you are always aware of your resource allocation without needing manual state tracking.

Installation

Installation is streamlined through the ClawdHub ecosystem. Simply execute clawdhub install token-alert in your terminal to initialize the service. If you prefer a manual setup, navigate to your local OpenClaw skills directory (~/clawd/skills) and clone the repository using git clone https://github.com/r00tid/clawdbot-token-alert token-alert. Once installed, the skill integrates directly with your existing agent workflows.

Use Cases

This skill is perfect for heavy users who perform long-form content generation, extensive data analysis, or complex coding tasks that consume significant context windows. It is particularly useful for users managing multi-step workflows where token exhaustion would cause a catastrophic failure of the agent's logic. By setting warnings as early as 25% and critical alerts at 95%, you can effectively plan your project milestones, decide when to start a fresh session, or adjust your prompt verbosity to extend the longevity of your current conversation context.

Example Prompts

1. "Open the token usage dashboard to check my remaining context limit."
2. "How many tokens do I have left in this session, and am I close to the limit?"
3. "Show me the current token status and tell me if I should start a new session soon."

Tips & Limitations

To maximize the utility of Token Alert, integrate the check command into your HEARTBEAT.md file to receive automated daily summaries. Keep in mind that this tool is stateless; it calculates usage on-demand, which ensures you always get the most accurate data directly from the Clawdbot session status. While it provides accurate estimations, always leave a buffer for final summary prompts. The skill does not throttle your usage; it purely serves as an observation tool, so proactive management of your prompts is still required when you hit the 95% emergency threshold.