- name
- token-optimizer
- description
- Automatically analyze and reduce OpenClaw token waste through context compression, tool-call deduplication insights, model selection guidance, and session hygiene checks. Use when sessions are nearing context limits, costs are climbing, or you want proactive token optimization before expensive tasks.
Token Optimizer
Overview
Use this skill to optimize OpenClaw token usage with a local CLI that performs analysis, compression snapshots, health checks, cleanup planning, and preflight token budgeting.
Quick Start
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --analyze --period 7dCore Commands
1) Enable local optimizer config:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --enable2) Optimization analysis:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --analyze --period 7d3) Force context compression snapshot:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --compress --threshold 0.7 --session agent:main:main4) Session health check:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --health-check --active-minutes 1205) Auto-cleanup planning and apply:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --cleanup
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --cleanup --applyPreflight Optimization
Use preflight planning before expensive task batches:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize \
--preflight /path/to/actions.json \
--session-limit 180000actions.json should be a JSON array of planned operations, for example:
[
{"type": "web_search", "query": "..."},
{"type": "web_fetch", "url": "..."},
{"type": "summarize", "target": "youtube"}
]Output Artifacts
- Compression snapshots:
$OPENCLAW_WORKSPACE/token-usage/compressed/ - Optional JSON output:
--format json --output /path/file.json - Baseline config (from
--enable):$OPENCLAW_WORKSPACE/token-usage/token-optimizer.config.json
Defaults
Default behavior is configured in:
config/defaults.json
Override with:
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --config /path/custom.json --analyzeResources
scripts/token_optimize.py: main CLIsrc/optimizer.py: core optimization enginesrc/models.py: model selection logicsrc/compression.py: context compression helperssrc/cleanup.py: session hygiene evaluationreferences/operating-notes.md: implementation details and safe-operating guidance
Validation
python3 $OPENCLAW_SKILLS_DIR/.system/skill-creator/scripts/quick_validate.py \
$OPENCLAW_SKILLS_DIR/token-optimizer