OpenClaw Setup Guide: AGENTS.md zuerst, dann Skills, Memory und Automationen

Florian · · ~6 Min. Lesezeit
AI Blog
OpenClaw Setup Guide: AGENTS.md zuerst, dann Skills, Memory und Automationen

Last updated on March 24, 2026, 7:42 PM

OpenClaw Setup Guide: AGENTS.md zuerst, dann Skills, Memory und Automationen

Wenn OpenClaw nach ein paar Tagen „komisch“ wird, liegt es selten am Modell. Meist liegt es am Setup: zu viele Regeln an der falschen Stelle, zu frühe Automationen, unsaubere Rollen zwischen Dateien und ein Memory, das eher Datenhalde als Wissen ist. Genau dort verbrennst du Zeit, Tokens und Nerven.

Die gute Nachricht: Du kannst das in einer Session drehen. Dieser Guide zeigt dir eine Reihenfolge, die in der Praxis stabil bleibt – inklusive typischer Fehlerbilder und klarer Fixes.

In diesem Artikel lernst du …

  • warum AGENTS.md zuerst kommen muss (und wie kurz sie bleiben sollte),
  • wie du SOUL.md, USER.md, MEMORY.md, TOOLS.md ohne Chaos trennst,
  • was es mit den zwei Config-Layern auf sich hat,
  • wie du Memory so pflegst, dass OpenClaw konsistent bleibt,
  • wie du Header-/Content-Workflows als Skills sauber standardisierst,
  • und wie du das Setup langfristig sauber und wartbar hältst.

Inhaltsüberblick

  1. Der Kernfehler in den meisten Setups
  2. AGENTS.md als Betriebssystem (nicht als Notizzettel)
  3. Dateirollen richtig trennen
  4. Die zwei Config-Layer verstehen
  5. Setup-Plan in 6 Schritten
  6. Praxisbeispiele (inkl. Commands)
  7. Typische Fehler: Symptom → Ursache → Fix
  8. Vorher/Nachher: Wie sich ein gutes Setup anfühlt
  9. Setup-Checkliste für den produktiven Alltag
  10. Fazit + Ausblick + direkte OpenClaw-CTA

1) Der Kernfehler in den meisten Setups

Viele starten mit dem spannendsten Teil: Skills, Agentenketten, Cron-Jobs, Integrationen. Das ist nachvollziehbar – aber operativ riskant. Ohne klares Fundament entstehen Widersprüche:

  • Der Agent klingt jedes Mal anders,
  • Policies werden inkonsequent umgesetzt,
  • dieselbe Aufgabe läuft je nach Session unterschiedlich,
  • und die Qualität sinkt mit wachsendem Kontext.

Kurz gesagt: Das Setup ist „mächtig“, aber nicht zuverlässig.

Pro-Tipp: Denk bei OpenClaw wie bei Infrastruktur: erst Baseline, dann Skalierung. Niemand baut zuerst Auto-Scaling-Regeln und fragt danach, wie das System überhaupt bootet.

2) AGENTS.md ist dein Betriebssystem

AGENTS.md ist die Datei, die entscheidet, wie dein Agent im Alltag wirklich arbeitet. Nicht theoretisch, sondern operativ.

Hier definierst du verbindlich:

  • Welche Aufgaben der Agent proaktiv erledigen soll
  • Welche Aktionen nur mit Freigabe passieren dürfen
  • Welche Sicherheitsregeln niemals verletzt werden
  • Wie Memory gepflegt und priorisiert wird
  • Wie Fehler transparent gemeldet werden

Warum „AGENTS.md first“ so wichtig ist

Wenn AGENTS.md schwach ist, müssen spätere Dateien Lücken stopfen. Das macht das System spröde. Mit einer klaren AGENTS.md werden SOUL, USER, MEMORY und Skills zu Verstärkern statt zu Konfliktquellen.

Harte Regel aus der Praxis: kurz halten

Ja, dieser Punkt aus euren Screens ist absolut korrekt: AGENTS.md kompakt halten (Daumenregel: unter ca. 300 Zeilen).

Der Effekt ist messbar:

  • bessere Regelbefolgung,
  • weniger Kontextballast,
  • schnellere Anpassungen,
  • weniger „warum macht er das jetzt anders?“-Momente.

3) Dateirollen trennen: Wer macht was?

Die einfachste Methode, Stabilität zu verlieren, ist Rollenvermischung. Daher klare Zuordnung:

  • SOUL.md: Stimme, Temperament, Kommunikationsprinzipien
  • USER.md: Nutzerpräferenzen, Policies, Arbeitsstil
  • IDENTITY.md: Name/Rolle/Grundvibe des Agents
  • MEMORY.md: kuratierte Langzeitfakten und Entscheidungen
  • memory/YYYY-MM-DD.md: Tagesprotokolle und frische Learnings
  • TOOLS.md: lokale Umgebung, Pfade, betriebliche Notizen
  • HEARTBEAT.md: Poll-Verhalten und proaktive Routinen

Wenn jede Datei eine klare Aufgabe hat, bleibt dein System wartbar. Wenn nicht, debugst du Diskussionen zwischen Dateien statt echte Probleme.

4) Der oft übersehene Hebel: Zwei Config-Layer

Ein zentraler Punkt aus den Screens: OpenClaw hat praktisch zwei Ebenen, die du gedanklich trennen musst.

Layer A: Global/Install (Runtime-Basis)

  • Grundinstallation
  • Built-ins
  • systemweite Defaults

Layer B: Workspace (dein Verhalten)

  • AGENTS.md, SOUL.md, USER.md
  • Memory-Struktur
  • Skills, lokale Regeln, Projektlogik

Merksatz: Global stellt die Maschine bereit. Workspace bestimmt, wie sie für dich arbeitet.

Wenn du das verwechselst, bekommst du Ghost-Bugs („ich habe doch geändert – warum passiert nichts?“).

5) Setup-Plan in 6 Schritten (copybar)

Hier ist ein sauberer Setup-Plan, den du direkt anwenden kannst.

Schritt 1: AGENTS.md auf Kernregeln reduzieren

Formuliere 5–10 harte Betriebsregeln. Kein Roman, kein Fülltext.

Schritt 2: SOUL + USER sauber trennen

SOUL = Kommunikationscharakter, USER = konkrete Präferenzen/Policies.

Schritt 3: Memory-Backbone aufbauen

  • MEMORY.md für langlebige Dinge
  • tägliche Einträge in memory/YYYY-MM-DD.md
  • später Verdichtung in memory/knowledge/*

Schritt 4: Secrets korrekt auslagern

  • .secrets/ nutzen
  • .gitignore strikt setzen
  • niemals Klartext-Keys in TOOLS.md oder Blogcontent

Schritt 5: Heartbeats minimal definieren

Nur klare Trigger-Logik. Kein „mach mal irgendwas Nützliches“.

Schritt 6: Erst jetzt Skills/Automationen erweitern

Skills mit Triggern, Guardrails und definiertem Output bauen. Danach Cron/Subagents.

6) Drei konkrete Praxisbeispiele (inkl. Commands)

Beispiel A: Kontext driftet, Antworten werden diffuser

Symptom: Gute Antworten am Anfang, später vage und teuer.
Ursache: Zu viel unverdichteter Kontext.
Fix: Status prüfen, kompaktieren, sauber trennen.

Hilfreiche Commands:

  • openclaw status
  • /status
  • /compact (wenn verfügbar)

Beispiel B: Agent reagiert in Telegram anders als erwartet

Symptom: Ton oder Verhalten passt nicht zur Situation.
Ursache: Regeln stecken verstreut in mehreren Dateien, Priorität unklar.
Fix: AGENTS.md priorisieren, SOUL/USER verschlanken, Konflikte entfernen.

Beispiel C: Wiederkehrende Content-Aufgaben sind inkonsistent

Symptom: Header-Look schwankt, Dateinamen und Alt-Texte uneinheitlich.
Ursache: Ad-hoc statt Skill-Workflow.
Fix: Header als festen Skill mit Preflight und Style-Referenz führen.

7) Fehler vermeiden: Symptom → Ursache → Fix

Fehlerbild 1: „Setup wirkt mächtig, aber fragil“

  • Ursache: Overengineering vor Fundament
  • Fix: Reihenfolge zurücksetzen: AGENTS → Rollenfiles → Memory → Skills → Automation

Fehlerbild 2: „Ich finde Regeln nicht mehr“

  • Ursache: Dateirollen vermischt
  • Fix: Eine Rolle pro Datei, harte Entmischung

Fehlerbild 3: „Plötzlich ist alles auf alte Abläufe zentriert, obwohl dein Setup längst anders arbeitet“

  • Ursache: Alte Baselines im Kopf statt aktuellem Ist-Stand
  • Fix: Immer zuerst den aktiven Workflow prüfen, dann Memory als Kontext nutzen

Fehlerbild 4: „Sicherheitsangst bei Kollaboration“

  • Ursache: Secrets unsauber abgelegt
  • Fix: .secrets/ + .gitignore, Schlüssel nie in versionierte Notizen

8) Vorher/Nachher: Wie sich ein gutes Setup anfühlt

Vorher

Du hast viele Funktionen, aber keine Vorhersagbarkeit. Das System wirkt beeindruckend, solange die Aufgabe simpel ist. Unter Last oder bei Themenwechseln bricht Konsistenz weg.

Nachher

Das Setup ist ruhiger. Weniger Magie, mehr Zuverlässigkeit. Du bekommst reproduzierbare Antworten, klarere Entscheidungen und deutlich weniger Korrekturschleifen.

9) Setup-Checkliste für den produktiven Alltag

Bevor du neue Skills oder Automationen einbaust, mach diesen schnellen Qualitätscheck. Er kostet dich fünf Minuten und spart dir oft Stunden Debugging.

  1. AGENTS.md ist kompakt und enthält nur operative Regeln.
  2. SOUL/USER/IDENTITY sind sauber getrennt und widersprechen sich nicht.
  3. MEMORY.md enthält nur langlebige Infos; Tagesdetails liegen in memory/YYYY-MM-DD.md.
  4. HEARTBEAT.md ist eindeutig formuliert (keine vagen Aufgaben).
  5. TOOLS.md enthält keine Geheimnisse im Klartext.
  6. Skills haben klare Trigger, Guardrails und definierte Outputs.
  7. Die letzten zwei Sessions zeigen konsistente Antworten auf ähnliche Aufgaben.

Wenn du bei 6/7 Punkten „ja“ hast, ist dein Setup in einem sehr soliden Bereich.

10) Fazit und Ausblick

OpenClaw wird nicht durch mehr Features besser, sondern durch bessere Struktur. Wenn AGENTS.md klar ist und die Rollen sauber getrennt sind, skaliert der Rest fast von selbst: Memory wird nützlich, Skills werden reproduzierbar, Automationen bleiben beherrschbar.

Der wichtigste Satz dieses Artikels bleibt derselbe:

AGENTS.md zuerst. Alles andere ist Ausbau.

CTA: Frag OpenClaw direkt zu deinem eigenen Setup

Wenn du den schnellsten Qualitätsgewinn willst, lass OpenClaw dein Setup analysieren. Zum Beispiel mit:

  • „Was ist aktuell mein größter Token-Fresser?“
  • „Welche 3 Änderungen an AGENTS.md verbessern sofort Stabilität und Kosten?“
  • „Wo vermische ich Rollen zwischen SOUL, USER und MEMORY?“
  • „Welche meiner Automationen sollte ich in Skills überführen?“

Genau dort zeigt sich, ob dein Setup nur gut aussieht – oder im Alltag wirklich trägt.

Weiterführende Artikel