OpenClaw 2026 Mac cloud : mise à jour — précontrôle disque, jobs launchd résiduels et checklist update restart health

Contrairement à la première installation onboard ou au dépannage launchd Token, ce texte couvre le chemin « Gateway déjà en production, upgrade rolling nécessaire » : vous vous connectez en SSH au Mac loué, lancez openclaw update, attendez le retour en prod — et tombez dans une boucle launchd.

Cinq points de friction sont souvent sous-estimés en post-mortem :

• plugin-runtime-deps ENOSPC : les versions 2026.4.24 et proches décompressent des deps bundled dans ~/.openclaw/plugin-runtime-deps ; manque d'espace = échec mid-operation, Gateway semble ready mais unhealthy (openclaw#71835).
• jobs stale ai.openclaw.update.* : après upgrade beta, launchd garde des updater jobs qui relancent Gateway en exit 127 ; gateway status --deep échoue (openclaw#81859).
• false-ready version mixte : CLI à jour, processus Gateway ancien — ou échec chargement plugins sans bloquer le « succès » ; clients distants en Health Check pending.
• chemins Node multiples : depuis 2026.5.20, openclaw update privilégie le Node du service Gateway ; cohabitation Homebrew et fnm peut basculer restart sur le mauvais binaire.
• pression bail et fenêtre : instance jour/semaine : ENOSPC mid-upgrade laisse peu de temps pour extension ou second nœud — prévoir marge dans la matrice de bail.

Règle mnémotechnique : « df d'abord, puis update, deep status, doctor nettoie les jobs, health 200 pour clôturer ». Sans précontrôle disque ou nettoyage jobs, dix minutes d'upgrade deviennent des heures de rework.

Avant d'appuyer sur openclaw update, alignez stockage, calcul et fenêtre temporelle avec le tableau — évitez d'étendre en plein upgrade depuis la console.

Si vous exploitez aussi le canal WeChat ClawBot, suspendez les nouveaux bindings QR pendant la fenêtre ; après restart health Gateway validé, openclaw gateway restart et reconnexion canal.

Avant upgrade, script non interactif pour affirmer disque et répertoire staging — pas de page à minuit.

df -h / | awk 'NR==2{print "avail="$4,"use="$5}'
du -sh ~/.openclaw/plugin-runtime-deps 2>/dev/null || echo "no staging yet"
launchctl list | grep -E 'openclaw\.(gateway|update)'
openclaw --version
openclaw gateway status --json | head -c 400

• Référence : chemin plugin-runtime-deps — par défaut ~/.openclaw/plugin-runtime-deps, ou OPENCLAW_PLUGIN_STAGE_DIR vers volume dédié ; réserver ≥ 8–15 Go libres par gros upgrade (selon nombre de plugins).
• Référence : log ENOSPC typique — failed to install bundled runtime deps: Error: ENOSPC: no space left on device ; ne pas relancer update en boucle : étendre ou rm -rf staging incomplet puis réessayer.
• Référence : seuil alerte racine — prod : usage racine < 80 % à long terme ; au-delà de 85 %, taux d'échec upgrade OpenClaw et cache Xcode augmente fortement.

1. Snapshot config et token : cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d) ; noter openclaw --version et JSON gateway status --deep.
2. Exécuter précontrôle : racine libre ≥ 15 Go ; pas de staging anormalement gros ; lister jobs openclaw dans launchd.
3. Update en creux : openclaw update (ou npm update -g openclaw / brew upgrade openclaw, cohérent avec le chemin d'installation) ; observer la section restart health dans la sortie CLI.
4. Probe deep status : openclaw gateway status --deep ; Connectivity probe ok ; si stale updater job, nettoyer section suivante puis kickstart.
5. doctor et health HTTP : openclaw doctor ; curl -sf -H "Authorization: Bearer token $(openclaw config get gateway.auth.token)" http://127.0.0.1:18789/health renvoie 200.
6. Baseline version : inscrire versions CLI et hello Gateway ; sur page tarifs évaluer besoin 1 To long terme ; reprendre test appairage clients distants.

openclaw update
openclaw gateway status --deep
openclaw doctor
curl -sf http://127.0.0.1:18789/health
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

Depuis 2026.5.20, openclaw update tente restart health même avec un skew protocole d'une version CLI/Gateway et privilégie le Node du service Gateway — moins de « update OK mais Gateway sur mauvais Node ».

Si gateway status --deep signale connectivity failed et launchctl list montre ai.openclaw.update.* à RunCount élevé, nettoyer d'abord stale updater job selon diagnostic officiel, puis réparer LaunchAgent.

En version mixte, ne pas se fier au seul « ready » CLI : restart health et chargement plugins font foi. Si plusieurs gateway restart échouent, fenêtre maintenance : openclaw gateway install --force puis openclaw doctor.

Lier les upgrades OpenClaw à un Mac domestique ou portable qui dort souvent cumule risques OS et fragmentation dans la fenêtre. Sur VPS sursouscrits ou non-macOS, pas de canaux Apple ni chemin launchd natif. Pour les équipes qui veulent updates reproductibles, extension disque instantanée, calcul bare-metal dédié, suivre les six étapes sur Mac cloud multi-région JEXCLOUD avec marge 1 To/2 To ou M4 Pro parallèle avant ENOSPC est souvent plus serein : livraison ~120 s, bail élastique par projet. Offres sur la page tarifs JEXCLOUD.