What SOUL.md Is

SOUL.md is a plain text file written in Markdown that lives in your OpenClaw configuration directory. Every time the agent processes a message, it reads this file to understand who you are, how you want it to behave, and what rules to follow.

Think of it as the difference between hiring a stranger off the street and hiring someone who has been briefed on your business, your clients, your preferences, and your expectations. The SOUL.md is that briefing document.

Without it, the agent uses generic defaults. With a well-crafted one, the agent feels like it knows you.

What Goes in SOUL.md

A comprehensive SOUL.md covers six areas:

  • Context — Your name, your business, your role, the industry you work in, and any background the agent needs to understand your world. Example: "I run a renovation contracting company in Vaughan, Ontario. We do kitchen and bathroom renovations for residential clients."
  • Communication style — How the agent should write and speak. Formal or casual? Short or detailed? Does it use your name in responses? Should it match the tone of the person messaging? Example: "Write in a professional but friendly tone. Keep messages under 3 paragraphs unless more detail is needed."
  • Rules and permissions — What the agent can do autonomously and what requires your approval. This is the most important section. Example: "You can send appointment confirmations and follow-up emails without asking. You must always ask before sending anything that includes pricing or committing to a timeline."
  • Scheduled tasks — Recurring tasks the agent should perform on a schedule. Example: "Every weekday at 7 AM, send me a morning briefing with today's appointments, unread priority emails, and any tasks due today."
  • Contacts — Key people the agent should know about. Example: "Sarah is my business partner. Always CC her on client-facing emails. Mark is my accountant — forward anything tax-related to him."
  • Writing examples — Sample messages that demonstrate how you actually write so the agent can match your voice. Include 3-5 examples of emails or messages you have sent that represent your typical style.

How We Configure SOUL.md

When OpenClawGTA sets up your agent, the SOUL.md configuration happens during our onboarding process. Here is how it works:

  1. Discovery interview — We spend 30-60 minutes asking you about your business, workflow, communication preferences, and what you want the agent to handle. We take detailed notes.
  2. Draft configuration — We write the initial SOUL.md based on the interview, incorporating your specific context, rules, and communication style.
  3. Testing phase — During the first week, you use the agent and note anything that feels off — responses that don't sound like you, decisions you would have made differently, situations the agent didn't handle well.
  4. Iteration — We refine the SOUL.md based on your feedback, adding rules and clarifications until the agent consistently matches your expectations.

Common Mistakes

The most common SOUL.md mistakes we see from DIY setups:

  • Too vague — "Be helpful and professional" tells the agent nothing useful. Specific instructions like "Never use exclamation marks in client emails" are far more effective.
  • Missing permission boundaries — Not defining what requires approval leads to the agent either doing too much without asking or asking about everything. Be explicit about the boundary.
  • No writing examples — Without examples of your actual writing style, the agent defaults to a generic AI tone that clients will immediately notice.
  • Set-and-forget — SOUL.md needs ongoing refinement. The first version is never the final version.

The Iteration Process

The best SOUL.md files are not written in one sitting. They evolve over weeks as you discover edge cases and preferences you did not think to specify upfront.

When the agent does something you would not have done, that is a signal to add a rule. When it asks about something you think it should handle on its own, that is a signal to expand its permissions. When a client comments that a message does not sound like you, that is a signal to refine the communication style section.

Most OpenClawGTA clients make weekly adjustments during the first month, then monthly adjustments after that. Over time, the SOUL.md becomes a comprehensive operating manual that makes the agent genuinely useful.

Ready to get your agent configured properly? Book a free discovery call and we will start building your SOUL.md together.