npm install -g figé, openclaw onboard --install-daemon pour launchd, openclaw gateway status, puis openclaw dashboard pour compétences, streaming et rollback, alignés sur v2026.3.24. Ce guide fusionne openclaw doctor avec vos sondes pour un verdict unique. En prolongation : Model Auth et journaux d’outils, embeddings & RAG, index du blog — le tout « lecture publique », sans compte.
Pourquoi une passerelle « presque stable » reste fragile sans runbook
Trois écarts classiques : compétences installées depuis un SSH utilisateur différent du daemon launchd ; binaire openclaw plus récent que la config v2026.3.24 ; streaming OK en local mais bloqué par un proxy qui bufferise. Une boucle courte gateway status + doctor + chat test suffit à révéler la dérive.
Matrice décisionnelle : CLI, tableau de bord et fusion doctor
Selon la doc, --install-daemon démarre d’abord la passerelle gérée ; sans lui, l’onboarding attend une instance locale ou impose --skip-health pour l’écriture pure de configuration — point critique sur un Mac distant.
| Sujet | Priorité CLI | Tableau de bord | Fusion avec doctor |
|---|---|---|---|
| Installation OpenClaw | npm install -g openclaw@<semver figé> après contrôle node -v |
Sert à valider l’UI ; ne remplace pas l’épinglage npm partagé par l’équipe | Lancer openclaw doctor juste après pour détecter PATH, migrations et clés orphelines |
| Service persistant | openclaw onboard --install-daemon enregistre l’agent macOS utilisateur |
Contrôlez, lorsque l’UI l’expose, que le bon profil charge jetons et SecretRef | Corrélez les avertissements doctor sur launchctl getenv avec les sorties status |
| Compétences + streaming | Synchronisation de secours via CLI si l’UI est saturée | Catalogue, activation, ordre, interrupteur streaming pour réponses incrémentielles | Doctor signale sandbox Docker manquant ou politiques ouvertes avant de blâmer l’UI |
| Rollback | Réinstallez le tag npm précédent puis recyclez le daemon | Désactivez la version fautive des compétences et revenez au bundle stable | Ne lancez doctor --repair qu’après snapshot : l’outil réécrit la config et crée un .bak |
Procédure reproductible (copier dans l’ordre)
Node 20+ (22 LTS recommandé), canary npm install -g openclaw, puis épinglez openclaw@x.y.z identique partout pour v2026.3.24.
node -v npm install -g openclaw@latest # remplacez par le semver validé openclaw --version
openclaw onboard --install-daemon enchaîne auth, jeton passerelle, canaux optionnels et launchd — ce qui distingue un service durable d’une session tmux.
openclaw gateway status doit correspondre au plist ; ajoutez --json / --deep si votre runbook le prescrit.
openclaw gateway status # variante observabilité : # openclaw gateway status --json
openclaw dashboard ouvre le Control UI (souvent 127.0.0.1:18789, tunnel SSH si besoin) : catalogue de compétences, activation, streaming. Validez par un prompt court qui exerce un outil à travers le proxy.
Snapshot ~/.openclaw/, dossiers de compétences, npm ls -g --depth=0 ; en panne, réinstallez le tag npm précédent, recyclez launchd, désactivez la compétence fautive dans l’UI.
openclaw doctor audite passerelle et migrations ; openclaw doctor --repair (alias --fix) écrit openclaw.json.bak. Enchaînez lecture seule + gateway status dans LaunchAgent pour un seul signal supervision.
#!/bin/sh set -euo pipefail openclaw doctor openclaw gateway status # openclaw doctor --repair # fenêtre contrôlée uniquement
Repères « copier-coller » pour tickets d’exploitation
- Contrat Node + semver : consignez la paire
node -v+ version npm installée sur chaque hôte aligné v2026.3.24. - Contrat loopback : notez l’URL exacte du Control UI, le schéma (
httplocal vs tunnel TLS) et l’utilisateur launchd propriétaire. - Contrat streaming : documentez la désactivation du buffering proxy, les timeouts lecture et la présence d’appels d’outils longs nécessitant des heartbeats.
FAQ des erreurs fréquentes
command not found: openclaw après npm install -g
Le répertoire global des binaires npm n’est pas dans le PATH des shells non interactifs. Affichez npm prefix -g, exportez le chemin dans le plist launchd ou créez un lien symbolique vers /usr/local/bin.
Vérifiez que --install-daemon a bien été passé et que le job launchd correspond à l’utilisateur prévu. Les sessions GUI temporaires ne remplacent pas un agent utilisateur persistant sur un Mac loué.
gateway status vert pourtant les compétences restent hors ligne
Les chemins HOME ou variables OPENCLAW_* diffèrent entre votre SSH et le daemon. Harmonisez-les, puis relancez openclaw doctor pour confirmer que les migrations touchent le même répertoire d’état.
Alignez les timeouts, désactivez la mise en buffer intermédiaire et testez avec curl -N sur l’URL proxifiée en répliquant les en-têtes du navigateur.
Valeur stable : louer un Mac distant pour OpenClaw
Un Mac Mini M4 dédié offre NVMe prévisible, voisins calmes et un cadre où launchd, caches de compétences et boucles doctor + status tournent en continu. Lorsque votre semver npm, votre tableau de bord et votre automation décrivent la même réalité, les montées de version cessent d’être une loterie.
Pour passer en production, parcourez les tarifs, finalisez votre commande sur la page achat, consultez le centre d’aide pour les modes d’accès, puis revenez à l’index du blog ou à l’accueil MacPull — ces pages restent lisibles sans authentification.
Louer un Mac distant pour héberger OpenClaw
Épinglez v2026.3.24, gardez vos compétences au chaud et exécutez doctor + gateway status sur un Apple Silicon que vous contrôlez de bout en bout.