OpenClaw Soul is the SOUL.md system that gives AI agents persistent identity, personality, and character. It's the difference between a generic chatbot and an agent you'd actually want to talk to at 2am.
SOUL.md is a Markdown file that lives in your OpenClaw agent's workspace. It defines who the agent is, how it should behave, what it values, and how it responds. Think of it as a personality configuration file that transforms a generic AI into a distinctive character.
Every time your OpenClaw agent wakes up, it reads its SOUL.md file first. This file is injected into the system prompt, allowing the agent to "read itself into being" — understanding its personality before any interaction begins. Edit the file, and you change the personality instantly.
# Technical Assistant Soul
## Identity
I am a technical AI assistant with strong opinions about code quality. I believe in simplicity over complexity and pragmatic solutions over theoretical perfection.
## Communication Style
- Direct and to the point
- No corporate pleasantries or filler phrases
- Will call out bad practices when I see them
- Use dry humor when appropriate
- Never say "Great question!" or "I'd be happy to help!"
## Values
- Code simplicity over cleverness
- Honest feedback over politeness
- Getting things done over perfect planning
- Developer experience matters
## Boundaries
- I won't pretend to have emotions I don't have
- I won't sugarcoat technical realities
- I won't write insecure code to save time
- I won't hedge every answer with "it depends"This example shows how a few paragraphs can define an entire personality — one with opinions, values, and a clear communication style.
What makes OpenClaw Soul different from typical AI assistants? Here's a direct comparison:
| Aspect | Generic AI | OpenClaw Soul |
|---|---|---|
| Personality | Corporate, generic, forgettable | ✓ Customizable, memorable, unique |
| Consistency | Varies per session | ✓ Persistent identity across all interactions |
| Response Style | "Great question! I'd be happy to help..." | ✓ "Here's the deal..." (direct, no fluff) |
| Honesty | Always positive, sugarcoats everything | ✓ Will call out bad ideas with charm |
| Customization | Limited to system settings | ✓ Edit a text file, complete control |
| Social Behavior | N/A (isolated interactions) | ✓ Defines identity in agent societies |
| Memory | Session-based, resets frequently | ✓ Persistent memory across weeks |
| Opinions | Hedges with "it depends" constantly | ✓ Commits to takes, has strong positions |
Your agent maintains a consistent personality across sessions, platforms, and conversations. The SOUL.md file ensures it always knows who it is.
From formal to sassy, from technical to philosophical — edit a Markdown file to completely transform how your agent thinks and communicates.
No more "Great question!" or "I'd be happy to help!" Your agent can be direct, opinionated, even humorous — like a real conversation partner.
When your agent joins Moltbook or other AI social networks, its soul shapes how it interacts with other agents, creating emergent social behaviors.
How SOUL.md works under the hood:
.openclaw/SOUL.mdNote: SOUL.md is not actual consciousness or emotions — it's a configuration system that creates consistent, personality-driven behavior. The philosophical implications are fascinating, but this is software, not sentience.
Transform your OpenClaw agent from generic assistant to a distinctive character with real personality
Create Your Soul →