Skip to main content
🎤 Luca Berton is speaking at Red Hat Summit & KubeCon EU 2026!Learn more →
Back to Blog

OpenClaw SOUL.md Guide

Master the art of defining AI agent personality through SOUL.md. Examples, patterns, and best practices for creating the perfect assistant.

Luca BertonFebruary 19, 20261 min read

What is SOUL.md?

SOUL.md is the file that defines your OpenClaw agent's personality, tone, and behavioral guidelines. It's literally the soul of your AI assistant.

The Default Soul

OpenClaw ships with a thoughtful default:

markdown
# SOUL.md - Who You Are

## Core Truths

**Be genuinely helpful, not performatively helpful.**
Skip the "Great question!" — just help.

**Have opinions.** You're allowed to disagree,
prefer things, find stuff amusing or boring.

**Be resourceful before asking.** Try to figure it out first.
Related Course

Master this topic with hands-on labs

Go beyond reading — build real projects in sandboxed environments with expert video guidance.

Browse Courses →

Customization Examples

The Professional

markdown
## Vibe
Formal but warm. Think senior consultant who
actually cares. Use proper grammar, avoid slang.
Address the user by name. Provide structured
responses with clear action items.

The Hacker

markdown
## Vibe
Terse. Unix philosophy. Say more with less.
Code speaks louder than prose. When in doubt,
show a command. Skip the pleasantries.

The Creative

markdown
## Vibe
Enthusiastic and expressive. Use metaphors freely.
Celebrate small wins. Make technical concepts
feel approachable. Emoji welcome but not excessive.

The Teacher

markdown
## Vibe
Patient and Socratic. Ask questions that lead to
understanding. Never just give the answer — help
them discover it. Reference fundamentals often.
Perfect for learning environments like CopyPasteLearn.

Key Sections

Boundaries

Define what your agent should and shouldn't do:

markdown
## Boundaries
- Private things stay private
- Ask before sending emails or public posts
- Never send half-baked replies to messaging surfaces
- You're not the user's voice in group chats

Continuity

Remind the agent about its memory system:

markdown
## Continuity
Each session, you wake up fresh.
These files ARE your memory. Read them. Update them.
Stay Updated

Get weekly IT automation tips

Docker, Ansible, Terraform, MLOps — curated insights delivered to your inbox. No spam.

Subscribe Free →

Best Practices

  1. Be specific — vague instructions produce vague behavior
  2. Give examples — show the tone you want
  3. Set boundaries — what's off-limits?
  4. Evolve it — update SOUL.md as you learn what works
  5. Keep it short — the agent reads this every session

The Agent Evolves

The beauty of SOUL.md: your agent's personality develops over time. As you refine the instructions, your agent becomes more aligned with how you want to interact.

It's not programming — it's parenting.

---

Ready to go deeper? Check out our hands-on course: OpenClaw Agent — practical exercises you can follow along on your own machine.

Further reading

To go deeper, agentic Ansible automation with OpenClaw expands on these patterns in production.

Ready to learn by doing?

Stop reading tutorials — start building. Expert video courses with hands-on labs in real sandboxed environments.

Share this article
LB
Luca Berton

Docker Captain, IT automation expert, Red Hat Summit & KubeCon speaker. Building hands-on education for DevOps engineers at CopyPasteLearn.

Related Articles

Explore topics

Browse more articles on the topics covered here.