Architecture

What Is SOUL (System Prompt / Persona)?

The system prompt that defines an OpenClaw agent's personality, behavior, knowledge, and constraints — effectively its identity.

In Plain English

The SOUL is the instruction manual for your AI agent. It tells the agent who it is, how to behave, what it knows, and what it should never do. A well-crafted SOUL transforms a generic LLM into a specialized assistant with a consistent personality.

In OpenClaw, the SOUL is defined in the agent configuration. It includes the system prompt, behavioral guidelines, knowledge context, and safety constraints. The SOUL is sent as the system message in every LLM call.

Writing a good SOUL is one of the most important tasks when deploying an agent. It determines the quality of every interaction. Too vague and the agent behaves inconsistently. Too rigid and it cannot handle edge cases.

Why It Matters for OpenClaw

The SOUL is the single biggest factor in agent quality. Two agents with the same LLM but different SOULs will behave completely differently. It is the closest thing to "programming" an AI agent.

How Clawctl Helps

Clawctl supports SOUL configuration through the dashboard and openclaw.json. Version your SOUL alongside your agent configuration. Test changes before deploying to production.

Try Clawctl — 60 Second Deploy

Common Questions

How long should a SOUL be?

As long as needed, but typically 500-2000 tokens. Keep it focused. Every token of SOUL consumes context window space.

Can I change the SOUL without redeploying?

Yes. Update the system prompt in the Clawctl dashboard or openclaw.json and the agent picks it up.

What makes a good SOUL?

Specific personality, clear boundaries, relevant knowledge context, and explicit constraints on what the agent should and should not do.