Vous voulez essayer OpenClaw rapidement mais ne savez pas par où commencer ? Ce guide décrit la préparation avant installation (version Node et port 18789), trois modes d'installation et parcours 10 min, étapes de l'installation au premier chat, et trois pièges courants quand la console est inaccessible, plus une FAQ, pour atteindre le premier chat en ~10 min sur Windows, Linux, macOS ou Mac distant.
Avant installation : version Node et port 18789
OpenClaw 2026 requiert Node.js v22 ou plus ; une version inférieure peut faire échouer l'installation ou la compilation. Préférez nvm : nvm install 22 && nvm use 22. OpenClaw utilise par défaut le port 18789 pour la console web. Sur un serveur cloud ou un Mac distant, il faut autoriser 18789 (TCP) dans le pare-feu / groupe de sécurité, sinon le navigateur ne peut pas accéder à la console.
- Version Node : exécuter
node -vdans le terminal ; doit être ≥ v22.0.0. - Port 18789 : autoriser l'entrée 18789 sur l'hôte ; sous Linux avec ufw :
ufw allow 18789.
Trois modes d'installation et choix du parcours 10 min
Selon votre environnement et préférence, choisissez l'une des trois options ci-dessous ; l'objectif est d'être installé et la console ouverte en ~10 min.
| Méthode | Idéal pour | Durée typique | Notes |
|---|---|---|---|
| Script d'installation officiel | Débutants, essai rapide local ou VPS | ~5–10 min | curl -fsSL https://openclaw.ai/install.sh | bash ; le script vérifie et installe Node. |
| Installation npm globale | Développeurs ayant déjà Node 22+ | ~5–8 min | npm install -g openclaw@latest, puis openclaw onboard et openclaw gateway. |
| Docker / image préconstruite | Équipes ou production, dépendances isolées | ~10–15 min | Utiliser l'image Docker officielle ou communautaire ; mapper le port 18789. Certains clouds proposent des images OpenClaw en un clic. |
npm config set registry https://registry.npmmirror.com.Étapes de l'installation au premier chat
Avec le script d'installation et onboard, le chemin minimal est le suivant.
Installer OpenClaw
Exécuter curl -fsSL https://openclaw.ai/install.sh | bash ou npm install -g openclaw@latest et attendre la fin.
Lancer l'assistant de configuration
Exécuter openclaw onboard et suivre les invites pour Gateway, API, etc. ; en cas de dialogue de permission (ex. macOS), l'accepter dans l'interface graphique.
Démarrer le Gateway
Exécuter openclaw gateway (ou systemd/pm2 pour persistance) ; s'assurer que le port 18789 écoute.
Ouvrir la console web
Dans le navigateur aller sur http://localhost:18789 (ou IP_serveur:18789) pour ouvrir le tableau de bord.
Envoyer la première commande
Dans la console ou le TUI (openclaw tui), envoyer une commande simple pour confirmer que le modèle et le Gateway répondent ; le « premier chat » est terminé.
Trois pièges : port et console inaccessible
Beaucoup restent bloqués sur « installé mais la console ne s'ouvre pas » ou des erreurs pendant onboard. Causes et correctifs courants :
- Pare-feu / groupe de sécurité n'autorise pas 18789 : Sur un serveur cloud, ajouter une règle entrante TCP 18789 ; en local Linux avec ufw :
ufw allow 18789puis reload. - Version Node trop ancienne : En dessous de Node 22+, l'installation ou l'exécution peut échouer ; utiliser
nvm use 22ou mettre à jour via le gestionnaire de paquets puis réessayer. - Token par défaut non modifié et scanné : Après déploiement, modifier tout de suite le token Gateway par défaut dans le tableau de bord pour éviter le scan et l'abus publics ; vérifier aussi la longueur des prompts système pour éviter une consommation de tokens anormale.
FAQ
Peut-on vraiment arriver au premier chat en 10 min ?
Avec Node 22+ et un réseau normal, en utilisant le script d'installation ou l'installation npm globale et la séquence onboard → gateway → ouvrir la console 18789 → envoyer une commande, la plupart des utilisateurs peuvent terminer en ~10 min. En cas de problème réseau ou de permissions, voir nos articles dépannage et déploiement OpenClaw.
Pourquoi déployer OpenClaw sur un Mac distant ?
Un Mac distant offre une interface graphique complète (VNC), donc les dialogues de permission système et les demandes Keychain pendant onboard peuvent être cliqués directement, en évitant le cas où un accès SSH seul ne peut pas gérer les dialogues ; à combiner avec nos autres articles déploiement OpenClaw et dialogues de permission.
À quoi sert openclaw doctor ?
openclaw doctor fait un contrôle de santé et aide à diagnostiquer l'environnement, les dépendances et la configuration ; si la console ne démarre pas ou se comporte bizarrement, exécuter d'abord doctor et consulter notre guide de dépannage.
En résumé : On peut faire tourner OpenClaw en local sous Windows, Linux ou sur son propre VPS, mais la version Node, l'ouverture du port, les dialogues de permission et l'environnement ajoutent souvent du temps de dépannage. Pour moins de contraintes d'environnement et une prise en main rapide d'OpenClaw (y compris onboard en GUI et permissions système), louer un Mac distant VNCMac et déployer OpenClaw sur le bureau VNC évite les différences locales et les dialogues non cliquables ; en quelques minutes vous avez un Mac prêt et une configuration graphique. Pour le choix, voir nos pages « Choix d'environnement OpenClaw » et « Mise en service rapide ».