Faire tourner OpenClaw Gateway sur un Mac bare metal distant en 2026 ne casse presque jamais sur l'installation. Trois écueils se conjuguent : une région trop éloignée des utilisateurs, un palier de mémoire choisi un cran en dessous, et un launchd qui refuse de lancer la passerelle. Ce guide donne une matrice régionale, un tableau de décision M4 / M4 Pro, six étapes pour les tunnels SSH et un mémo des erreurs Gateway Token les plus fréquentes. Tarifs et nœuds sur la page tarifs CALMVPS.
À la fin, vous pourrez répondre à trois questions. Premièrement, où vivent vos utilisateurs et quelle région stabilise les sockets longue durée. Deuxièmement, faut-il 16 Go, 24 Go ou un M4 Pro pour un agent unique, une production multi-agents ou un hub Gateway+Worker. Troisièmement, lorsque launchd renvoie token_missing_config ou device_token_mismatch, quelle commande lire en premier.
01 Profil CPU / RAM / disque réel d'OpenClaw 2026
La branche v2026.5.x redéfinit les caches de session entre Gateway et Channel, les snapshots de Skills et le planificateur Cron. L'erreur courante consiste à lire les pages marketing et à conclure « deux ou trois agents tiendront sur le plus petit M4 ». En production, les contextes longs, la concurrence multi-canaux, le préchauffage des modèles et les journaux structurés s'empilent simultanément.
Cinq points souvent sous-estimés à anticiper avant de commander la machine plutôt qu'après le premier incident.
- Plancher de mémoire résidente. Le Gateway et un seul agent au repos occupent déjà 1,5 à 2,5 Go. Monter Discord, Telegram et iMessage ajoute 600 Mo ou plus.
- Pics de CPU. Les opérations
/new,sessions.resetet la reconstruction des Skills introduites en 2026.5 produisent des pics courts. Sur 16 Go, un reset synchrone sur plusieurs agents bascule facilement vers le swap. - Amplification d'écriture. Journaux, historique Cron et persistance d'Active Memory sont des petites écritures aléatoires. Réservez au moins 80 Go au répertoire OpenClaw lorsque la mémoire globale est active.
- Stabilité de sortie. Les WebSockets vers les fournisseurs et les canaux sont longs. Le jitter d'un accès résidentiel se traduit en déconnexions de canaux plus souvent qu'on ne le pense.
- Comportement système. Même en bare metal,
pmset, les mises à jour automatiques et l'indexation Spotlight restent actifs par défaut. Aucun n'est compatible avec un agent 24×7.
Une règle simple bat un long débat. Plancher résident multiplié par 1,5, plus pic unique multiplié par 1,2, donne le palier de mémoire unifiée à acheter. Inscrivez-le dans la revue de capacité et arrêtez d'estimer à vue.
02 Choisir une région : matrice HK / JP / KR / SG / US
La plupart des équipes optimisent la mauvaise distance. Les fournisseurs de modèles exploitent des points anycast mondiaux. Les utilisateurs finaux et les webhooks de canaux, eux, sont localisés. Placez le Gateway près des utilisateurs, pas près des modèles. La matrice ci-dessous relie les régions CALMVPS aux charges typiques.
| Région | Profil utilisateur | Charges typiques | Notes |
|---|---|---|---|
| Hong Kong (HK) | Grande Chine, nord de l'ASE | Bots sinophones, e-commerce transfrontalier | Sortie stable vers fournisseurs étrangers |
| Japon (JP) | Japon, Asie de l'Est | iMessage, ponts LINE, support en japonais | RTT bas vers les principaux fournisseurs |
| Corée (KR) | Marché coréen | Pont KakaoTalk, NLP coréen | Latence locale très favorable |
| Singapour (SG) | ASE et Inde | Routage multilingue, fuseaux horaires | Bonne couverture Inde et Australie |
| US Est / Ouest | Amériques, développeurs globaux | Webhooks GitHub, bots Discord, CI | RTT le plus court vers la majorité des API |
Le motif Hub-and-Spoke qui fonctionne réellement en 2026 reste simple. Le Gateway s'installe là où la densité d'utilisateurs est la plus forte. Les Workers se répartissent vers les régions secondaires. La control plane se replie sur l'opérateur via tunnels SSH. Les sockets longues restent ainsi confinées au saut le plus court, et chaque sortie modèle ou canal trouve son nœud optimal.
03 Matrice de décision M4 16 Go / 24 Go / M4 Pro
Sur la mémoire unifiée, la doctrine « économiser un palier » détruit les budgets. La consommation OpenClaw n'est pas linéaire. Les canaux, les Skills, l'Active Memory et les sessions concurrentes forment des marches, pas une pente. Le tableau aide ingénierie et finance à conclure en une seule réunion.
| Dimension | M4 16 Go | M4 24 Go | M4 Pro |
|---|---|---|---|
| Charge cible | Agent unique, démos | 2 à 4 agents en production | Gateway et plusieurs Workers |
| Canaux | Un canal au plus | Deux à trois stables | Trois et plus, avec Cron et mémoire |
| Contextes longs | Risque de swap | Confortable au quotidien | Sessions multi-agents stables |
| Repli modèle | Niveaux A et B | Ajout d'un Ollama local C | Local et distant en parallèle |
| Durée recommandée | Journalière ou hebdomadaire | Production mensuelle | Trimestrielle pour le hub |
Le résumé tient en une ligne. Un Gateway part au minimum sur 24 Go. Un Worker peut rester en 16 Go. Le hub central appartient au M4 Pro. Lorsque les sessions longues et un repli local sont exigés, sauter directement de 16 Go à M4 Pro coûte généralement moins cher que « commencer petit, monter ensuite ».
04 Tunnel SSH et plan de ports multi-instances
N'attachez jamais le Gateway OpenClaw à un port public. Liez-le à 127.0.0.1 sur chaque nœud et tunnellisez l'accès. Le Gateway Token devient un second facteur, et non l'unique défense. Les six étapes ci-dessous se copient sans risque.
- Plan de ports locaux. Fixez un port local par nœud distant : 18800 pour HK Hub, 18801 pour JP Worker, 18802 pour US Worker. Plus de doute possible côté opérateur.
- Un tunnel par hôte. Lancez
ssh -N -L 18800:127.0.0.1:18789 user@hk.node. Un tunnel par machine garde l'arrêt précis. - tmux pour la persistance. Regroupez les commandes dans une session tmux. La mise en veille du poste opérateur ne doit pas effondrer toute la control plane.
- Tokens en coffre. Lisez le token depuis
~/.openclaw/configet stockez-le dans le gestionnaire de mots de passe. Jamais dans l'historique du shell. - CLI à distance. Utilisez
openclaw cron list --url ws://localhost:18800 --token <token>etopenclaw channels listpour inspecter ou déclencher des tâches. - Sonde régulière. Curl toutes les trente secondes sur
http://localhost:188xx/healthz. Sur trois échecs consécutifs, alertez et exécutezlaunchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway.
#!/bin/sh
ssh -N -L 18800:127.0.0.1:18789 user@hk.node &
ssh -N -L 18801:127.0.0.1:18789 user@jp.node &
ssh -N -L 18802:127.0.0.1:18789 user@us.node &
openclaw cron list --url ws://localhost:18800 --token "$HK_TOKEN"
# Ports figés : la classe d'erreurs « mauvaise instance » disparaît
Centralisez ports, alias et tokens dans un .env protégé par chmod 600. La famille d'incidents « j'ai tapé 18801 et lancé un cron sur le hub de production » disparaît dès cette discipline.
05 Triage launchd et Gateway Token
OpenClaw réside sur macOS sous forme de LaunchAgent. Les incidents 2026 se concentrent dans quatre familles. Variables d'environnement non héritées du shell. Cycle de vie cassé par bootout. Token figé dans la plist alors que le fichier de configuration a changé. Répertoire de logs absent. Le tableau ramène le triage de trente minutes à trois.
| Mot-clé | Cause racine | Première action |
|---|---|---|
| token_missing_config_loop | launchd n'hérite pas des exports zshrc | launchctl setenv OPENCLAW_GATEWAY_TOKEN ... puis kickstart -k |
| device_token_mismatch | Ancien token gravé dans la plist | Mettre à niveau ou exécuter install --force |
| Gateway service not installed | gateway stop a déclenché bootout |
Privilégier openclaw gateway restart ou install --force |
| launchctl bootstrap I/O error | ~/.openclaw/logs/ absent |
mkdir -p ~/.openclaw/logs puis recharger |
- Trois commandes en premier.
openclaw gateway status,openclaw doctoretlaunchctl list | grep openclawavant toute hypothèse. - Rotation des tokens. Tous les trente jours, mise à jour synchrone via un script unique : plist, configuration de l'hôte, coffre opérateur. La dérive manuelle alimente la majorité des mismatches.
- Logs sur disque. Renseignez
StandardOutPathetStandardErrorPathdans la plist. Sans ces chemins, le processus géré par launchd devient une boîte noire.
06 Stockage 1 To/2 To et checklist de location mensuelle
Le stockage et la durée de location sont les deux variables que la pensée « palier minimum » oublie le plus souvent. Les journaux, la mémoire et l'historique Cron d'OpenClaw sont compressibles mais non jetables. Un disque de 1 To paraît confortable au mois 1 et devient inconfortable au mois 6. La liste qui suit est une checklist d'une page.
- Périmètre 1 To. Un Gateway avec un ou deux canaux, sans Active Memory globale, rotation hebdomadaire. Suffisant pour la validation.
- Périmètre 2 To. Gateway et plusieurs Workers, Active Memory et Cron actifs, conservation mensuelle des journaux structurés. Bon choix pour une production de moyen terme.
- Nœuds éphémères. Backfills, runs de fine-tuning, audits ponctuels coûtent moins cher en location à la journée sur un nœud parallèle qu'en upgrade du hub. À libérer après le job.
- Durée et remise. Hub mensuel ou trimestriel pour figer la capacité. Nœuds journaliers ou hebdomadaires pour absorber l'élasticité. Le coût composite bat une machine maximale unique.
- Achat multi-régions. HK, JP et US ensemble s'avère plus stable qu'un seul point haut de gamme et reste rarement plus cher sur la facture mensuelle.
L'auto-hébergement échoue typiquement sur trois fronts : le jitter résidentiel, la concurrence du voisinage et des frontières launchd floues. Les plateformes de virtualisation mutualisée renversent le problème car la sursouscription transforme chaque pic en déconnexion fantôme. Pour les équipes qui exigent un Gateway stable, des Workers transrégionaux et une rotation propre des tokens, CALMVPS Mac bare metal multi-régions avec M4 Pro reste la voie la plus directe pour aligner région, dimensionnement et triage du même coup. Apple Silicon dédié, fonctionnement 24×7, élasticité mensuelle et provisionnement en 120 secondes permettent d'absorber les pics par des nœuds parallèles plutôt qu'en montant le hub. Nœuds, paliers et conditions actuels sur la page tarifs.