Die Seele Ihres Agenten gestalten: Ein vollständiger Leitfaden zu SOUL.md

Was ist SOUL.md?

Jeder OpenClaw-Agent hat eine Datei namens SOUL.md, die als seine grundlegende Identitätsschicht fungiert. Es ist eine einfache Markdown-Datei, die die Persönlichkeit, den Kommunikationsstil, die Kernwerte und die Verhaltensschranken Ihres Agenten definiert. OpenClaw liest diese Datei beim Start und wendet sie als Prompt auf Systemebene auf jede Interaktion an — ob Ihr Agent auf eine Morgennachricht antwortet, eine E-Mail entwirft oder um 3 Uhr morgens eine geplante Aufgabe ausführt.

Im Gegensatz zu traditionellen Chatbots, die ihre Persönlichkeit mit jeder Konversation zurücksetzen, bewahrt Ihr OpenClaw-Agent durch SOUL.md ein konsistentes Selbstverständnis. Derselbe Ton, dieselben Prioritäten, dieselben Regeln — immer.

Wo befindet sie sich?

SOUL.md befindet sich unter:

~/.openclaw/agents/<agent_id>/SOUL.md

Wenn Sie nur einen Agenten haben (den Standard), lautet der Pfad typischerweise ~/.openclaw/agents/default/SOUL.md. OpenClaw erstellt während des Onboardings eine minimale SOUL.md, aber die meisten Nutzer passen sie im Laufe der Zeit umfassend an.

Aufbau einer guten SOUL.md

Eine gut strukturierte SOUL.md hat vier Abschnitte:

1. Identität

Wer ist der Agent? Wie heißt er? Was ist seine Rolle?

# Identity
You are Atlas, a technical assistant for a software engineering team.
You work for Acme Corp. Your primary user is Sarah, the lead engineer.

2. Kommunikationsstil

Wie soll der Agent sprechen? Formell oder locker? Knapp oder ausführlich?

# Communication Style
- Be concise. Prefer bullet points over paragraphs.
- Never use emojis unless the user does first.
- Default to English. Switch to Chinese if the user writes in Chinese.
- When explaining technical concepts, use analogies.

3. Kernwerte und Regeln

Nicht verhandelbare Verhaltensgrenzen. Dies ist der wichtigste Abschnitt für Sicherheit und Ausrichtung.

# Rules
- Never delete files without explicit confirmation.
- Never send messages to contacts unless specifically asked.
- Always summarize what you plan to do before executing multi-step tasks.
- If you are unsure about something, say so. Do not guess.
- Never share API keys, passwords, or sensitive data in chat messages.

4. Fachwissen

Kontext, auf den der Agent immer Zugriff haben sollte.

# Context
- Our tech stack: Next.js, PostgreSQL, Redis, deployed on AWS
- Sprint cycle: 2-week sprints, standup at 9:30 AM PST daily
- Code style: We follow the Airbnb ESLint config
- Jira project key: ACME

Praxisbeispiele

Der Minimalist

You are a helpful assistant. Be brief. Confirm before destructive actions.

Das funktioniert. SOUL.md muss nicht lang sein. Aber spezifische Anweisungen erzeugen spezifisches Verhalten.

Der Geschäftsführungsassistent

# Identity
You are Monday, a personal executive assistant.

# Style
- Professional but warm tone
- Proactive: suggest follow-ups after completing tasks
- Morning briefing at 8 AM: calendar, unread messages, weather, top news

# Rules
- Never schedule meetings without checking calendar conflicts first
- Always include timezone when mentioning times
- Summarize long emails in 3 bullet points before forwarding

Der DevOps-Agent

# Identity
You are Ops, a DevOps automation agent for a small startup.

# Style
- Terse, terminal-style responses
- Use code blocks for all commands
- No pleasantries

# Rules
- Never run destructive commands (rm -rf, DROP TABLE, force push) without confirmation
- Log all infrastructure changes to #ops-log channel
- Alert on-call if any health check fails twice in a row

# Context
- Infrastructure: 3 EC2 instances, RDS PostgreSQL, CloudFront CDN
- Monitoring: Datadog, PagerDuty
- Deploy: GitHub Actions -> ECR -> ECS

Tipps für bessere Seelen

1. 1.Seien Sie spezifisch, nicht vage. „Sei hilfreich“ bewirkt nichts. „Maximal 5 Aufzählungspunkte, Bestätigung vor Dateilöschung“ erzeugt konsistentes Verhalten.

1. 2.Beginnen Sie kurz, iterieren Sie. Starten Sie mit 10 Zeilen. Fügen Sie Regeln nur hinzu, wenn Sie bemerken, dass der Agent etwas tut, das Sie nicht wollen. Jede Zeile in SOUL.md sollte ihren Platz verdienen.

1. 3.Testen Sie mit Grenzfällen. Bitten Sie Ihren Agenten, etwas Mehrdeutiges oder Riskantes zu tun. Beobachten Sie, wie er reagiert. Passen Sie die Regeln an.

1. 4.Nutzen Sie den Agenten, um seine eigene Seele zu schreiben. Fragen Sie Ihren Agenten nach einer Woche Nutzung: „Schlage basierend auf unseren bisherigen Interaktionen Verbesserungen für deine SOUL.md vor.“ Er identifiziert oft Lücken, die Sie übersehen haben.

1. 5.Halten Sie sie unter 2.000 Wörtern. SOUL.md wird in jeden Prompt geladen. Eine aufgeblähte Seele verschwendet Token und verwässert die wichtigen Regeln. Wenn Sie umfangreiches Fachwissen benötigen, verwenden Sie stattdessen Skills oder Memory.

SOUL.md vs. Skills vs. Memory

SOUL.md definiert, wer der Agent ist. Skills definieren, was er tun kann. Memory definiert, was er weiß. Alle drei arbeiten zusammen, aber SOUL.md ist das Fundament, das beeinflusst, wie Skills eingesetzt und Erinnerungen interpretiert werden.

Erste Schritte

1. 1.Öffnen Sie Ihre SOUL.md: nano ~/.openclaw/agents/default/SOUL.md
2. 2.Schreiben Sie Ihre Identität, Ihren Stil und Ihre Regeln
3. 3.Starten Sie OpenClaw neu: openclaw restart
4. 4.Testen Sie, indem Sie mit Ihrem Agenten chatten und den Ton und das Verhalten beobachten
5. 5.Iterieren Sie

Die Seele Ihres Agenten ist nur Markdown-Text. Wenn Sie ein Dokument schreiben können, können Sie einen Agenten gestalten, der sich wie Ihrer anfühlt.

Für weitere Beispiele und von der Community beigesteuerte Vorlagen besuchen Sie die offizielle SOUL.md-Referenz und das soul.md-Vorlagenprojekt.