Unepasserelle OpenClaw résidentesur macOS bare metal n'est pas « Compose sur l'hôte et oublier la machine » : vous héritez delaunchd, de LaunchAgents souvent sans GUI, et de l'écart entre shell interactif et environnement démon. Cette FAQ suit unordre par couches— identité, parité d'env,TCP 18789, puis auth après upgrade — face à Docker où tout tient souvent à un seul fichier Compose. Elle se termine par unbasculement M4 multi-régionspour répéter une vraie coupure plutôt qu'improviser.
Bare metal et Docker : ce qui casse vraiment
AvecDocker Compose, vous épinglez des images, montez un fichier d'environnement unique et les health checks frappent en général la boucle locale du conteneur. SurmacOS nu, le binaire de la passerelle peut tourner sous un autre utilisateur que votre shell admin, hériter d'un PATH minimal ou démarrer avant que le réseau soit stable. Traitez « ça marche quand je me connecte en SSH et que je lance à la main » comme unéchec de garde-fou : reproduisez avec le même plist LaunchAgent ou la même commande d'onboarding que votre runbook. Pour l'épinglage d'images, les volumes et les sondes de passerelle en conteneur, croisez cette note avec notre OpenClaw Docker Compose en 2026 : déploiement et dépannage.
Les upgrades bare metal mélangent OS, Homebrew/npm et correctifs Apple — tout peut décaler chemins ou notarisation. Gardez en Git uninstantané pré-vol(plist, env, config passerelle expurgée) étiqueté par build macOS pour comparer mardi sain et mercredi en 401.
launchd : agents utilisateur, sessions et parité d'environnement
Souvent unLaunchAgentsous~/Library/LaunchAgents: pas de.zshrc, souvent pas de déverrouillage trousseau interactif. Mettez les variables dans le plist (EnvironmentVariables) ou un wrapper qui source un fichier versionné. Côté Linux relais, faites pareil avecsystemd --useretEnvironment=explicites.
Après édition :launchctl bootout/bootstraple label, puislaunchctl print. Testez déconnexion et reboot froid — Wi‑Fi/VPN peuvent gagner la course contre la passerelle.
Port 18789 et probes de santé locales
Exigez untest TCP sur 18789(ou le port documenté) depuis le même espace que les clients —nc -vz 127.0.0.1 18789en utilisateur démon, pas seulement root ;lsof -nP -iTCP:18789 -sTCP:LISTENpour les conflits. Derrière proxy ou mTLS, écrivez si la sonde doit frapper le bord ou le loopback.
Ouverture au-delà du loopback : pare-feu + décision écrite ; sinon tunnels SSH ou bordure adaptée au modèle de menace.
Après mise à niveau : « dérive d'auth » et jetons incohérents
Après upgrade, chemins par défaut et binaires changent : 401 ou refus clients malgré launchd « vert ». Alignez jetons disque et attentes de build (OPENCLAW_GATEWAY_TOKEN, etc.), évitez double source plist vs shell. Trousseau : refaire l'onboarding fournisseur si grosse mise à niveau macOS, puis restart agent. Pour installateur et acheter vs louer, voir
OpenClaw Gateway en 2026 : acheter un Mac ou louer des Mac cloud multi-régions ? — script officiel, déploiement npm, erreurs typiques et FAQ métier.
FAQ basculement : Mac mini M4 cloud multi-régions
Primaire + secours :même palier M4 (RAM/NVMe), par ex.Tokyo et Singapour, templates env dans Git ; sondes depuis les VPN bureaux, meilleure RTT = primaire pour la cohorte. Dimensionnement régional : Mac cloud 2026 : six régions vs Mac mini M4 — latence Singapour, Tokyo, Séoul, Hong Kong, US Ouest/Est ; 16 Go/256 Go vs 24 Go/512 Go ; extension 1 To/2 To ; ressources parallèles ; FAQ coûts location courte ou moyenne durée.
Bascule :TTL DNS bas ou hostname flottant ; n'arrêtez le LaunchAgent du nœud mort qu'après drainage — pas de split-brain sur la même identité bot. Exercice trimestriel « kill primaire », objectif par ex. < 10 min au vert.
Centralisez les logs du LaunchAgent ; corrélez reboots passerelle, Wi‑Fi et petites upgrades macOS. Files et rotation de sièges : FAQ équipes transfrontalières : rotation des sièges Mac cloud et files parallèles sur six régions. Réservez du NVMe pour logs/cache comme en CI pour la reprise sur secours.
Checklist exploitation d'une page
- Confirmez que le label LaunchAgent, l'utilisateur et le répertoire de travail correspondent au runbook ; test à froid après changement de plist.
- Différenciez l'environnement entre SSH interactif et plist (
printenvvs variables du démon journalisées). - Prouvez que
127.0.0.1:18789écoute en tant qu'utilisateur passerelle ; résolvez les conflits de port avant de toucher à la logique applicative. - Après chaque upgrade : vérifiez jetons, chemins de config et secrets trousseau ; rejouez une conversation client témoin.
- Documentez primaire régional, secours, TTL DNS et qui peut déclarer la bascule terminée.
Sur vpszap, les passerelles résidentes restent proches d'une prod réelle
Tout ce qui précède suppose unApple Silicon dédiéavec disque prévisible et sans bruit de voisinage. vpszap propose unMac mini M4 physique— sans virtualisation, tout le CPU, la RAM et le SSD pour votre instance — activé en environcinq minutesavecSSH et VNCensemble, facturé aujour, à la semaine, au mois ou au trimestresansengagement long, surplusieurs régions à faible latence. C'est le profil des équipes qui veulent la même histoire bare metal à Tokyo et sur la côte ouest des États-Unis sans posséder deux baies.
Si vous voulez cette checklist de passerelle sur du matériel aligné avec la façon dont vous faites tourner OpenClaw « pour de vrai », le Mac mini cloud vpszap est le point de départ le plus direct.
