Runbook minimal pour standardiser openclaw@2026.5.x sur Apple Silicon hébergé, imposer la barrière Node 24 de la doc 2026.5.x et figer des points de repli reproductibles pour vos équipes.

Un chemin (curl … install.sh ou npm global), onboard et daemon si besoin, puis gateway status, doctor et config validate avant merge. Les équipes qui pré-tirent npm, CocoaPods ou couches conteneur traitent ainsi la passerelle comme un service critique au même titre qu’un miroir de registre. Jetons : passerelle et OPENCLAW_GATEWAY_TOKEN ; porte validate : config validate CI.

Pourquoi la stabilité passerelle compte pour les clients MacPull

Chez MacPull, git pull fréquents, miroirs et CI qui pré-tirent dépendances multiplient le bruit si la passerelle flappe : on perd la preuve « vert avant merge » entre SSH, launchd et le pipeline, ce qui retarde chaque prévol coûteux.

Verrou 2026.5.x + Node 24 et script unique validate + doctor traitent la passerelle comme dépendance stable pour le pré-tirage, ce qui aligne sprints agressifs et drills de restauration sans multiplier les astreintes nocturnes ; voir statut JSON et doctor CI et compétences et rollback doctor.

Barrière Node 24 alignée sur la documentation OpenClaw 2026.5.x

La doc 2026.5.x centre Node 24. Première ligne utile : node -v dans le shell et sous launchd — sinon « terminal vert, daemon rouge ».

Isoler OPENCLAW_HOME / OPENCLAW_CONFIG_HOME, chmod 700, PATH plist ou binaire absolu : checklist install et doctor.

Installation : curl install.sh ou npm global, jamais les deux à la fois

Une voie par image : cumuler curl puis npm install -g sans désinstaller donne deux openclaw en compétition PATH.

VoieQuand la choisirDiscipline de figement
curl … install.sh officiel Mac neufs où vous recopiez mot pour mot le quickstart amont. Après coup, exécutez openclaw --version ; toute ligne hors 2026.5.x doit ouvrir un incident de conformité semver.
npm install -g "openclaw@^2026.5.0" Flottes déjà gouvernées par miroirs npm, approbations semver et empreintes de binaire. Journalisez command -v openclaw et hachez le chemin dans l’artefact CI pour prouver quel fichier a servi.

Copier le curl depuis la doc amont ; invariant : openclaw --version en 2026.5.x avant openclaw.json.

Onboard et daemon (onboard, --install-daemon)

openclaw onboard pour le compte de service (onboard non interactif CI), puis onboard --install-daemon sur Mac longue durée ; éviter le daemon sur runners PR (18789).

Reboot test : gateway status, doctor, sonde ; divergence OPENCLAW_CONFIG_HOME SSH/plist = « vert main, rouge auto ».

gateway status, doctor et la notion de « vert »

gateway status (--json possible) annonce l’état ; doctor contrôle fichiers et env. Chaîne && + artefact CI : portes status JSON.

#!/usr/bin/env bash set -euo pipefail node -v command -v openclaw openclaw --version openclaw gateway status openclaw doctor

Config validate : lire le JSON comme une carte

openclaw config validate sur "${OPENCLAW_CONFIG_HOME}/openclaw.json" ; drapeaux JSON selon mineure (--help sur votre pin). Trois lectures :

  1. Exit / ok — CI échoue si non zéro.
  2. Chemins OK — repères pour diffs.
  3. issues — pointeurs JSON vers openclaw.json ; pas de devinettes stderr ; porte validate.
openclaw doctor && \ openclaw config validate --config "${OPENCLAW_CONFIG_HOME}/openclaw.json"

Joindre stdout/stderr et openclaw.json redacted à la MR.

Points de repli : archives datées et relecture checksum

Avant toute modification d’auditeurs, de fournisseurs ou d’auth, créez une archive depuis le répertoire de configuration du service ; notez l’empreinte pour prouver l’intégrité lors d’un audit post-incident :

CK="openclaw-checkpoint-$(date -u +%Y%m%dT%H%M%SZ)-${HOSTNAME:-mac}" tar -czf "${CK}.tgz" -C "${OPENCLAW_CONFIG_HOME}" openclaw.json shasum -a 256 "${CK}.tgz" | tee "${CK}.tgz.sha256"

Staging trimestriel : unload, restore tarball, downgrade npm si semver montée, reload, puis status + doctor + validate + sonde ; viser quelques minutes.

Colonne vertébrale copier-coller pour un Mac distant longue durée

  1. Prouver Node 24 puis exporter OPENCLAW_HOME et OPENCLAW_CONFIG_HOME.
  2. Installer soit le curl … install.sh amont, soit npm install -g "openclaw@^2026.5.0" ; imprimer openclaw --version.
  3. Archiver openclaw.json en .tgz avec empreinte SHA-256.
  4. Exécuter openclaw onboard puis openclaw onboard --install-daemon lorsque l’hôte doit survivre aux reboots.
  5. Enchaîner openclaw gateway status, openclaw doctor, openclaw config validate --config … puis la sonde applicative authentifiée.

FAQ

Node 24 obligatoire si Node 22 marchait ?

Pour 2026.5.x, ciblez Node 24 documenté ; retard = écarts moteur sous charge.

Curl ou npm ?

Deux voies amont ; une seule par hôte, selon politique interne.

CI sans doctor ?

OK en porte merge ; sur hôtes passerelle, garder doctor (permissions, PATH).

Jetons ?

Guide jeton ; pas de secrets ici.

Synthèse et pages publiques

Colonne 2026.5.x : Node 24, install unique, onboard/daemon si besoin, status + doctor + validate, tarball + checksum pour tirages MacPull denses.

Accueil, tarifs, achat, aide, blog public — sans URL login obligatoire.

KPI : minutes merge semver → doctor+validate verts ; drill repli trimestriel.

Mac distant pour des passerelles OpenClaw stables

Tarifs publics, achat en ligne et documentation d’aide — répétez images Node 24 et drills de repli sur Apple Silicon réel.

Accueil Tarifs Acheter Aide Blog