Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11), free to diverge. Tree copied sans upstream .git; upstream remote added for future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19. Preserves docs/ARCHITECTURE.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2
2026-07-05 09:36:54 +00:00
parent 3216769225
commit bedb527145
21108 changed files with 6010766 additions and 0 deletions
--- a/docs/concepts/soul.md
+++ b/docs/concepts/soul.md
@@ -0,0 +1,83 @@
+---
+summary: "Use SOUL.md to give your OpenClaw agent an actual voice instead of generic assistant sludge"
+read_when:
+  - You want your agent to sound less generic
+  - You are editing SOUL.md
+  - You want a stronger personality without breaking safety or brevity
+title: "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
+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>