Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Monitors Clawdbot session token usage and sends alerts when usage crosses configurable thresholds (25%, 50%, 75%, 90%, 95%, 100%). Provides both a terminal script for on-demand checks and an HTML dashboard with a visual progress bar. Operates statelessly, calculating usage live via the session_status tool.
Because it runs statelessly with no file management, usage data is always calculated from the live session rather than a potentially stale snapshot.
When to use it
- Checking remaining token budget before starting a long research task
- Getting a Telegram alert when a session reaches 90% capacity
- Adding a daily token usage check to a Clawdbot HEARTBEAT routine
- Opening a visual dashboard to monitor consumption mid-conversation
- Deciding when to wrap up and start a fresh session before hitting the limit
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Check token status
- 1Runs check.py script
- 2Queries Clawdbot session_status tool for current token count
- 3Calculates usage percentage against the session limit
- 4Compares percentage against configured thresholds
- 5Displays progress bar with usage stats and a recommended action
Terminal output: '▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▱▱▱▱▱▱ 78.0% — 156,000 / 200,000 tokens used, estimated <1 session remaining, recommendation: prepare new session'
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.