Fehlerbehebung bei OpenClaw: Eine minimalistische Zurücksetzungsmethode

OpenClaw-Reset-Prozedur für instabile Einrichtungen

Wenn OpenClaw-Einrichtungen instabil werden – mit Skills, die Tokens verbrennen, Agents, die falsche Vervollständigungen melden, oder Updates, die Verbindungen unterbrechen – kann ein vollständiger Reset auf eine minimale Konfiguration die Ursache identifizieren. Dieser Ansatz isoliert Probleme, indem Komplexität entfernt wird.

Fünf-Schritte-Reset-Prozess

Schritt 1: Alle Skills entfernen (60 Sekunden)

Verschieben Sie alle Skills in ein Backup, um häufige Instabilitätsquellen zu beseitigen, wie stille Schleifen, Token-Verbrennung, Kontext-Injektion, Konfigurationsüberschreibungen oder Malware:

mkdir ~/.openclaw/skills-backup
mv ~/.openclaw/agents/*/skills/* ~/.openclaw/skills-backup/

Dies bewahrt die Skills für eine spätere Wiederherstellung, während die Kernfunktionalität des Agents getestet wird.

Schritt 2: Auf Claude Sonnet umstellen (30 Sekunden)

Ändern Sie die KI-Modell-Konfiguration, um modellbezogene Probleme auszuschließen:

{
  "ai": {
    "model": "claude-sonnet-4-5-20250929"
  }
}

Sonnet wird empfohlen, da es günstig, zuverlässig und konsistent im Tool-Calling ist. Wenn Ihre Einrichtung mit Sonnet funktioniert, aber nicht mit Opus, GPT-5.4 oder lokalen Modellen, war das Modell das Problem.

Schritt 3: Sitzungen löschen (15 Sekunden)

Entfernen Sie potenziell beschädigten Konversationsverlauf:

rm -rf ~/.openclaw/agents/*/sessions/*

Dies betrifft nicht SOUL.md, Speicher, USER.md oder permanente Konfigurationen – nur Sitzungsdaten, die nach Updates oder Modellwechseln beschädigt werden können.

Schritt 4: SOUL.md vereinfachen (60 Sekunden)

Überprüfen Sie Ihre aktuelle SOUL.md und ersetzen Sie sie bei Bedarf durch eine minimale Version:

cat ~/.openclaw/agents/*/SOUL.md

Ersetzen Sie sie durch diese 5-Zeilen-Version:

Sei direkt. Kein Füllmaterial. Passe meinen Ton an.
Wenn ich eine Frage stelle, beantworte sie zuerst.
Sage niemals "absolut", "tolle Frage" oder "Ich würde mich freuen".
Wenn du etwas nicht weißt, sag es.
Wenn eine Aufgabe erhebliche Tokens kosten wird, sag es mir, bevor du sie ausführst.

Fügen Sie basierend auf dem, was Sie in der nächsten Woche stört, schrittweise weitere Anweisungen hinzu.

Schritt 5: Neustarten und testen (30 Sekunden)

Starten Sie OpenClaw neu und senden Sie eine grundlegende Nachricht:

openclaw stop
openclaw start

Testen Sie mit einfachen Abfragen wie "Welcher Tag ist heute?" oder "Fasse diesen Artikel zusammen" mit einer URL. Wenn es korrekt antwortet, ohne seltsames Verhalten, funktioniert Ihr Kern. Probleme kamen von dem, was Sie entfernt haben. Fügen Sie Komponenten einzeln wieder hinzu und testen Sie nach jeder Ergänzung.

Warum dies funktioniert

Die meisten OpenClaw-Einrichtungen sammeln Skills, Agents, Cron-Jobs, Modellwechsel und Konfigurationsanpassungen, bis eine Komponente zum Zusammenbruch führt. Da alles gleichzeitig hinzugefügt wurde, wird die Identifizierung des problematischen Teils unmöglich. Das Zurückstutzen auf minimale Konfiguration und schrittweise Wiederaufbau schafft stabile Einrichtungen.

Nach der Implementierung dieses Resets berichtete ein Nutzer von einer stabilen Einrichtung mit einem Agent, Sonnet und vier Skills (Websuche, tägliches Briefing, Notizenschreiber und ein benutzerdefiniertes Python-Skript für E-Mail-Vorauswahl), die weniger als 10 $/Monat kostet und seit über vier Wochen ohne Probleme läuft.