Bootstrap Optimizer
/install md-bootstrap-optimizer
Bootstrap Optimizer
Keep your OpenClaw MD file system lean, maintainable, and never bloated again.
Problems Solved
| Pain Point | Consequence |
|---|---|
| All rules piled into MEMORY.md | Version drift, critical rules truncated |
| No ownership for new rules | Changes spread across 4 places, never in sync |
| TOOLS.md exceeds 12KB | Massive bootstrap on every session |
| Bare filenames in cross-references | Broken links, chaotic relationships |
Four-Layer File Architecture
| Layer | Files | Loading |
|---|---|---|
| Core (Permanent) | MEMORY.md, AGENTS.md, CLAUDE.md | Every session, full load |
| Execution (On-demand) | SCHEDULING.md, INSTRUCTIONS.md, SOUL.md | Triggered by scene |
| Project (Current) | USER.md, IDENTITY.md, TOOLS.md | Referenced as needed |
| Archive | AGENTS_full.md, DREAMS.md, HEARTBEAT.md | No rule participation |
Core Principles
- Atomic: MEMORY.md stores only permanently true atomic rules (Why), never facts (What)
- Mother-Child Separation: TOOLS.md splits into mother (index only) + children (details)
- Scene Loading: Details live in child files, loaded on demand — never pollutes bootstrap
- Monthly Audit: Check bootstrap total size; split when approaching 3KB
TOOLS.md Split Example
Mother file (index only):
# TOOLS.md
## Tools & Skills Index
See child files:
- [[TOOLS_skills.md]] — Skill toolbox details
- [[TOOLS_feishu.md]] — Feishu protocol & open_id map
Child file (TOOLS_skills.md):
# TOOLS_skills.md
## Skill Toolbox
### Tier 1: Always Available (4, truly high-frequency)
...
Result Comparison
| Metric | Before | After |
|---|---|---|
| MEMORY.md | v5.7 (ever-growing) | Atomic principles only |
| TOOLS.md | 12KB+ | Mother \x3C 3KB |
| Bootstrap total | Over limit | \x3C 3KB |
| Rule lookup | Scattered | Layer-clear ownership |
Maintenance
Run a monthly check on bootstrap file sizes. Split immediately when approaching limits.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install md-bootstrap-optimizer - After installation, invoke the skill by name or use
/md-bootstrap-optimizer - Provide required inputs per the skill's parameter spec and get structured output
What is Bootstrap Optimizer?
Optimizes OpenClaw MD files by splitting TOOLS.md, enforcing atomic rules, and loading scenes on demand to keep bootstraps lean under 3KB. It is an AI Agent Skill for Claude Code / OpenClaw, with 42 downloads so far.
How do I install Bootstrap Optimizer?
Run "/install md-bootstrap-optimizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Bootstrap Optimizer free?
Yes, Bootstrap Optimizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Bootstrap Optimizer support?
Bootstrap Optimizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Bootstrap Optimizer?
It is built and maintained by warren2008-2020-spec (@warren2008-2020-spec); the current version is v1.0.0.