OpenClaw 3.22 Upgrade-Checkliste: Praktische Schritte von einem Entwickler, der sich die Finger verbrannt hat

Vor dem Update auf OpenClaw 3.22

Überprüfen Sie Ihre .env-Datei auf Variablen mit den Präfixen CLAWDBOT_ oder MOLTBOT_. Version 3.22 hat all diese Variablen ohne Fallback oder Kompatibilität entfernt. Wenn Sie sie haben, startet Ihr Agent nicht und die Fehlermeldung wird nicht hilfreich sein. Benennen Sie alles zuerst in OPENCLAW_ um. Wenn Sie OpenClaw vor Mitte Februar eingerichtet haben, haben Sie mit ziemlicher Sicherheit mindestens eine dieser Variablen.

Führen Sie openclaw backup create aus, bevor Sie etwas anfassen. Erwägen Sie, Ihr aktuelles Docker-Image als :pre-upgrade zu taggen, damit Sie bei Bedarf sofort zurücksetzen können.

Nach dem Update auf OpenClaw 3.22

Führen Sie openclaw doctor --fix aus, das die meisten Konfigurationsmigrationen automatisch erkennt.

Überprüfen Sie /tools in einem beliebigen Kanal, um zu sehen, welche Tools tatsächlich verfügbar sind. Version 3.22 hat die Plugin-SDK-Oberfläche geändert (von openclaw/extension-api zu openclaw/plugin-sdk/*), sodass Drittanbieter-Plugins, die alte Importpfade verwenden, einfach stillschweigend nicht geladen werden.

Führen Sie openclaw secrets audit aus, um Klartext-API-Schlüssel in Ihrem Arbeitsbereich zu finden. Der Entwickler hat zwei gefunden, die völlig vergessen waren und in Skill-Konfigurationsdateien saßen.

Neue Funktionen in 3.22

• /btw Nebengespräche
• Native ClawHub-Installation über die CLI (openclaw skills install anstelle des manuellen Herunterladens von skill.md-Dateien)
• Bereinigung abgelaufener Sitzungen
• Cron-Wiederholungs-Backoff, damit ein fehlgeschlagener Job nicht über Nacht Ihr API-Budget aufbraucht
• 48-Stunden-Agent-Timeout statt 10 Minuten, was bedeutet, dass lange Aufgaben jetzt tatsächlich abgeschlossen werden

Der Entwickler empfiehlt, 30-45 Minuten für ein sorgfältiges Upgrade einzuplanen, anstatt davon auszugehen, dass es reibungslos verläuft, und merkt an, dass es danach "wirklich besser ist".