Setup & Installation
openclaw skills install @qsmtco/tokenqrusher
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install tokenqrusher
What This Skill Does
tokenQrusher reduces OpenClaw API token costs by 50-80% through two hooks: one that loads only the workspace files needed for a given message's complexity, and one that stretches heartbeat check intervals. All processing runs locally with no external calls.
Rather than manually trimming prompts, it classifies each message automatically and strips irrelevant context before the agent ever sees it.
When to use it
- Cutting monthly API bills for a busy personal OpenClaw agent
- Loading minimal context for quick greetings and one-liners
- Suppressing heartbeat polls during overnight quiet hours
- Checking which files would load for a specific prompt before running it
- Reducing API call volume for calendar and email polling
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: 'hi'
AGENT
- 1token-context hook fires on agent:bootstrap
- 2Classifies message complexity as 'simple' with 95% confidence
- 3Filters workspace files down to SOUL.md and IDENTITY.md
- 4Passes filtered file list to the agent instead of full context
OUTPUT
Agent bootstraps with 2 files instead of 7, saving up to 99% of context tokens for that message