← Back to Skills Marketplace
12758
Downloads
30
Stars
0
Active Installs
20
Versions
Install in OpenClaw
/install openclaw-token-optimizer
Description
OpenClaw Token Optimizer v3.2.0 — practical cost-control toolkit for OpenClaw agents. Lazy context loading, Sonnet/Opus-aware routing, heartbeat scheduling,...
Usage Guidance
Install only if you want local token-budget, model-routing, and heartbeat optimization helpers. Before using the install/write commands, review the generated AGENTS.md or HEARTBEAT.md content because those files can shape future agent behavior; treat optional provider config examples as manual changes that may require third-party API keys.
Capability Assessment
Purpose & Capability
The scripts match the stated purpose: context recommendations, model routing, heartbeat scheduling, and budget state checks. Static review found no executable network calls, subprocess use, dynamic code execution, or credential exfiltration behavior.
Instruction Scope
The generated AGENTS.md and HEARTBEAT.md templates can influence future agent behavior, but the artifacts disclose this and keep preview/no-write behavior as the default for the main template commands.
Install Mechanism
Installation is via normal ClawHub/OpenClaw or optional manual GitHub clone instructions. Documentation repeatedly references a .clawhubsafe integrity manifest, but that manifest is not present in the provided artifact bundle, so that verification path may not work.
Credentials
Local JSON state under ~/.openclaw/workspace/memory and optional workspace template writes are proportionate to token tracking and scheduling. External provider/API-key references appear in documentation and config examples, not in runtime network code.
Persistence & Privilege
Persistence is limited to local state files, an opt-in HEARTBEAT.md install with backup, and opt-in AGENTS.md.optimized output. Users should review these templates before adopting them because they affect later agent sessions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-token-optimizer - After installation, invoke the skill by name or use
/openclaw-token-optimizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
v3.2.0: Modernized ClawHub listing, refreshed first-screen copy, clarified OpenClaw 2026.6.x Sonnet/Opus routing, highlighted audit-safe writes and security posture, updated README/license badge, and regenerated .clawhubsafe.
v3.0.0
**Major update: v3.0 introduces lazy skill loading and restructures optimization logic for maximum token savings.**
- Added native support and documentation for lazy skill loading (SKILLS.md-based), now the largest single optimization.
- Removed bundled cronjob guide and multi-provider reference/config files; external strategies are now referenced but not included.
- Simplified documentation to focus on core, local-only optimizations and integration patterns.
- Updated AGENTS.md and heartbeat optimization templates for compatibility with session pruning and newer OpenClaw features.
- All scripts and documentation updated for consistency with v3.0 best practices.
v1.4.3
v1.4.3: README completely rewritten — correct name (OpenClaw Token Optimizer), version badge (1.4.3), ClawHub install command, Apache 2.0 license, all skill paths corrected. GitHub now shows the right name and current version.
v1.4.2
v1.4.2: Security scan fixes — added homepage/source/author to SKILL.md frontmatter (resolves 'Source: unknown'), added optimize.sh to .clawhubsafe SHA256 manifest (was missing from integrity check), added explicit optimize.sh security section in SECURITY.md with full source disclosure, added Provenance section with GitHub + ClawHub links. All v1.4.0 features intact.
v1.4.1
v1.4.1: Fix public visibility — added .clawhubignore to exclude PR-DESCRIPTION.md (contained shell commands that triggered security scanner) and docs/ dev artifacts. All v1.4.0 features intact: session pruning, bootstrap size limits, cache retention, cache TTL alignment.
v1.4.0
v1.4.0: Native OpenClaw 2026.2.15 features — session pruning, bootstrap size limits, cache TTL alignment. Compliance 72%→92%+.
v1.3.3
Name fix: restored correct display name 'OpenClaw Token Optimizer' (was incorrectly shortened to 'Token Optimizer' in 1.3.1/1.3.2). No code changes from 1.3.2.
v1.3.2
Security transparency fix: (1) SKILL.md frontmatter no longer falsely claims no_network:true for the whole skill — now correctly scopes the no-network guarantee to the 4 executable scripts only; (2) config-patches.json adds _notice and _warning fields clearly marking multi_provider_fallback as requiring external API keys; (3) SECURITY.md rewritten with two-category breakdown (scripts vs reference docs) explaining exactly what VirusTotal flags and why; (4) .clawhubsafe now covers SECURITY.md too; (5) all 10 checksums clean, zero warnings.
v1.3.1
Security fix on v1.3.0: (1) Stripped prose/markdown from .clawhubsafe — file must be pure sha256sum format to avoid 39 parse warnings; (2) Regenerated stale SKILL.md checksum that v1.3.0 missed after updating SKILL.md. All 9 files now verify cleanly: 0 warnings, 0 failures.
v1.3.0
v1.3.0: Full security audit and clearance. SECURITY.md added with complete script-by-script analysis — zero network requests, zero code execution, zero subprocess calls, data stays 100% local. Clears all AV false positives. Audited by Morpheus (code reviewer). Previous versions remain safe — this update adds transparency documentation.
v1.2.10
Security audit by Morpheus (2026-02-17): verified safe, updated SKILL.md with security metadata, enhanced .clawhubsafe with audit badge and checksums
v1.2.9
Security fix: Corrected .clawhubsafe to pure sha256sum format (removed prose that caused 35 parse warnings). Updated stale SKILL.md checksum. All 9 file checksums now verify cleanly with zero warnings.
v1.2.8
Security documentation added: .clawhubsafe with checksums, SECURITY.md with detailed analysis, README.md with safety notes. Addresses false positive AV detections.
v1.2.7
v1.2.7: Name correction + Model flexibility - Sonnet/Opus only support, graceful fallback, AVAILABLE_TIERS config
v1.2.6
v1.2.6: Model flexibility - Sonnet/Opus only support, graceful fallback when Haiku unavailable, AVAILABLE_TIERS config, updated HEARTBEAT and AGENTS templates
v1.2.5
v1.2.5: Model flexibility - Added support for Sonnet/Opus only setups, graceful fallback when Haiku unavailable, AVAILABLE_TIERS config option, updated HEARTBEAT template with Sonnet alternative, context optimization improvements
v1.2.4
Fixed: Restored original skill name 'OpenClaw Token Optimizer'
v1.2.3
Fixed: Restored original skill name
v1.2.2
Security fix: Removed local Ollama setup instructions flagged by ClawHub security scan. Focuses on cloud API optimization only.
v1.2.0
v1.2.0 (2026-02-06)
🛸 Local model fallback (Emergency Fuel Mode) with Ollama integration
📊 Revised savings estimates — now 85-95% (was 50-80%)
📝 Detailed cost analysis with real calculations
📚 New docs/LOCAL-FALLBACK.md setup guide
v1.1.0 (2026-02-06)
✨ Multi-provider support: OpenAI, Google, OpenRouter
🏷️ Provider-agnostic tier system (cheap/balanced/smart)
📦 ClawHub-ready SKILL.md with proper metadata
📝 One-line installation instructions
v1.0.0 (2026-02-05)
🎉 Initial release
Context optimizer, model router, heartbeat optimizer, token tracker
Comprehensive documentation and examples
Metadata
Frequently Asked Questions
What is OpenClaw Token Optimizer?
OpenClaw Token Optimizer v3.2.0 — practical cost-control toolkit for OpenClaw agents. Lazy context loading, Sonnet/Opus-aware routing, heartbeat scheduling,... It is an AI Agent Skill for Claude Code / OpenClaw, with 12758 downloads so far.
How do I install OpenClaw Token Optimizer?
Run "/install openclaw-token-optimizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Token Optimizer free?
Yes, OpenClaw Token Optimizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Token Optimizer support?
OpenClaw Token Optimizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Token Optimizer?
It is built and maintained by Asif (@asif2bd); the current version is v3.2.0.
More Skills