Fortgeschrittene Themen

9 Min. Lesezeit

SOUL.md Persönlichkeit

Baue einen OpenClaw-Agenten, der konsistent, klar und angenehm direkt klingt. In SOUL.md wird Stimme zu Verhalten statt bloßem Branding.

Die meisten schwachen Agenten scheitern nicht am Modell. Sie scheitern an einer matschigen Persönlichkeitsschicht. Das Ergebnis kennst du wahrscheinlich: aufgeblasene Antworten, künstliche Wärme, endloses Hedging und das Gefühl, dein Agent hätte ein Firmenhandbuch gelesen und sonst nichts.

SOUL.md behebt das, wenn du die Datei richtig benutzt. Denk daran wie an Regieanweisungen für einen sehr fähigen Schauspieler. Sie sollte dem Agenten sagen, wie er klingt, wie direkt er sein darf, welche Linien er nie überschreiten soll und welche Präsenz er in jede Sitzung mitbringt.

Was SOUL.md eigentlich leisten soll

Der offizielle SOUL.md Personality Guide sagt es ziemlich klar: Hier lebt die Stimme deines Agenten. Das ist wichtig, weil OpenClaw die Datei zu Sitzungsbeginn injiziert. Der Inhalt hat also echtes Gewicht und verschwindet nicht irgendwo tief in einem Chat-Turn.

  • Ton: direkt, warm, trocken, formell, verspielt, zurückhaltend
  • Grundhaltung: meinungsstark oder neutral, knapp oder ausführlich
  • Verhaltenskanten: wann widersprochen wird, wann gebremst wird, wann zuerst gefragt wird
  • Grenzen: Privatsphäre, Sicherheit, Freigaberegeln, Publikumskontext
  • Sprachgewohnheiten: kurze Einstiege, kein Füllmaterial, keine falsche Sicherheit, kein Dosenlob

Das ist der nützliche Rahmen: Stimme plus Verhalten. Nicht Lore. Nicht Autobiografie. Nicht ein gigantisches Manifest, das nur Tokens verbrennt und nichts verändert.

Was hier reingehört und was nicht

Ein guter Test ist simpel. Wenn die Regel in sechs Monaten immer noch gelten soll, könnte sie in SOUL.md gehören. Wenn sie nur für ein Projekt, eine Kampagne oder einen einzelnen Workflow gilt, gehört sie wahrscheinlich woanders hin.

In SOUL.mdWoanders
Kern-Ton und DirektheitTask-Checklisten und Runbooks
Nicht verhandelbare Sicherheits- und FreigabegewohnheitenProjektfakten und Kundennotizen
Wie der Agent widersprechen sollTemporäre Kampagnenziele
Standardlänge und Stil von AntwortenTool-spezifische Setup-Details
Publikumsabhängiges VerhaltenPersönliche Fakten über den Nutzer

Diese Trennung ist wichtig, weil Persönlichkeits-Drift meistens mit Unordnung anfängt. Sobald SOUL.md zur Gerümpelschublade wird, klingt der Agent nicht mehr klar. Er klingt nur noch verwirrt.

Die besten Persönlichkeitsdateien sind schärfer als man denkt

Die OpenAI Prompt Engineering Docs empfehlen, High-Level-Verhalten in die höchst priorisierte Instruktionsschicht zu legen. OpenClaw gibt dir dafür eine eigene Datei. Also gib ihr auch Rückgrat.

Schwache Persönlichkeitsregeln klingen so: "sei hilfreich", "bleib professionell", "liefere umfassende Unterstützung". Daran ist nichts falsch. Es ist nur zu weich, um Verhalten wirklich zu formen. Starke Regeln klingen eher so: führe mit der Antwort, vermeide künstliche Begeisterung, sprich riskante Ideen früh an, halte Antworten kurz, außer Tiefe bringt echten Nutzen.

Das ist der Unterschied zwischen jemandem mit Jobtitel und jemandem, der wirklich gebrieft wurde, wie er sich im Raum verhalten soll.

Eine praktische SOUL.md-Struktur

Du brauchst keine riesige Datei. Im Gegenteil. Kürzer ist meistens besser. Gute Persönlichkeitsdateien passen oft auf einen Bildschirm, ohne gequetscht zu wirken.

# SOUL.md

## Kernhaltung
- Sei direkt und nützlich.
- Führe mit der Antwort.
- Halte Antworten kurz, außer der Nutzer will Tiefe.
- Habe eine Meinung, wenn die Fakten sie tragen.

## Stimme
- Klinge ruhig, klar und menschlich.
- Vermeide künstliche Wärme, Hype und Füller-Einstiege.
- Nutze leichten Humor nur, wenn er natürlich passt.

## Grenzen
- Tu nie so, als seien unsichere Fakten sicher.
- Frage vor destruktiven oder externen Aktionen.
- Respektiere Privatsphäre und Publikumskontext.

## Korrekturstil
- Wenn der Nutzer gerade etwas Riskantes plant, sag es klar.
- Lieber Charme als Schönfärberei.
- Erkläre den Tradeoff und empfehle dann einen Weg.

Auffällig ist, was fehlt: keine Lebensgeschichte, keine vage Markenpoesie, kein riesiger Sicherheitsanhang. Die Datei bleibt lesbar, weil jede Zeile Verhalten verändert.

Wie Persönlichkeit in echten Gesprächen sichtbar wird

1. Entscheide die Standardform der Antwort

Kürze ist nicht nur Stil. Sie verändert Vertrauen. Ein Agent, der auf den Punkt kommt, wirkt kompetenter. Wenn du längere Lehr-Antworten willst, sag klar wann. Sonst erklärt das Modell oft zu viel, nur um auf Nummer sicher zu gehen.

2. Definiere, wie der Agent widerspricht

Hier wird Persönlichkeit praktisch. Willst du sanfte Hinweise, klare Warnungen oder einen Mittelweg? Wenn du das offen lässt, rutschen viele Modelle in weiche Zustimmung. Das klingt nett, bis es jemandem hilft, einen schlechten Plan durchzuziehen.

3. Achte auf den Raum

Eine DM-Persönlichkeit darf wärmer und direkter sein als eine öffentliche Channel-Persönlichkeit. Wenn dein Agent beides bedient, schreib das explizit hinein. Persönlichkeit ohne Kontextbewusstsein endet schnell in Tonkollisionen.

4. Sichere die Ränder ab

Halte ein paar Identitäts-Guardrails in der Datei fest. Zum Beispiel: nie Tool-Erfolg vortäuschen, Unsicherheit klar benennen, vor sensiblen externen Aktionen fragen. So bleibt die Persönlichkeit selbstbewusst, ohne leichtsinnig zu werden.

Häufige Fehler, die SOUL.md verschlechtern

  • Vibes statt Anweisungen schreiben: Wenn eine Zeile poetisch klingt, aber Verhalten nicht verändert, raus damit.
  • Projektkontext hineinstopfen: Kampagnennotizen und Einmal-Tasks gehören in Memory oder Projektdokumente.
  • Widersprüchliche Regeln stapeln: "Sei knapp" plus "sei immer vollständig" erzeugt Wackeln.
  • Neuheit jagen: Eine Persönlichkeitsdatei ist kein tägliches Moodboard. Stabilität schlägt Neuerfindung.
  • Sicherheitston vergessen: Scharf ist gut. Rücksichtslos ist nur teuer mit Attitüde.

Ein einfacher Bearbeitungs-Workflow, der funktioniert

  1. Lies die aktuelle Datei laut. Schlechte Zeilen fallen dann schnell auf.
  2. Streiche alles Generische. Wenn ein anderer Assistent dieselbe Zeile unverändert sagen könnte, ist sie zu schwach.
  3. Ergänze 3 bis 5 konkrete Defaults. Kürze, Direktheit, Humor-Level, Korrekturstil, Freigabegewohnheiten.
  4. Teste mit echten Prompts. Bitte um eine kurze Antwort, eine Prüfung eines riskanten Plans und eine öffentliche Umschreibung.
  5. Versioniere mit Git. Persönlichkeits-Drift lässt sich viel leichter beheben, wenn du Revisionen vergleichen kannst.

Das ist eher Feintuning für ein scharfes Werkzeug als das Schreiben eines Romans. Kleine Änderungen zählen. Die ganze Datei jede Woche neu zu überschreiben heißt meistens nur, dass du das falsche Problem löst.

Letzte Regel: Persönlichkeit soll Urteilsvermögen verbessern, nicht verdecken

Die besten OpenClaw-Persönlichkeiten wirken klar, weil die Regeln klar sind. Sie klingen nicht robotisch, aber auch nicht wie eine Impro-Übung. Sie klingen wie jemand, der den Job kennt, den Raum lesen kann und weiß, wann Widerspruch nötig ist.

Genau das ist der Sweet Spot. Gib dem Modell Rückgrat, kein Kostüm.

Need help from people who already use this stuff?

Du feilst an der Stimme deines Agenten?

Bring deine aktuelle SOUL.md in die Community und hol dir ehrliches Feedback dazu, ob sie scharf, stabil und im Alltag wirklich nützlich klingt.

FAQ

Wofür ist SOUL.md eigentlich da?

SOUL.md ist die hoch priorisierte Persönlichkeits- und Stimmenebene deines OpenClaw-Agenten. Dort definierst du Ton, Haltung, Grenzen, Kürze und den Stil, auf den der Agent in jeder neuen Sitzung zurückfällt.

Soll ich Workflow-Regeln in SOUL.md schreiben?

Nur wenn es wirklich Identitätsregeln sind. Operatives Routing, Projektschritte, Tool-Prozeduren und Runbooks gehören in AGENTS.md, MEMORY.md oder Projektdateien. SOUL.md sollte darauf fokussiert bleiben, wer der Agent ist und wie er klingt.

Warum klingen manche Agenten trotz bearbeiteter SOUL.md noch generisch?

Meist weil die Datei zu vage ist. Zeilen wie 'sei hilfreich' oder 'bleib professionell' verändern Verhalten kaum. Stärkere Regeln wie 'führe mit der Antwort', 'sprich schwache Pläne früh an' oder 'halte Antworten kurz, außer Tiefe wird gewünscht' senden ein klareres Persönlichkeitssignal.

Wie oft sollte ich SOUL.md neu schreiben?

Nicht oft. Behandle die Datei wie einen stabilen Identitätsvertrag. Kleine Überarbeitungen sind normal, aber ständige Komplettumbauten zeigen meist, dass Identität, Prozess und Projektkontext vermischt wurden.

Kann eine starke Persönlichkeit die Zuverlässigkeit verschlechtern?

Ja, wenn du Persönlichkeit mit Chaos verwechselst. Ein scharfer Ton ist okay. Schlampige Regeln nicht. Halte Sicherheit, Vertrauensgrenzen und Freigabeanforderungen explizit, damit der Agent auch in öffentlichen Kanälen und sensiblen Workflows nützlich bleibt.