OpenClaw conserveconfiguration et informations d'identificationsous~/.openclaw/etmémoire à long terme, personnalité et compétencesdans l'arborescence de l'espace de travail (par défaut~/.openclaw/workspace; les configurations multi-agents peuvent utiliserworkspace-{agentId}). Les rapports de la communauté autour de 2026.3.x décrivent les mouvements d'un seulworkspacevers des chemins par agent oùMEMOIRE.md etmemory/YYYY-MM-DD.mdn'ont pas été copiés automatiquement: Gateway démarre toujours, mais la mémoire organisée lit un répertoire vide, d'où « la mise à niveau a effacé le cerveau ». Si vous n'avez pas séparé la « perte de configuration » de la « perte d'espace de travail », vous perdrez du temps en échangeant des modèles ou en recâblant les canaux.

La deuxième racine estscp deopenclaw.jsonseulement, sanscredentials/,sessions/, et les fichiers d'espace de travail tels queskills/,AGENTS.md, etSOUL.md; le tableau de bord peut se charger tandis que les outils se comportent comme les premiers intégrés. Le troisième estdérive de l'environnement de lancement par rapport à un shell interactif: plistWorkingDirectoryouOPENCLAW_*pointez toujours sur les anciens chemins après le déplacement des nuages. Le quatrième estsautopenclaw doctorà travers un grand écart de version, laissant la migration du schéma à moitié terminée et les champs revenant silencieusement aux valeurs par défaut. Aligner avecligne de base de persistanceTout d'abord : les répertoires d'état ne doivent pas résider dans les dossiers de synchronisation de l'équipe, sinon les petites écritures à haute fréquence amplifieront les conflits de verrouillage sur les couches de synchronisation.

Aprèsdémon d'installation officielsur l'hôte cloud, l'acceptation de la migration doit figer quatre lignes :chemin absolu de l'espace de travail, version openclaw, code de sortie du médecin, identifiant du premier message professionnel ou horodatage. Tout changement de région ou de niveau doit mettre à jour l'une de ces lignes et conserver le hachage de l'archive tar précédente pour la restauration, et non « nous avons probablement sauvegardé ». Si les canaux se comportent mal après la migration, exécutez lesonde de canauxsur les ports d'écoute et la vérité des jetons avant de blâmer les répertoires de mémoire.

Les propriétaires de plate-forme doivent diviser les modèles « migration » et « installation sur site nouveau » : le champ nouveau peut démarrer à partir d'un espace de travail vide ; la migration doit joindre les sommes de contrôle de l'archive tar et la sortie du médecin. En mélangeant des modèles, « accepter la mémoire vide » ressemble à la valeur par défaut lors de l'examen et ne laisse aucune histoire aux parties prenantes lorsque la mémoire organisée disparaît.

Le but n’est pas de « tarer tout le répertoire personnel » maisPasserelle sur la cible lisant les mêmes limites de mémoire et de compétences après le médecin. Articles incontournables :~/.openclaw/openclaw.json,credentials/,sessions/lorsque vous comptez sur la continuité de la session et sur l'arborescence complète de l'espace de travail comprenant au moinsMEMORY.md,memory/,skills/, etUSER.mdcar votre équipe les utilise réellement. Incluez éventuellement sept jours de journaux en rotation à partir de votre récepteur de journaux persistant pour un alignement avec leéchelle de diagnostic, mais ne surchargez pas l'archive tar de migration de production avec des journaux géants.

Collez le tableau ci-dessous dans le champ « Contenu du package de migration » de l'enregistrement de modification et exécutez-le à côté des vérifications PATH à partir duProcédure pas à pas SSH sans tête: prouvez ce qu'il y a à l'intérieur de l'archive tar, puis prouvez ce que la cible a lu.

Enregistrershasum -a 256sur la source et joignez-le à l'enregistrement de modification pour détecter les transferts SCP tronqués. Déplacez les archives sur des canaux cryptés approuvés (bastion rsync) plutôt que sur des compartiments d'objets publics de longue durée contenant les informations d'identification de l'API. Lorsque l'espace de travail dépasse quelques gigaoctets (actifs de compétences importants ou journaux de mémoire), dimensionnez l'espace de travail.niveau SSD cibleavant le transfert ; qui est directement lié à l’arbre de décision M4 Pro ci-dessous.

Remplacez les versions par votre version openclaw gelée et attachez l'archive tarshasum -a 256à l'enregistrement des modifications. Confirmerversions majeures du nœud correspondantsur la source et la cible ; sinon, installez d'abord sur la cible, puis décompressez l'espace de travail, en évitant les demi-états « nouveau binaire, ancienne mémoire ». Si la CLI n'est pas installée sur l'hôte cloud, terminezinstallation officielleavant de déballer, n’inversez pas l’ordre.

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'

Ne pasgateway startimmédiatement après l'extraction : exécuteropenclaw doctor, enregistrez la sortie standard complète dans l'enregistrement des modifications et comparezMEMORY.mdhorodatages avec la source. Lorsque le médecin suggère une migration du chemin de l'espace de travail,fusionner plutôt que d'écrasersauf si l'enregistrement accepte explicitement la mémoire vide. Exécutez install-daemon uniquement après le passage du médecin afin que les chemins plist ne pointent pas vers des répertoires vides en cours de fusion.

Une fois les six étapes terminées, le ticket doit indiquer quel levier a été déplacé : contenu de l'archive tar, chemin de l'espace de travail, résultat du médecin ou niveau. Même les déplacements de régions KVMNODE uniquement devraient archiver une archive tar dans le stockage des artefacts :les changements de région modifient souvent la politique d'IP et de sortie; la restauration a besoin de mémoire et de configuration, pas d'une passerelle vierge. Pendant la semaine d'acceptation, instantanéopenclaw doctorquotidiennement et mapper les champs à L1/L2 sur leéchelle de diagnostic.

La croissance de l’espace de travail touche souvent le disque avant le processeur : de nombreuxmemory/*.mdles fichiers, les dépôts de compétences et les téléchargements parallèles stressentIOPS disque et cache de pages de mémoire unifiée. Si l'archive Xcode ou Flutter s'exécute sur le même hôte dédié après la migration, suivezutilisation de la racine après le déballage, état de santé de la passerelle P95 et pression de la mémoire lors des constructions parallèlespendant la semaine d'acceptation.

Un Mac personnel comme seule source de sauvegarde donnefenêtres de sauvegarde imprévisiblesavec sommeil fermé par le couvercle et sans acceptation contractile 7 × 24 ; cron sur les ordinateurs portables s'interrompt sur les commutateurs utilisateur et les invites d'autorisation. Les ordinateurs portables qui nécessitent beaucoup de sommeil sont de mauvais hôtes pour les écritures de journaux de mémoire en cours après la migration. Pour les équipes qui ont besoin d'hôtes dédiés auditables, flexibles en fonction des régions et évolutifs pour la mémoire OpenClaw plus Gateway,La location cloud KVMNODE Mac Mini est généralement la meilleure solution: Apple Silicon dédié, six régions, des conditions au jour le mois et la même langue de placement pour « pack—unpack-doctor » et CI. Commande viapage de commande, les runbooks dans leCentre d'aide, SKU surprix.