La première installation d'OpenClaw coince rarement parce qu'on ne sait pas coller une commande — mais parce que chaque étape valide autre chose. Terminal sans erreur, Dashboard ouvert, réponse du modèle et écriture fichier sont quatre points de contrôle distincts. Ce guide suit préparation → installation → configuration → permissions → Dashboard → premier test, pour savoir où chercher dans les journaux en cas d'échec.
0 Ce que ce guide vous fait atteindre
À la fin, vous devez pouvoir confirmer quatre choses : ① CLI et Gateway installés ; ② fournisseur de modèle et clé API connectés ; ③ l'interface Control UI s'ouvre en local dans le navigateur ; ④ une tâche lecture/écriture à faible risque fonctionne dans un dossier test. L'objectif n'est pas seulement « installé », mais « opérationnel dans un périmètre maîtrisé, avec la capacité de déboguer ».
1 Avant d'installer : Mac, réseau et dossier test
Quoi / pourquoi / succès : réunissez d'abord les prérequis pour ne pas déboguer en plein milieu du flux. Il vous faut le Terminal, la documentation d'installation officielle et un dossier test prêt.
- Système — macOS sur Apple Silicon ou Intel. OpenClaw attend Node 24 (recommandé) ou Node 22.19+ ; le script d'installation officiel gère Node automatiquement — Homebrew reste optionnel, pas obligatoire au départ.
- Réseau et admin — accès à openclaw.ai et à votre fournisseur de modèle ; l'installation des configs et des services LaunchAgent peut demander le mot de passe administrateur macOS.
- Compte modèle — inscrivez-vous chez Anthropic, OpenAI, OpenRouter ou équivalent et créez une clé API (identifiant d'accès au service — comme un mot de passe ; ne la commitez jamais sur Git).
- Dossier test — par ex.
~/openclaw-testavec unnotes.txtdedans. L'espace de travail est le dossier qu'OpenClaw a le droit de toucher — commencez par celui-ci seulement.
2 Installer depuis les sources officielles et conserver la sortie
Installez le CLI et le Gateway uniquement via les sources officielles — les paquets non officiels peuvent être altérés. Succès = openclaw --version affiche un numéro de version.
Recommandé sur Mac (détecte l'OS, installe Node, lance l'onboarding) :
curl -fsSL https://openclaw.ai/install.sh | bash
Si vous gérez Node vous-même : npm install -g openclaw@latest, puis openclaw onboard --install-daemon pour enregistrer le service d'arrière-plan LaunchAgent sur macOS.
Conservez la version et la sortie complète du terminal (capture ou notes) — utile pour le dépannage. Vérifiez avec :
openclaw --version · openclaw doctor · openclaw gateway status
openclaw: command not found, ajoutez $(npm prefix -g)/bin au PATH dans ~/.zshrc, rouvrez le Terminal et réessayez (voir la doc officielle).3 Configurer : fournisseur, clé API et fichier de config
Lexique rapide : fournisseur (provider) = service cloud (Anthropic, OpenAI, etc.) ; clé API = identifiant d'accès ; variable d'environnement = réglage shell (ex. export ANTHROPIC_API_KEY=...) ; fichier de config = paramètres persistants dans ~/.openclaw/openclaw.json. Les modèles locaux (Ollama) sont optionnels — pour le premier test, une clé cloud suffit.
Lancez l'assistant d'onboarding (choix du fournisseur, collage de la clé, modèle par défaut) :
openclaw onboard --install-daemon
Succès : openclaw doctor sans erreur bloquante ; envoyer « bonjour » dans le Dashboard ou le CLI obtient une réponse du modèle. Si bloqué : recopiez la clé, vérifiez facturation/limites, assurez-vous qu'aucun proxy ne bloque le HTTPS.
4 Permissions : n'ouvrir que le dossier test au début
Limitez les chemins lecture/écriture et traitez les dialogues macOS avec prudence — l'accès disque complet remet tout votre Mac entre les mains de l'automatisation. Succès = les fichiers ne changent que dans ~/openclaw-test.
Les libellés dans Réglages système → Confidentialité et sécurité (Fichiers et dossiers, Automatisation, Accessibilité, etc.) varient selon la version de macOS — alignez-vous sur ce que vous voyez à l'écran. Recommandations :
- Accordez uniquement le dossier test — pas « Disque entier » ni la racine iCloud dès le premier jour.
- Refusez Calendrier, Contacts, Enregistrement d'écran et demandes similaires tant que vous n'en avez pas besoin.
- N'exposez pas le port Gateway sur Internet — accès local ou derrière VPN uniquement.
5 Ouvrir le Dashboard : URL locale et Mac distant
Chargez l'interface Control UI pour confirmer que le Gateway et les sessions fonctionnent. Exécutez openclaw dashboard ou ouvrez http://127.0.0.1:18789/ (localhost uniquement).
| Symptôme | Cause probable | À essayer d'abord |
|---|---|---|
| Connexion impossible | Gateway arrêté | openclaw gateway status ; si besoin openclaw onboard --install-daemon |
| OK en local, pas depuis une autre machine | Écoute sur 127.0.0.1 seulement | Tunnel SSH : ssh -L 18789:127.0.0.1:18789 user@mac, puis ouvrir l'URL en local |
| URL correcte, page blanche | Cache navigateur ou extensions | Fenêtre privée Safari, ou désactiver bloqueurs de pub et réessayer |
Les journaux sont votre preuve — croisez openclaw doctor avec l'aide officielle / dépannage plutôt que de modifier la config au hasard.
6 Premier lancement : une tâche test à faible risque
Mettez deux lignes dans ~/openclaw-test/notes.txt, par ex. « Nom de code projet : Alpha. » Dans le Dashboard ou le CLI, envoyez :
Lis notes.txt dans le dossier openclaw-test, résume-le en trois phrases et écris summary.md dans le même dossier.
C'est bon quand : ① la réponse correspond au fichier ; ② summary.md apparaît dans le dossier ; ③ openclaw doctor reste OK ; ④ les journaux montrent la requête (non vides). Si l'écriture échoue, vérifiez d'abord les autorisations fichiers macOS avant d'incriminer le modèle.
7 Erreurs fréquentes chez les débutants
command not found
Le bin npm global n'est pas dans le PATH → mettez à jour ~/.zshrc et rouvrez le Terminal.
Clé API invalide / 401
Régénérez la clé, vérifiez que le fournisseur correspond au choix onboard, supprimez les espaces en trop.
Le Dashboard ne s'ouvre pas
Lancez gateway status, vérifiez le port 18789, confirmez la bonne machine (local vs distant).
Permission refusée / impossible d'écrire
Réglages système → Confidentialité et sécurité → accordez au Terminal ou OpenClaw l'accès au dossier test uniquement — pas le disque entier.
Une fois le cas test validé, élargissez progressivement vers de vrais dossiers projet, canaux Telegram/Slack, Calendrier ou Rappels. À chaque étape : petit essai → lire les journaux → élargir le périmètre.
- 1Étendez les répertoires autorisés du dossier test à un dépôt réel mais non production
- 2Ajoutez des listes blanches de canaux dans
openclaw.json(ex.allowFrom) - 3Pour du 24/7, confirmez le démarrage auto LaunchAgent et lancez
openclaw doctorrégulièrement
8 Faire tourner OpenClaw sur Mac mini, c'est plus simple
OpenClaw est une Gateway auto-hébergée : le laisser en permanence sur un MacBook du quotidien entre en concurrence avec votre travail. Le Mac mini M4 reste silencieux à environ 4 W au repos, exécute nativement le script d'installation officiel et le LaunchAgent, et s'accorde bien avec Gatekeeper, SIP et FileVault pour un compte agent verrouillé. Validez d'abord le cas test en local, puis migrez vers un Mac mini dédié pour la durée — voir les options ci-dessous.
OpenClaw 24/7 · Faible consommationObtenir un Mac mini — votre nœud OpenClaw
Provisionnement rapide · SSH distant · Réseau stable · Pensé pour Gateway IA et Dashboard en continu.