OpenClaw v2026.5.2 sur Mac distant :
Node 24, onboard, 18789 et matrice régions / SSD
Ce guide couvre le démarrage à froid d'OpenClaw v2026.5.2 sur macOS hébergé : installation de Node 24 par deux chemins complémentaires, enregistrement onboard sous launchd, puis validation du port 18789. Nous terminons par une matrice de décision US Est / Asie-Pacifique et l'extension disque SSD « raisonnable », avec une FAQ de dépannage. Pour le contexte launchd, tunnels et double passerelle, voir aussi OpenClaw Gateway : launchd, SSH, VPN et 18789.
L'objectif est simple : éviter les demi-versions de Node, les services qui meurent au logout SSH, et les faux positifs sur le health check lorsque seul le chemin réseau change.
Node 24 : deux voies, une seule vérité (node -v)
Voie A — installateur officiel : installez le paquet macOS pour Node 24 depuis le site Node.js, puis rouvrez le terminal. Cette voie minimise les surprises sur les machines managées : binaire unique, chemins prévisibles, idéal pour reproduire un incident en support.
Voie B — fnm ou Homebrew : sur un poste de développeur pur, fnm install 24 ou brew install node@24 permet de basculer rapidement entre versions. Attention : si launchd lance OpenClaw sans charger votre shell interactif, exportez explicitement PATH dans le plist ou appelez le binaire Node par chemin absolu — sinon le service « voit » encore une vieille 18.x.
Après installation, vérifiez which node, node -v et, si vous utilisez un gestionnaire de paquets global, que npm prefix -g pointe vers un répertoire accessible au compte qui exécute la passerelle.
Onboard, launchd et persistance
La commande onboard (selon votre distribution OpenClaw) enregistre l'identité de la machine, les jetons et parfois les chemins de log. Exécutez-la une fois sous le même utilisateur que celui qui possèdera le service : mélanger root et un compte staff crée des plist incohérents.
Chargez ensuite un LaunchAgent ou LaunchDaemon qui appelle le binaire OpenClaw avec les bons arguments, redémarre sur sortie non nulle et journalise dans ~/Library/Logs ou /var/log. Testez d'abord en foreground (openclaw gateway … ou équivalent), puis seulement passez à launchd : ainsi les erreurs TLS, clés ou répertoire de travail apparaissent clairement.
Pour la vue d'ensemble agents / passerelles sur Mac loué, la série introductive reste utile : OpenClaw : passerelle d'agent IA sur Mac distant (2026).
Port 18789 : health check et pièges fréquents
Le port 18789 sert en général d'endpoint HTTP interne pour la sonde « up ». En local, curl -fsS http://127.0.0.1:18789/health (ou le chemin documenté dans votre build) doit répondre 200. Si la commande échoue alors que le processus tourne, inspectez : interface d'écoute (127.0.0.1 vs 0.0.0.0), pare-feu macOS, reverse SSH ou VPN qui ne forward pas ce port.
FAQ express
- ◆502 derrière le tunnel : le tunnel pointe vers une mauvaise IP locale ou un health path obsolète après mise à jour v2026.5.2.
- ◆Service « up » mais clients déconnectés : horloge désynchronisée (NTP), certificat expiré ou jeton onboard régénéré sans redémarrage launchd.
- ◆Port déjà utilisé : ancienne instance non arrêtée ;
lsof -iTCP:18789 -sTCP:LISTENpour identifier le PID.
Matrice US Est / APAC et SSD « prix raisonnable »
Choisissez la région par RTT mesuré vers vos développeurs et vos API (GitHub, AWS, App Store Connect). US Est excelle lorsque la majorité du trafic va vers la côte est des clouds publics ; Singapour, Tokyo ou Hong Kong gagnent lorsque vos équipes et pipelines sont APAC-first.
| Critère | US Est | APAC | Note |
|---|---|---|---|
| RTT vers GitHub / cloud US | ◆ Très bas | Variable | Mesurez mtr depuis le Mac |
| TestFlight / App Store APAC | Correct | ◆ Souvent meilleur | Alignez région Mac et équipes review |
| Capacité SSD | Montez un palier disque si caches Xcode, Docker et logs OpenClaw cohabitent | Mieux vaut trop d’espace que des GC d’urgence | |
L'extension SSD « entrée de gamme » est rentable lorsque vous stockez surtout des artefacts et des journaux : anticipez la marge pour les mises à jour macOS et les instantanés Time Machine si activés.
Sur Mac mini et macOS, tout ce flux tient naturellement
Une passerelle OpenClaw est un service longue durée : Apple Silicon sur Mac mini M4 offre une marge CPU confortable pour Node 24 et les tâches d'agent, avec une consommation veille d'environ quelques watts et un fonctionnement quasi silencieux adapté aux racks bureautiques. macOS apporte Unix natif, launchd mature, Gatekeeper, SIP et FileVault pour réduire la surface d'attaque par rapport à beaucoup d'hôtes généralistes — utile lorsque 18789 doit rester accessible derrière un tunnel maison.
L'écosystème développeur (Homebrew, outils Apple, SSH intégré) évite les couches d'émulation superflues. Si vous voulez exécuter ce tutoriel sur le matériel le plus simple et efficace, le Mac mini M4 reste l'un des meilleurs points d'entrée : performances solides, TCO maîtrisé, et stabilité pour un service toujours actif.
Obtenir maintenant un Mac mini M4 permet de valider OpenClaw sur le même socle que nos guides — puis d'industrialiser la même configuration sur un Mac nuzcloud lorsque vous montez en charge.
Alignez Node 24 sur le compte launchd, figez onboard, vérifiez 18789 en local avant d'ouvrir le tunnel, puis choisissez US Est ou APAC au RTT réel. Documentez la version OpenClaw et le chemin Node dans votre runbook interne pour accélérer le prochain cold start.