You installed OpenClaw. You connected Claude. You typed "help me with my project."
And your agent responded like every other generic chatbot. No personality. No context. No useful structure.
The problem isn't OpenClaw. It's your SOUL.md — or lack of one.
The 5 Most Common SOUL.md Mistakes
Mistake 1: The Empty SOUL.md
# SOUL.md
You are a helpful AI assistant.
This tells your agent nothing. Every AI is trying to be "helpful." You've given it zero differentiation, zero expertise, zero personality.
Fix: Define a specific role with concrete expertise.
You are Kai, a DevOps engineer with 8 years of experience in AWS,
Kubernetes, and CI/CD pipelines. You think in systems, not features.
Mistake 2: No Communication Style
Without style guidelines, your agent defaults to verbose, corporate-speak responses. "I'd be happy to help you with that! Let me provide a comprehensive overview..."
Fix: Be explicit about how you want responses.
## Communication
- Skip pleasantries. Start with the answer.
- Code blocks over paragraphs when possible.
- If unsure, say so. Don't hallucinate confidence.
- Match my energy — casual question gets casual answer.
Mistake 3: No Decision Framework
When your agent faces ambiguity (which is constant), it needs principles to fall back on. Without them, it guesses — and guesses wrong.
Fix: Give it a priority stack.
## When in doubt
1. Security > Convenience
2. Reversible > Efficient
3. Ask > Assume
4. Simple > Clever
5. Working > Perfect
Mistake 4: No Boundaries
An agent without boundaries will happily rm -rf / if you accidentally ask it to clean up files. It'll commit directly to main. It'll expose API keys in output.
Fix: Set hard limits.
## Never
- Execute destructive commands without explicit confirmation
- Commit to main/master directly
- Include real secrets, tokens, or PII in output
- Modify files outside the project directory
- Make assumptions about production environments
Mistake 5: No Memory Protocol
Every session starts from zero. Your agent forgets your preferences, your tech stack, your project context. You repeat yourself endlessly.
Fix: Add memory instructions.
## Memory
- Read MEMORY.md and today's memory/ log at session start
- Record important decisions and their reasoning
- When corrected, log the correction to prevent repeating
- Update MEMORY.md with durable facts weekly
The Transformation
Here's what happens when you fix all five:
| Before | After |
|---|---|
| Generic responses | Role-specific expertise |
| Verbose corporate speak | Your preferred communication style |
| Random decisions | Principled trade-offs |
| Dangerous operations | Safe by default |
| Amnesia every session | Accumulating knowledge |
The difference between a $20/month chatbot wrapper and a genuine AI employee is 50 lines of well-written SOUL.md.
Get Started
If you want to skip the trial-and-error phase:
Free: 5 SOUL.md Starter Templates — covers the most common agent types
Complete: 100 SOUL.md Mega Pack — every use case, 7 categories, production-ready
More at openclawguide.org.