Entwickler und kleine Teams, die OpenClaw bereits auf einem lokalen Mac ausführen und Gateway plus Agentenspeicher auf einen dedizierten KVMNODE-Cloud-Mac verschieben müssen – oder die einen Regionswechsel, ein M4 Pro-Upgrade oder einen Knotenneuaufbau planen und SPEICHER und Fähigkeiten zum Überleben benötigentrifft auf einen bekannten Fehlermodus für 2026:Das Installationsskript ist erfolgreich, aber der Agent fühlt sich brandneu an, da der Arbeitsbereichspfad verschoben wurde~/.openclaw/workspaceZuworkspace-mainoder ein anderes pro-Agent-Verzeichnis ohne Rollback-Tarball. In diesem Artikel wird eine vierwurzelige „Post-Migration-Amnesie“-Tabelle vorgestellt, eine Verzeichnisliste, die unbedingt gepackt werden muss bzw. nicht kopiert werden darf, sowie sechs Schritte vom lokalen Tarball zuopenclaw doctorauf dem Cloud-Host und einen Ebenen-Entscheidungsbaum, wenn ein großer Arbeitsbereich die Maschine mit Xcode-seitigen Builds teilt. Lesen Sie es mit demoffizieller Installations-Daemon,Diagnoseleiter,Kanäle Sonde,Persistenz-Grundlinie, UndHeadless SSH-KomplettlösungSie wiederholen also nicht „nur Konfiguration, kein Speicher“ in der Cloud.
01

2026 OpenClaw fühlt sich nach der Migration wie ein frischer Agent an: vier Wurzeln, die Sie in einen Änderungsdatensatz einfügen können

OpenClaw behältKonfiguration und Anmeldeinformationenunter~/.openclaw/UndLangzeitgedächtnis, Persönlichkeit und Fähigkeitenin der Arbeitsbereichsstruktur (Standard).~/.openclaw/workspace; Multi-Agent-Setups können verwendet werdenworkspace-{agentId}). Community-Berichte rund um 2026.3.x beschreiben Bewegungen von einem einzigenworkspacezu Pro-Agent-Pfaden woMEMORY.md undmemory/YYYY-MM-DD.mdwurden nicht automatisch kopiert: Gateway startet immer noch, aber der kuratierte Speicher liest ein leeres Verzeichnis – daher „hat das Upgrade das Gehirn gelöscht.“ Wenn Sie „Konfigurationsverlust“ nicht vom „Arbeitsbereichsverlust“ getrennt haben, werden Sie Zeit damit verschwenden, Modelle auszutauschen oder Kanäle neu zu verkabeln.

Die zweite Wurzel istscp vonopenclaw.jsonnur, ohnecredentials/,sessions/, und Arbeitsbereichsdateien wieskills/,AGENTS.md, UndSOUL.md; Das Dashboard wird möglicherweise geladen, während sich die Tools wie zuerst an Bord verhalten. Der dritte istLaunchd-Umgebungsdrift im Vergleich zu einer interaktiven Shell: plistWorkingDirectoryoderOPENCLAW_*weisen nach dem Wolkenzug immer noch auf alte Pfade hin. Der vierte istüberspringenopenclaw doctorüber eine große Versionslücke hinweg, wodurch die Schemamigration zur Hälfte abgeschlossen ist und die Felder stillschweigend auf die Standardeinstellungen zurückgesetzt werden. Ausrichten mitPersistenz-GrundlinieErstens: Statusverzeichnisse dürfen sich nicht in Team-Synchronisierungsordnern befinden – sonst verstärken kleine Schreibvorgänge mit hoher Frequenz den Sperrenkonflikt auf Synchronisierungsebenen.

01

Pfadänderung pro Agent ohne Kopie:altworkspace/*bleibt auf der Festplatte, während Gateway auf eine leere Festplatte zeigtworkspace-main.

02

Konfiguration ohne Arbeitsbereich: openclaw.jsongegenwärtig,MEMORY.mdfehlen.

03

Drift des Daemon-Arbeitsverzeichnisses:launchd verweist immer noch auf einen Laptop-Pfad oder einen freigegebenen Mount auf dem alten Knoten.

04

Versionslücke ohne Arzt:Schema- und Binärkonflikt; Die Felder ziehen sich leise zurück.

05

Geräte-Tokens als tragbare Dateien behandeln:Kopieren schlägt fehl; Führen Sie auf dem Ziel erneut ein Pairing durch und protokollieren Sie es separat.

Nachoffizieller Installations-DaemonAuf dem Cloud-Host sollte die Migrationsakzeptanz vier Zeilen einfrieren:Absoluter Pfad des Arbeitsbereichs, Openclaw-Version, Exit-Code des Arztes, ID oder Zeitstempel der ersten Geschäftsnachricht. Bei jedem Regions- oder Tierwechsel muss eine dieser Zeilen aktualisiert und der vorherige Tarball-Hash für das Rollback beibehalten werden – nicht „wir haben wahrscheinlich ein Backup gemacht“. Wenn sich Kanäle nach der Migration schlecht verhalten, führen Sie Folgendes ausKanäle Sondeauf Abhör-Ports und Token-Wahrheit, bevor Speicherverzeichnisse dafür verantwortlich gemacht werden.

Plattformbesitzer sollten die Vorlagen „Migration“ und „Greenfield-Installation“ aufteilen: Greenfield kann von einem leeren Arbeitsbereich ausgehen; Bei der Migration müssen Tarball-Prüfsummen und Doctor-Ausgaben angehängt werden. Durch das Mischen von Vorlagen sieht „Leeren Speicher akzeptieren“ wie die Standardeinstellung bei der Überprüfung aus und hinterlässt keine Story für die Beteiligten, wenn der kuratierte Speicher verschwindet.

02

Backup-Liste vor der Migration: unbedingt packen, gut packen und niemals roh kopieren

Das Ziel ist nicht „das gesamte Home-Verzeichnis zu tarnen“, sondernGateway auf dem Ziel, das nach dem Arzt die gleichen Gedächtnis- und Fähigkeitsgrenzen liest. Unbedingt einzupackende Artikel:~/.openclaw/openclaw.json,credentials/,sessions/wenn Sie sich auf Sitzungskontinuität verlassen, und die vollständige Arbeitsbereichsstruktur einschließlich mindestensMEMORY.md,memory/,skills/, UndUSER.mdwie Ihr Team sie tatsächlich nutzt. Fügen Sie optional sieben Tage lang rotierte Protokolle aus Ihrer persistenten Protokollsenke hinzu, um sie an der anzupassenDiagnoseleiter, aber überladen Sie den Tarball der Produktionsmigration nicht mit riesigen Protokollen.

Fügen Sie die folgende Tabelle in das Feld „Inhalt des Migrationspakets“ des Änderungsdatensatzes ein und führen Sie sie neben den PATH-Prüfungen aus ausHeadless SSH-Komplettlösung: Beweisen Sie, was sich im Tarball befindet, und beweisen Sie dann, was das Ziel gelesen hat.

Pfad / ObjektErforderlichCloud-Mac-Notizen
openclaw.json + AnmeldeinformationenJaBerechtigungen nach dem Extrahieren verschärfen; Synchronisieren Sie niemals Ordner im Team
Vollständiger Arbeitsbereich (SPEICHER, Gedächtnis/, Fähigkeiten/)JaÜbereinstimmung mit Ziel-AgentId-Verzeichnisnamen
Sitzungen/PolitikGroße Bäume: Nur aktive Teilmenge migrieren
Geräte-Tokens/SchlüsselbundartikelNicht kopierenAm Ziel erneut koppeln
LaunchAgent-Plist wird überschriebenVorsichtPfade und Label korrigieren, Daemon neu installieren

Fehlt MEMORY.md im Tarball, bedeutet dies, dass Gateway neu installiert und nicht migriert wird.

Aufzeichnenshasum -a 256auf der Quelle und hängen Sie es an den Änderungsdatensatz an, um abgeschnittene SCP-Übertragungen abzufangen. Verschieben Sie Archive über genehmigte verschlüsselte Kanäle (Bastion Rsync) und nicht über langlebige öffentliche Objekt-Buckets mit API-Anmeldeinformationen. Wenn der Arbeitsbereich einige Gigabyte überschreitet – große Skill-Assets oder Speicherprotokolle –, passen Sie die Größe anZiel-SSD-Stufevor der Übertragung; Das hängt direkt mit dem M4 Pro-Entscheidungsbaum unten zusammen.

03

Befehlsblock: Lokaler Tarball, Upload und Pfadprüfungen vor Doctor

Ersetzen Sie die Versionen durch Ihren eingefrorenen Openclaw-Build und hängen Sie einen Tarball anshasum -a 256zum Änderungssatz. Bestätigenpassende Node-Hauptversionenüber Quelle und Ziel; andernfalls zuerst auf dem Ziel installieren und dann den Arbeitsbereich entpacken, wobei Halbzustände „neue Binärdatei, alter Speicher“ vermieden werden. Wenn CLI nicht auf dem Cloud-Host installiert ist, schließen Sie den Vorgang aboffizielle Installationvor dem Auspacken – Reihenfolge nicht umkehren.

bash
openclaw --version
ls -la ~/.openclaw/workspace*
tar -czf openclaw-migrate-$(date +%Y%m%d).tgz \
  -C "$HOME" .openclaw/openclaw.json \
  -C "$HOME" .openclaw/credentials \
  -C "$HOME" .openclaw/workspace
shasum -a 256 openclaw-migrate-*.tgz
scp openclaw-migrate-*.tgz user@cloud-mac:~/
ssh user@cloud-mac 'openclaw gateway stop || true'
ssh user@cloud-mac 'tar -xzf openclaw-migrate-*.tgz -C $HOME && openclaw doctor'

Tipp:Fürworkspace-mainoder andere pro-Agent-Ordner, ändern Sie tar-CWege zu deinem wahrenworkspace-*Namen; Halten Sie nicht interaktive PATH-Prüfungen an der AusrichtungHeadless SSH-Komplettlösung.

Nichtgateway startunmittelbar nach dem Extrahieren: Ausführenopenclaw doctor, speichern Sie die vollständige Standardausgabe im Änderungsdatensatz und vergleichen Sie sieMEMORY.mdZeitstempel mit der Quelle. Wenn der Arzt eine Migration des Arbeitsbereichspfads vorschlägt,zusammenführen statt überschreibenes sei denn, der Datensatz akzeptiert ausdrücklich leeren Speicher. Führen Sie install-daemon erst aus, nachdem Doctor erfolgreich war, damit Plist-Pfade während der Zusammenführung nicht auf leere Verzeichnisse verweisen.

04

Sechs Schritte: Rollback-freundlicher Weg vom lokalen Paket zur ersten Nachricht auf dem Cloud-Mac

01

Versionen einfrieren und Arbeitsbereichspfade aufzeichnen:erfassenopenclaw --versionUndls ~/.openclaw/workspace*auf dem Änderungsprotokoll.

02

Stoppen Sie das Quell-Gateway und erstellen Sie einen Tarball:JSON, Anmeldeinformationen, vollständiger Arbeitsbereich; schreibe sha256.

03

Bereiten Sie nicht synchronisierte Zielpfade vor:Root-freier Speicherplatz mindestens 1,5× entpackte Größe.

04

Ziel-Gateway hochladen und stoppen:Vermeiden Sie beim Extrahieren doppelte Schreibsitzungen.

05

Doctor dann install-daemon:Plist-Wahrheit mit der ausrichtenoffizieller Weg.

06

Annahme der ersten Nachricht:SPEICHER-Snippet, Kanalprüfung, wenn verkabelt, einzeiliges Gateway-Zustands-JSON.

Wenn die sechs Schritte abgeschlossen sind, sollte das Ticket beantworten, welcher Hebel bewegt wurde: Tarball-Inhalt, Arbeitsbereichspfad, Doctor-Ergebnis oder Ebene. Sogar KVMNODE-Regionsverschiebungen sollten einen Tarball im Artefaktspeicher archivieren –Regionsänderungen verändern häufig die IP- und Ausgangsrichtlinien; Rollback benötigt Speicher plus Konfiguration, kein leeres Gateway. Während der Akzeptanzwoche, Schnappschussopenclaw doctortäglich und ordnet Felder L1/L2 zuDiagnoseleiter.

05

Region und Stufe: M4 vs. M4 Pro, wenn Arbeitsbereich, Fähigkeiten und Xcode einen Host teilen

Das Wachstum des Arbeitsbereichs betrifft oft die Festplatte, bevor es die CPU erreicht: vielememory/*.mdStress durch Dateien, Skill-Repos und parallele DownloadsFestplatten-IOPS und einheitlicher Speicherseiten-Cache. Wenn das Xcode- oder Flutter-Archiv nach der Migration auf demselben dedizierten Host ausgeführt wird, verfolgen Sie esRoot-Auslastung nach dem Entpacken, Gateway-Zustand P95 und Speicherdruck während paralleler Buildswährend der Annahmewoche.

A

Größe des entpackten Arbeitsbereichs:über 30 GB oder wöchentliches Wachstum über 5 GB – rotieren Sie Speicher und Skill-Assets, bevor Sie einen Stufensprung vornehmen.

B

Einheitlicher Speicherdruck:Protokollmemory pressureEreignisse, bei denen Builds und Gateway gemeinsam ihren Höhepunkt erreichen; Zählungen zur Beschaffung hinzufügen.

C

Region und RTT:Die Ankunft des Tarballs ist keine Colocation auf der Datenebene – richten Sie Git und Artefakte aus, bevor Sie M4 Pro sperren.

ProfilM4 16 GB/25624 GB/512M4 Pro hoher einheitlicher Speicher
Heller Arbeitsbereich + einzelnes GatewayOKSichererOft im Übermaß
Großer SPEICHER + viele Fähigkeiten + tägliche SpeicherprotokolleRisikoBevorzugtHängt von der Parallelität ab
Migrationswoche mit iOS CI und AgentNicht empfohlenMediumBevorzugt

Notiz:„In die Cloud verschoben“ ist kein Backup – Neuerstellungen und Regionsverschiebungen können lokale Festplatten löschen; Die Aufbewahrung von Tarballs muss eine Teamrichtlinie sein.

Ein persönlicher Mac als einzige Backup-Quelle ergibtunvorhersehbare Backup-Fenstermit Schlaffunktion bei geschlossenem Deckel und ohne kontrahierbare 7x24-Funktion; Cron auf Laptops bricht bei Benutzerwechseln und Berechtigungsaufforderungen ab. Notebooks mit hohem Ruhezustand sind nach der Migration schlechte Hosts für fortlaufende Schreibvorgänge im Speicherprotokoll. Für Teams, die überprüfbare, regional flexible und auf Ebenen aufrüstbare dedizierte Hosts für OpenClaw-Speicher plus Gateway benötigen,Die Cloud-Miete von KVMNODE Mac Mini ist in der Regel die bessere Lösung: dediziertes Apple Silicon, sechs Regionen, tagesaktuelle Laufzeiten und die gleiche Platzierungssprache für „Einpacken – Auspacken – Arzt“ und CI. Bestellen Sie überBestellseite, Runbooks in derHilfecenter, SKUs aufPreisgestaltung.