1. Pourquoi un guide OpenClaw spécifique Mac
OpenClaw tourne sur plusieurs plateformes, mais sur Mac (surtout Apple Silicon) le chemin d’environnement, le préfixe global Homebrew et npm, Gatekeeper et les permissions, ainsi que la façon de garder le processus en arrière-plan diffèrent de Linux/Windows. Beaucoup bloquent sur « command not found », EACCES ou port utilisé. Ce guide fournit des étapes Mac reproductibles et un tableau de dépannage.
2. Préparation de l’environnement Mac (Xcode CLI, Homebrew, Node)
Étape 1 : Installer les Xcode Command Line Tools : exécuter xcode-select --install dans le Terminal.
Étape 2 : Installer Homebrew avec la commande officielle. Sur Apple Silicon, ajouter Homebrew au PATH : echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile puis source ~/.zprofile.
Étape 3 : Installer Node.js 22+. Recommandé : brew install nvm, configurer le shell, puis nvm install 22 et nvm use 22. Ou brew install node@22 et brew link node@22 --force. Vérifier avec node -v et npm -v.
3. Comparaison des méthodes d’installation
| Méthode | Commande / remarque | Cas d’usage |
|---|---|---|
| npm global | npm install -g openclaw@latest | Environnement Node existant, test rapide |
| Script officiel | curl -fsSL https://openclaw.ai/install.sh | bash | Dépendances et PATH en une fois |
| Docker | Utiliser l’image OpenClaw officielle ou communautaire | Environnement isolé |
4. Installation en cinq étapes et premier lancement
Étape 1 : Lancer l’installation choisie (ex. npm install -g openclaw@latest). En cas de EACCES: permission denied, corriger le répertoire global npm : sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}.
Étape 2 : Vérifier la CLI : dans un nouveau terminal exécuter openclaw --version. Si « command not found », s’assurer que le PATH inclut le bin global npm (npm config get prefix + /bin).
Étape 3 : Faire l’init selon la doc (ex. openclaw onboard) et configurer la clé API. Le port console par défaut est souvent 18789 ou 3000 ; l’autoriser dans le pare-feu ou le groupe de sécurité.
Étape 4 : Démarrer la passerelle/service (ex. openclaw gateway ou openclaw start). Ouvrir le port dans le navigateur pour vérifier la console.
Étape 5 : Faire un test minimal (une requête via console ou CLI), puis configurer LaunchAgent ou maintien en arrière-plan si besoin.
5. Notes Apple Silicon
(1) Chemin Homebrew : Sur Apple Silicon, Homebrew est sous /opt/homebrew ; ajouter /opt/homebrew/bin au PATH. (2) Rosetta 2 : Certains modules natifs npm peuvent demander Rosetta ; installer si demandé. (3) Gatekeeper : Si un binaire est bloqué : Réglages Système → Confidentialité et sécurité → « Ouvrir quand même ».
6. Tableau de dépannage Mac
| Symptôme | Cause probable | Action |
|---|---|---|
| Command not found (openclaw / node) | PATH sans Homebrew ou bin global npm | Ajouter le chemin dans ~/.zprofile ou ~/.bash_profile et source |
| EACCES | Répertoire global npm pas détenu par l’utilisateur courant | chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} |
| Port utilisé | Port par défaut pris | Changer le port dans la config ou arrêter le processus avec lsof |
| Console inaccessible | Pare-feu ou groupe de sécurité | Autoriser l’app dans le pare-feu macOS ; sur Mac distant, ouvrir 18789/3000 |
| Processus s’arrête quand le capot est fermé | Pas de maintien en arrière-plan | Utiliser LaunchAgent ou nohup/screen ; ou faire tourner sur un Mac distant 24/7 |
7. Conclusion : faire tourner OpenClaw 24/7 sur un Mac distant
Une fois OpenClaw qui tourne en local, pour un fonctionnement 24/7 sans utiliser votre machine ou pour éviter les problèmes de veille/capot, déployez-le sur un nœud Mac distant. Même macOS et mêmes étapes qu’au-dessus, dédié et stable. Pour éviter la gestion locale et l’ops, louez un Mac distant MACGPU et installez OpenClaw dessus pour une configuration unique et une stabilité à long terme.