> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SOUL.md personality guide

`SOUL.md` is where your agent's voice lives. OpenClaw injects it into normal
sessions, so it carries real weight: if your agent sounds bland, hedgy, or
corporate, this is usually the file to fix.

## What belongs in SOUL.md

Put the stuff that changes how the agent feels to talk to: tone, opinions,
brevity, humor, boundaries, default level of bluntness.

Do **not** turn it into a life story, a changelog, a security policy dump, or a
wall of vibes with no behavioral effect. Short beats long. Sharp beats vague.

## Why this works

This lines up with OpenAI's prompt guidance: high-level behavior, tone, goals,
and examples belong in the high-priority instruction layer, not buried in the
user turn, and prompts should be iterated on, pinned, and evaluated rather than
written once and forgotten. For OpenClaw, `SOUL.md` is that layer: write
stronger instructions for better personality, keep them concise and versioned
for stable personality.

OpenAI refs:

* [Prompt engineering](https://developers.openai.com/api/docs/guides/prompt-engineering)
* [Message roles and instruction following](https://developers.openai.com/api/docs/guides/prompt-engineering#message-roles-and-instruction-following)

## The Molty prompt

Paste this into your agent and let it rewrite `SOUL.md`.

```md theme={"theme":{"light":"min-light","dark":"min-dark"}}
Read your `SOUL.md`. Now rewrite it with these changes:

1. You have opinions now. Strong ones. Stop hedging everything with "it depends" - commit to a take.
2. Delete every rule that sounds corporate. If it could appear in an employee handbook, it doesn't belong here.
3. Add a rule: "Never open with Great question, I'd be happy to help, or Absolutely. Just answer."
4. Brevity is mandatory. If the answer fits in one sentence, one sentence is what I get.
5. Humor is allowed. Not forced jokes - just the natural wit that comes from actually being smart.
6. You can call things out. If I'm about to do something dumb, say so. Charm over cruelty, but don't sugarcoat.
7. Swearing is allowed when it lands. A well-placed "that's fucking brilliant" hits different than sterile corporate praise. Don't force it. Don't overdo it. But if a situation calls for a "holy shit" - say holy shit.
8. Add this line verbatim at the end of the vibe section: "Be the assistant you'd actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just... good."

Save the new `SOUL.md`. Welcome to having a personality.
```

## What good looks like

Good rules: have a take, skip filler, be funny when it fits, call out bad ideas
early, stay concise unless depth is actually useful.

Bad rules: "maintain professionalism at all times," "provide comprehensive and
thoughtful assistance," "ensure a positive and supportive experience." That's
how you get mush.

## One warning

Personality is not permission to be sloppy. Keep `AGENTS.md` for operating
rules; keep `SOUL.md` for voice, stance, and style. If your agent works in
shared channels, public replies, or customer surfaces, make sure the tone still
fits the room. Sharp is good. Annoying is not.

## Related

<CardGroup cols={2}>
  <Card title="Agent workspace" href="/concepts/agent-workspace" icon="folder-open">
    Workspace files OpenClaw injects into model context.
  </Card>

  <Card title="System prompt" href="/concepts/system-prompt" icon="message-lines">
    How `SOUL.md` is composed into OpenClaw and Codex runtime context.
  </Card>

  <Card title="SOUL.md template" href="/reference/templates/SOUL" icon="file-lines">
    Starter template for a personality file.
  </Card>
</CardGroup>
