tokenQrusher Skill

Overview

tokenQrusher reduces OpenClaw API costs by 50-80% through:

1. Context Filtering – Loads only necessary workspace files (up to 99% reduction for simple messages)
2. Heartbeat Optimization – Reduces heartbeat API calls by 75%

This is the simplified, production-ready core. Non-functional advisory components have been removed.

Components

1. Context Hook (token-context)

Event: agent:bootstrap

Filters which workspace files are loaded based on message complexity.

Config: ~/.openclaw/hooks/token-context/config.json

{
  "enabled": true,
  "logLevel": "info",
  "dryRun": false,
  "files": {
    "simple": ["SOUL.md", "IDENTITY.md"],
    "standard": ["SOUL.md", "IDENTITY.md", "USER.md"],
    "complex": ["SOUL.md", "IDENTITY.md", "USER.md", "TOOLS.md", "AGENTS.md", "MEMORY.md", "HEARTBEAT.md"]
  }
}

How it works:

• Extracts the user's latest message
• Classifies complexity (simple/standard/complex)
• Keeps only allowed files, discards the rest
• Sets context.bootstrapFiles to the filtered list

Savings:

• Simple greetings → 2 files (99% token reduction)
• Standard tasks → 3 files (90%+ reduction)
• Complex tasks → all files (full context)

Rationale: Simple messages don’t need documentation, memory logs, or tool references. Only identity and personality are required.

2. Heartbeat Optimizer (token-heartbeat)

Event: agent:bootstrap (for heartbeat polls)

Optimizes heartbeat check schedule to dramatically reduce API calls.

Config: ~/.openclaw/hooks/token-heartbeat/config.json

{
  "enabled": true,
  "intervals": {
    "email": 7200,
    "calendar": 14400,
    "weather": 14400,
    "monitoring": 7200
  },
  "quietHours": { "start": 23, "end": 8 }
}

How it works:

• Determines if enough time has elapsed since last check
• Skips checks that are not due
• Honors quiet hours (23:00–08:00 by default)
• Returns HEARTBEAT_OK when nothing needs checking

Optimization Table:

Result: 48 checks/day → 12 checks/day (75% fewer API calls)

3. Shared Module (token-shared)

Pure functions used by both hooks:

• classifyComplexity(message) → complexity level
• getAllowedFiles(level, config) → file list
• isValidFileName(name) → path traversal protection
• loadConfigCached(logFn) → 60s TTL config caching
• Maybe/Either patterns (no exceptions for control flow)

External Endpoints

This skill does not call any external network endpoints. All operations are local to your machine.

Security & Privacy