OPENCLAW 2026
POST_INSTALL_
GATEWAY_
PATH_FORCE.

Après npm install -g openclaw, l’absence d’erreur visible n’empêche pas openclaw ask de se bloquer ni openclaw-gateway: command not found d’apparaître : le problème est souvent préfixe/PATH, enregistrement Gateway omis, collision Node 22, ou launchd sans profils interactifs. Ce guide propose matrice symptômes-preuves, cinq étapes de démarrage à froid, seuils chiffrés et FAQ, avec renvois vers install.sh production, LaunchAgent et jeton, Chrome Relay 18792, v2026.5.x couches. Pour un plan de contrôle propre, répliquez les étapes sur un Mac distant MACGPU.

1. Points de friction

Bin global hors PATH, installation Gateway sautée, plusieurs Node, launchd minimal. Ne commencez pas par le throttling API. Les journaux d’install « verts » n’impliquent pas une boucle runtime fermée ; des jobs npm globaux parallèles sur comptes partagés font fluctuer which. Des journaux sur volumes en lecture seule ou montages réseau provoquent des boucles de crash malgré des messages de succès.

2. Matrice

Signal	Soupçon	Preuve
command not found	PATH	which openclaw, npm prefix -g
status non installé	enregistrement	avant/après gateway install --force
interactif OK, launchd KO	plist	EnvironmentVariables
uniquement distant	shell non-login	ssh -t, $HOME

3. Cinq étapes

Step 1 Triplet figé

node -v (22+), chemin absolu which node.

Step 2 Préfixe/PATH

npm config get prefix, RC shell, éviter sudo npm.

Step 3 Enregistrer la passerelle

openclaw gateway install, sinon --force, aligner les variables LaunchAgent avec l’article jeton.

Step 4 Ports

Séparer loopback et tunnel SSH ; sonde 18792 du guide Chrome Relay.

Step 5 Redémarrage à froid + journaux

Arrêt complet, relance, découper openclaw logs par fenêtres temporelles.

4. Trois barrières

A : which openclaw-gateway non vide. B : pas de trafic canal tant que gateway status n’est pas sain. C : pas de dépendance tunnel seule sans cold start launchd. Après B, fermez toutes les sessions SSH et reverifiez sans export PATH manuel.

5. Étude de cas

En mai 2026, une équipe sur Mac mini distant a fait tourner les clés API avant d’aligner Node 22 absolu dans la plist et d’exécuter gateway install --force plus probe canaux. L’article v2026.5.x suppose une base saine ; sinon plugins et TTS n’ajoutent que du bruit.

6. Lecture industrielle

Les piles agent 2026 versionnent CLI, passerelle et plugins séparément. Un npm réussi ne ferme pas la boucle. Windows/Linux restent possibles mais gonflent les variables bureau/navigateur. Un nœud Apple Silicon distant dédié tranche vite « non enregistré » vs « réseau ». Avant d’acheter du métal, figez des check-lists auditables et des preuves de cold start. Pour réduire la friction : louez un Mac distant MACGPU et figez ce runbook dans vos releases.

Les passerelles Windows ou Linux peuvent suffire en laboratoire, mais dès que les workflows graphiques et les sessions desktop entrent en jeu, la variance explose. macOS comme plan de référence sert la reproductibilité et des journaux stables, pas un slogan marketing. Si l’équipe a besoin d’un second site propre sans CAPEX immédiat, la location d’un Mac Apple Silicon distant reste le chemin le plus court vers des preuves comparables.

7. Seuils

Démarrage à froid > 90 s avant statut sain : revue disque/AV. Premier ask local > 25 s sans réponse : passerelle avant modèles. Plus de deux --force dans la même fenêtre : diff humain. Moins de trois entrées PATH critiques : défaut non conforme. Comptes d’automatisation partagés : préfixes npm dédiés et fenêtres de maintenance sérialisées.

8. FAQ

Doctor vert, which quand même ? Oui. Token mismatch ? 401 via article jeton ; absence de processus ici. sudo npm ? Non. Relay rouge, gateway vert ? Article Chrome Relay. Mélange install.sh + npm ? Risque de double métadonnée : une stratégie par hôte.