The BOOTSTRAP.md file serves as the "ignition" for the 📝OpenClaw system — the core initialization logic and "factory settings" required to launch the bot. It defines the fundamental rules for how the AI should process its various Markdown components and sets the baseline state for the agent upon startup. It is the bot's foundational code of conduct that ensures all other modules load and interact correctly.
What BOOTSTRAP.md Does
When an OpenClaw agent starts, BOOTSTRAP.md is the first file it reads. It establishes:
- Module loading order — which markdown files to read and in what sequence. 📝SOUL.md and 📝IDENTITY.md are loaded early to establish personality and role. 📝TOOLS.md, 📝SKILLS.md, and 📝MEMORY.md follow to define capabilities and context.
- Processing rules — how the agent should interpret each file type. SOUL.md shapes tone and values. IDENTITY.md sets role boundaries. TOOLS.md inventories available APIs. SKILLS.md registers installable capabilities.
- Baseline behavior — default responses, safety boundaries, and fallback behavior when no specific skill or tool matches a request.
- Factory reset state — the known-good configuration the agent returns to if state becomes corrupted or needs reinitialization.
How It Relates to Other OpenClaw Files
BOOTSTRAP.md is the coordinator. The other markdown files are specialized:
Without BOOTSTRAP.md, an OpenClaw agent would have no way to know which files to read, in what order, or how to interpret them. It is the difference between a collection of markdown files and a functioning agent.
Why It Matters
The BOOTSTRAP.md pattern is what makes OpenClaw's agent definition approach distinct from a simple system prompt. Each agent has a structured, version-controllable identity composed of specialized files — and BOOTSTRAP.md is the file that orchestrates all the others. This is the foundation of what makes the markdown-file agent definition model work: infrastructure you can read, edit, and template.
Related
- 📝Markdown-File Agent Definition — the broader design pattern BOOTSTRAP.md implements
- 📝OpenClaw Memory Architecture — the seven-surface memory model BOOTSTRAP.md orchestrates at session start