Automatisierung von OpenClaw-Upgrades mit einem KI-Agenten: Ein praxiserprobtes Playbook

OpenClaw-Upgrades sind berüchtigt dafür, Dinge zu zerstören – Legacy-Konfigurationsmigrationen, stille Funktionsänderungen und Edge Cases im Prozessmanagement. Ein Entwickler hatte genug davon, immer wieder dieselben Probleme neu zu entdecken, und brachte seinem Hermes-Agenten bei, den gesamten Upgrade-Prozess zu übernehmen. Das Ergebnis: Das letzte Upgrade von 2026.7.1 auf 2026.8.1 ('OpenClaw 2.0') ging von 'mehreren Stunden nervenaufreibender Fehlersuche' zu 'Runbook ausführen, zwei bekannte Stolpersteine treffen, beide in unter einer Minute automatisch diagnostiziert'.

Das Setup

Der Autor betreibt eine kleine Flotte: einen EC2-Gateway-Server und zwei Macs (ein MacBook Pro und einen Mac mini), auf denen jeweils die OpenClaw-CLI und die native App laufen. Alle zeigen auf dasselbe Backend. Dieses Multi-Host-Setup macht 'einfach neu starten und sehen' unpraktisch.

Die Kernidee: Das Gedächtnis deines Agenten ist das Produkt

Jeder Agent kann doctor --fix ausführen und die Ausgabe lesen. Der wahre Wert entsteht, wenn er:

• aufschreibt, was er gefunden hat, in einem durchsuchbaren Format.
• sein prozedurales Wissen aktualisiert (eine Fähigkeit/ein Runbook), sodass das nächste Upgrade von 'hier ist, was wir wissen' ausgeht.
• einen durchsuchbaren Speicher für vergangene Vorfälle abgleicht.

Der Autor verwendet drei Komponenten:

• Skill-Datei: Eine strukturierte Prozedur mit Stolpersteinen, aufgebaut über ~9 Monate Upgrades.
• Semantischer Speicher: MemPalace (github.com/mempalace/mempalace) indexiert vergangene Vorfall-Beschreibungen für unscharfe Suche wie 'Geräteidentitätskonflikt App'.
• Gemeinsame Kontextdatei: Wird auch vom OpenClaw-seitigen Agenten gelesen, damit Erkenntnisse von Hermes nicht isoliert bleiben.

Was bei 2026.8.1 tatsächlich schiefging

Drei spezifische Probleme und warum sie dich nicht zweimal überraschen sollten:

1. doctor --repair ist keine einmalige Operation. Bei einer ausgereiften Multi-Agenten-Installation erwarte, dass du es wiederholt ausführen musst – jeder Durchgang behebt eine Ebene der Legacy-Konfiguration/des Zustands und legt die nächste offen. Der Autor benötigte 11 Durchläufe allein auf dem Gateway, bevor es sauber endete. Nach Durchgang 2 aufzugeben führt zu Fehldiagnosen.
2. Multi-Agenten-Gateways benötigen explizites Eigentum. Wenn du mehr als eine Agenten-Persona pro Gateway betreibst, erfordert die neue Version die Deklaration, welche 'Eigentümer' von Ambient-/Systemoperationen ist. Es gibt zwei Deklarationsmodi – strikt und einfach. Der strikte verursachte einen kryptischen Crash-Loop; der einfache ist sicherer, es sei denn, du hast jeden Edge Case abgedeckt.
3. Eine Legacy-Konfigurationsdatei kann die gesamte Reparatur-Pipeline blockieren. Eine veraltete JSON-Datei (exec-approvals) verhinderte stillschweigend, dass andere Fixes angewendet wurden, bis sie speziell aufgelöst wurde.

Nichts davon ist OpenClaw-spezifisches Werkzeug – es ist nur 'Gib dem Agenten einen Ort zum Aufschreiben und die Gewohnheit, es zu tun.' Derselbe Ansatz funktioniert mit Claude Code, Codex oder jedem Agenten mit Werkzeugen.