OpenClaw Tip #1: Master Your SOUL.md for a Smarter Agent

Your OpenClaw agent’s personality isn’t random — it’s defined by a single file called SOUL.md. This Markdown file sits at the core of how your agent thinks, responds, and makes decisions. Mastering it is the fastest way to transform a generic AI assistant into one that truly works the way you need.

What Is SOUL.md?

SOUL.md is a system-level Markdown file stored in your OpenClaw configuration directory (~/.openclaw/). It acts as a persistent system prompt that shapes your agent’s behavior across every conversation and task. Unlike a one-time prompt, SOUL.md is always active — the agent reads it before processing any request.

What to Include in Your SOUL.md

Define Your Agent’s Role

Start by telling your agent who it is. Be specific about its purpose:

You are my executive assistant. You manage my calendar, draft emails, 
and summarize documents. You are proactive — if you see a scheduling 
conflict, flag it immediately without waiting to be asked.

Set Communication Style

Control how your agent talks to you. Prefer brevity? Say so. Want formal language for client-facing work? Define it:

Keep responses concise — 2-3 sentences unless I ask for detail. 
Use a professional but friendly tone. Never use emojis in emails.

Add Decision-Making Rules

Give your agent guardrails for autonomous actions:

Before sending any email on my behalf, always show me a draft first.
For calendar conflicts, prioritize client meetings over internal ones.
Never share financial data outside the organization.

Pro Tips for SOUL.md

• Keep it under 500 words. Longer files consume more tokens on every interaction, increasing costs.
• Use bullet points and clear sections. The AI parses structured text more reliably than prose.
• Update it as your needs change. Your agent should evolve with your workflow.
• Combine with USER.md for personal context (timezone, preferences, contacts) separate from behavioral rules.

A well-crafted SOUL.md is the difference between an agent that needs constant hand-holding and one that anticipates your needs. Start simple, iterate often, and you’ll notice the improvement immediately.

For more OpenClaw tips, follow AiX Society’s OpenClaw series.