OpenClaw konfigurieren: SOUL.md, MEMORY.md und Heartbeats erklärt
Drei Dateien und ein Konzept entscheiden darüber, ob dein KI-Agent wirklich nützlich ist – oder nur ein teures Chatbot-Fenster bleibt. Dieser Artikel erklärt alle drei Kernkonzepte mit konkreten Beispielen.
OpenClaw ist kein gewöhnliches KI-Tool. Anders als ChatGPT oder andere Webdienste ist es ein persistenter Agent – er läuft dauerhaft, erinnert sich an Kontext und kann proaktiv handeln. Damit er das aber wirklich tut, braucht er drei Dinge: eine Persönlichkeit, ein Gedächtnis und einen Auftrag für regelmäßige Checks.
Genau das leisten SOUL.md, MEMORY.md und Heartbeats. Wer diese drei Konzepte versteht, hat seinen Agenten wirklich im Griff – und nicht umgekehrt.
SOUL.md – Wer ist dein Agent?
Die SOUL.md-Datei ist die Identitätsdefinition deines Agenten. Sie liegt im Workspace-Verzeichnis von OpenClaw und wird bei jeder Session als erstes eingelesen. Was du hier schreibst, prägt alles: Schreibstil, Kommunikationsweise, Prioritäten, ethische Grenzen.
Beispielinhalt für eine SOUL.md:
Je präziser deine SOUL.md, desto konsistenter verhält sich der Agent. Ein Agent ohne SOUL.md ist wie ein Mitarbeiter ohne Einarbeitung – er macht irgendetwas, aber nicht unbedingt das Richtige.
MEMORY.md – Was weiß er langfristig?
KI-Modelle haben kein natürliches Langzeitgedächtnis. Jede Session startet frisch. MEMORY.md löst dieses Problem elegant: Sie ist eine strukturierte Markdown-Datei, die der Agent bei wichtigen Entscheidungen oder Erkenntnissen aktualisiert.
Was gehört in MEMORY.md?
- Wichtige Kundenpräferenzen („Kunde A mag keine Bullet-Points, lieber Fließtext“)
- Aktive Projekte und deren Status
- Gelernte Lektionen („Angebote immer mit Zahlungsziel 14 Tage“)
- Wiederkehrende Aufgaben und Deadlines
- API-Keys oder wichtige Zugangsdaten (lokal, sicher)
Der Agent kann MEMORY.md selbst lesen und schreiben – wenn du ihn in SOUL.md dazu instruierst. So baut er über Zeit echtes Kontextwissen auf.
Heartbeats – Was prüft er regelmäßig?
Heartbeats sind der Mechanismus, der OpenClaw von einem reaktiven Chatbot zu einem proaktiven Assistenten macht. In konfigurierbaren Intervallen (z.B. alle 30 Minuten) führt der Agent automatisch eine Checkliste aus.
Diese Checkliste steht in der HEARTBEAT.md-Datei:
Der Agent läuft diese Checks durch und meldet sich nur, wenn etwas Relevantes aufgetaucht ist. Wenn nichts zu tun ist, antwortet er intern mit HEARTBEAT_OK und bleibt still.
Wichtig: Heartbeats sind kein Cron-Ersatz für zeitkritische Tasks. Für exakte Zeitpunkte (z.B. jeden Montag 9 Uhr) nutzt du Cron-Jobs. Heartbeats eignen sich für regelmäßige Checks, bei denen leichte Zeitdrift okay ist.
Das Zusammenspiel der drei Konzepte
SOUL.md
Definiert die Identität. Der Agent weiß, wer er ist und wie er handeln soll.
MEMORY.md
Gibt Kontinuität. Über Sessionen hinweg bleibt Kontext erhalten.
Heartbeats
Macht proaktiv. Der Agent handelt von sich aus, ohne Aufforderung.
Häufige Fragen zur OpenClaw-Konfiguration
Was ist SOUL.md?
SOUL.md ist die Persönlichkeitsdatei deines Agenten. Sie definiert, wer er ist, wie er kommuniziert und welche Werte er hat. Der Agent liest diese Datei am Anfang jeder Session.
Wozu dient MEMORY.md?
MEMORY.md ist das Langzeitgedächtnis des Agenten. Wichtige Informationen über Projekte und Präferenzen bleiben über Sessions hinaus erhalten.
Was sind Heartbeats?
Heartbeats sind regelmäßige automatische Checks – E-Mails prüfen, Kalender checken, Rankings überwachen. Sie machen den Agenten proaktiv statt reaktiv.
Wie oft sollte MEMORY.md aktualisiert werden?
Am besten nach jeder wichtigen Entscheidung oder Erkenntnis. Der Agent kann MEMORY.md selbst aktualisieren, wenn du ihn dazu instruierst.
Kann OpenClaw mehrere Heartbeat-Aufgaben gleichzeitig ausführen?
Ja. HEARTBEAT.md enthält eine Checkliste von Aufgaben, die bei jedem Trigger gebündelt geprüft werden – effizient und API-sparend.
🔒 Datenschutz & Sicherheitshinweis
KI-Assistenten wie OpenClaw verarbeiten Daten lokal auf deinem Gerät. Achte darauf, keine sensiblen personenbezogenen Daten (Passwörter, Gesundheitsdaten, Bankdaten) in Prompts einzugeben. Alle externen API-Aufrufe (z. B. an Claude oder OpenAI) unterliegen den Datenschutzbestimmungen des jeweiligen Anbieters. Für den produktiven Einsatz im Unternehmen empfehlen wir eine DSGVO-Prüfung deines Setups.
📚 Weiterführende Artikel
Deutsche OpenClaw-Community
Fragen, Tipps und Austausch mit anderen deutschen OpenClaw-Nutzern: Jetzt der Telegram-Gruppe beitreten →
Kostenloser Download
OpenClaw Starter-Guide
11 Seiten PDF — von der Installation bis zum ersten automatisierten Workflow. Jetzt kostenlos herunterladen.