OpenClaw v2.0-Update: Wichtige Checkliste vor dem Update, um Breaking Changes zu vermeiden

OpenClaw Major Update erfordert Vorbereitung vor dem Update

OpenClaw hat sein größtes Update seit Monaten veröffentlicht, mit 12 Breaking Changes, einem komplett neuen Plugin-System und über 30 Sicherheitspatches. Das Update wird Setups stillschweigend beschädigen, wenn Benutzer npm update ohne vorherige Vorbereitung ausführen.

Schritt 1: Umgebungsvariablen prüfen

Veraltete Umgebungsvariablen aus der Zeit, als OpenClaw noch Clawdbot oder Moltbot hieß, funktionieren nicht mehr. Es gibt keinen Kompatibilitäts-Shim, Fallback oder Warnung. Prüfen Sie auf alte Variablen:

env | grep -i clawdbot
env | grep -i moltbot

Wenn etwas angezeigt wird, benennen Sie sie um:

• CLAWDBOT_* → OPENCLAW_*
• MOLTBOT_* → OPENCLAW_*

Überprüfen Sie Ihre .env, .bashrc, .zshrc, .profile und alle docker-compose-Dateien. Fehlende Variablen führen dazu, dass OpenClaw mit Standardeinstellungen statt Ihrer Konfiguration startet.

Schritt 2: Zustandsverzeichnis prüfen

Die automatische Erkennung des alten Verzeichnisnamens ist weg. Prüfen Sie Ihr aktuelles Zustandsverzeichnis:

ls ~/.moltbot 2>/dev/null && echo "SIE MÜSSEN DIES VERSCHIEBEN"
ls ~/.openclaw 2>/dev/null && echo "alles in Ordnung"

Wenn Sie noch bei ~/.moltbot sind, verschieben Sie es vor dem Update:

mv ~/.moltbot ~/.openclaw

Oder legen Sie den Pfad explizit fest:

export OPENCLAW_STATE_DIR=~/.openclaw

Wenn Sie zuerst updaten, erstellt OpenClaw ein neues ~/.openclaw-Verzeichnis mit leerer Konfiguration.

Schritt 3: Konfiguration sichern

Erstellen Sie vor dem Update eine Sicherung:

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

Dies beinhaltet Ihre SOUL.md, USER.md, MEMORY.md, Agenten-Konfiguration, Skills und alles andere.

Schritt 4: Browser-Automatisierungssetup prüfen

Das veraltete Chrome-Erweiterungs-Relay wurde vollständig entfernt. Wenn Ihre Browser-Konfiguration driver: "extension" oder browser.relayBindHost verwendet, haben diese Einstellungen jetzt keine Wirkung mehr. Prüfen Sie Ihre Konfiguration:

openclaw config get | grep -i browser

Der neue Ansatz verwendet die Anbindung an bestehende Browser-Sitzungen. OpenClaw verbindet sich mit einem bereits laufenden Browser, anstatt einen über eine Erweiterung zu steuern. OpenClaw verwaltet jetzt sein eigenes Browser-Profil (das openclaw-Profil) oder verbindet sich über CDP mit einer bestehenden Chrome-Sitzung.

Schritt 5: Clawhub-Änderung verstehen

Clawhub ist jetzt der Standard-Plugin- und Skill-Store. Wenn Sie openclaw plugins install oder openclaw skills install ausführen, prüft es zuerst Clawhub und greift nur auf npm zurück, wenn es das Paket dort nicht finden kann. Das bedeutet:

• Einige über npm installierte Skills müssen möglicherweise über Clawhub neu installiert werden
• openclaw skills search, openclaw skills install und openclaw skills update sind neue Befehle, die ClawHub nativ verwenden
• Wenn ein Skill nicht auf Clawhub ist, können Sie ihn weiterhin von npm installieren (es ist ein Fallback, keine Entfernung)

Nach dem Update führen Sie aus:

openclaw skills update

Um sicherzustellen, dass Ihre vorhandenen Skills mit dem neuen System synchronisiert sind.