Introduction
# Token Optimizer for OpenClaw
Slash your AI costs from $1,500+/month to under $50/month.
## The Problem
OpenClaw defaults prioritize capability over cost. You're burning expensive Sonnet/Opus tokens on tasks Haiku handles perfectly, paying for API heartbeats that could run free locally, and loading 50KB of context when 8KB suffices.
## The Solution
Four core optimizations plus powerful tooling:
### Model Routing (92% savings) Haiku by default, Sonnet/Opus only when needed
### Multi-Provider Heartbeats (100% savings) Route heartbeats to Ollama, LM Studio, Groq, or disable entirely. Not locked to one provider.
### Session Management (80% savings) Load 8KB instead of 50KB context
### Caching (90% savings) Reuse prompts at 10% cost
### New in v1.0.8 - **Rollback** - List and restore config backups instantly - **Health Check** - Quick system status in one command - **Diff Preview** - See exactly what changes before applying - **--no-color** - CI/pipeline friendly output
## Cost Comparison
| Period | Before | After | |--------|--------|-------| | Daily | $2-3 | $0.10 | | Monthly | $70-90 | $3-5 | | Yearly | $800+ | $40-60 |
## What's Included
- One-command optimizer with diff preview - Multi-provider heartbeat (Ollama, LM Studio, Groq) - Config rollback and health check commands - Ready-to-use config templates - SOUL.md & USER.md templates - Optimization rules for agent prompts - Verification and savings reports - Cross-platform CLI (Windows, macOS, Linux)
## Quick Start
```bash # Install clawhub install token-optimizer
# Analyze current setup python cli.py analyze
# Preview changes (dry-run with diff) python cli.py optimize --dry-run
# Apply all optimizations python cli.py optimize
# Verify setup python cli.py verify
# Quick health check python cli.py health
# Configure heartbeat provider (ollama, lmstudio, groq, none) python cli.py setup-heartbeat --provider ollama
# List and restore backups python cli.py rollback --list python cli.py rollback --to <backup-file> ```
## Configuration Generated
```json { "agents": { "defaults": { "model": { "primary": "anthropic/claude-haiku-4-5" }, "cache": { "enabled": true, "ttl": "5m" } } }, "heartbeat": { "provider": "ollama", "model": "ollama/llama3.2:3b" }, "budgets": { "daily": 5.00, "monthly": 200.00 } } ```
## Links
- **GitHub**: https://github.com/smartpeopleconnected/openclaw-token-optimizer - **Issues**: https://github.com/smartpeopleconnected/openclaw-token-optimizer/issues
## Author
**Smart People Connected** - GitHub: [@smartpeopleconnected](https://github.com/smartpeopleconnected) - Email: [email protected]
## License
MIT License - Free to use, modify, and distribute.
---
*5 minutes to setup. 97% cost reduction. Stop burning tokens. Start building.*