Aller au contenu
Guides

Configurer OpenClaw pas à pas

Installation, assistant de démarrage, service de passerelle, premier message

6 min de lecture

Configurer OpenClaw, c’est une ligne pour installer et une poignée de commandes ensuite, et la documentation promet une discussion fonctionnelle en cinq minutes environ. Cela tient quand la machine a déjà ce qu’il faut. Le reste de ce guide, c’est ce que fait vraiment chaque étape, où les gens bloquent, et quels choix on fait une fois pour vivre ensuite avec.

Avant de commencer

  • Node.js 24.16 ou plus récent, la version 26 étant celle que la documentation recommande. Vérifiez-le avant de commencer ; la boucle des modules manquants sous Windows commence en général là.
  • Un accès à l’IA : une session Claude Code ou Codex CLI existante, ou une clé d’API de fournisseur. L’assistant de démarrage réutilise ce qu’il trouve et le vérifie par une vraie complétion avant de configurer quoi que ce soit d’autre.
  • Une machine qui restera allumée, si vous voulez que l’assistant réponde quand vous n’êtes pas au clavier. Aucun installateur ne couvre cette étape.

Les cinq étapes

  • Installer : une ligne curl sur macOS et Linux, une ligne PowerShell sur Windows. L’installateur lance de lui-même l’assistant de démarrage.
  • Démarrer : le démarrage rapide réutilise l’accès IA détecté et ouvre le tableau de bord web ; la configuration personnalisée passe par toutes les options ; l’assistant classique ajoute les canaux, les compétences et une passerelle distante.
  • Installer le service de passerelle. Le démarrage rapide laisse la passerelle au premier plan de votre terminal ; arrêtez-la et installez le service : un LaunchAgent sur macOS, une unité systemd utilisateur sur Linux et WSL2, une tâche planifiée sur Windows.
  • Vérifier : la commande d’état doit montrer la passerelle à l’écoute sur le port 18789, et la commande de tableau de bord ouvre l’interface de contrôle dans votre navigateur.
  • Envoyer le premier message dans l’interface de contrôle, puis connecter un canal. Telegram est le plus rapide : un jeton de bot et rien d’autre.

L’assistant de démarrage établit d’abord l’inférence et ne configure le reste qu’ensuite. Il ne sélectionne jamais de lui-même un abonnement existant, il ne télécharge pas de modèles, et une installation locale neuve adopte par défaut le profil d’outils de développement, qui conserve les outils de fichiers et d’exécution sans le profil complet illimité. Ce sont les trois valeurs par défaut à connaître avant de les changer.

Où les gens bloquent

  • Des modules manquants sous Windows, l’un après l’autre. La documentation renvoie vers WSL2 ou l’application Windows Hub précisément pour ce cas.
  • Une passerelle qui ne tourne que tant que le terminal est ouvert, parce que l’étape du service a été sautée.
  • Un bot qui ne répond pas, parce que la première demande d’appairage n’a jamais été approuvée ou que le groupe exige une mention.
L’installation tient en une ligne. La rendre stable en production est un autre sport.

Si la configuration ne fonctionne pas

Une commande transforme l’état de l’installation en diagnostic : le triage exécute des vérifications en lecture seule, écrit une invite expurgée décrivant ce qu’il a trouvé, et propose de la confier à un agent de programmation détecté sur votre machine. Rien ne quitte la machine tant que vous n’en choisissez pas un, et les secrets comme les journaux bruts sont exclus. OpenClaw ne répond pas est la version par symptôme de la même échelle.

Ou se passer de la machine

Les cinq étapes sont les mêmes sur toutes les plateformes, et la sixième aussi, celle qui n’est écrite nulle part : garder la passerelle en vie, à jour et payée. OpenClaw hébergé sur Diali s’occupe de cette partie sur une instance isolée dans l’UE, et vous commencez au premier message. Si vous êtes sous Windows, le guide Windows est la carte honnête des trois chemins d’installation.

  • Installer, démarrer, installer le service, vérifier, écrire.
  • L’inférence est vérifiée avant que quoi que ce soit d’autre ne soit configuré.
  • La machine qui reste allumée est l’étape que vous décidez, pas l’installateur.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.