What is SOUL.md?
SOUL.md is the personality file for your OpenClaw AI agent. It defines how your agent talks, thinks, and vibes — but NOT what it knows.
Think of it like changing your agent's outfit, not its brain.
Will I lose my agent's memory?
Nope. Your agent's memory lives in separate files:
• MEMORY.md — long-term curated memory
• memory/*.md — daily notes and logs
• SESSION-STATE.md — active task context
Swapping SOUL.md only changes personality. All your context, decisions, and history stay intact.
Any downsides to trying different souls?
Zero. Swap as often as you want. Your agent adapts immediately on the next message. The only thing that changes is tone, personality, and communication style.
How to Install
Option A: Copy & Paste (easiest)
1. Click "Copy" on any soul above
2. Open your SOUL.md file (workspace root)
3. Replace the contents and save
4. Your agent picks it up on the next message
Option B: Download
1. Click "Download" on any soul
2. Move the file to your workspace root as SOUL.md
3. Done!
Option C: CLI (coming soon)
openclaw soul install researcher
openclaw soul list
openclaw soul switch comedian
Pro Tip: Keep a Collection
Create a souls/ folder in your workspace with your favorites:
souls/
researcher.md
comedian.md
senior-dev.md
Switch anytime:
cp souls/comedian.md SOUL.md
Or add a quick shell alias:
alias soul='cp souls/$1.md SOUL.md && echo "Switched to $1"'
# Usage: soul comedian