Installation d'OpenClaw : le guide pas à pas, avec les commandes testées (2026)

OpenClaw : l'installation en 8 étapes, d'un coup d'œil

Ce tableau donne, pour chaque étape, ce que tu fais, comment vérifier que c'est fait et le piège le plus courant. La passerelle (gateway) est le programme d'OpenClaw qui reçoit tes messages et fait travailler ton agent. Le port 18789 est sa « porte » réseau, qui doit rester fermée à Internet.

Étape 1 : choisir la machine où installer OpenClaw

Commence par la machine, parce qu'OpenClaw agit avec les droits de la session d'utilisateur sous laquelle il tourne. Il lit les fichiers de cette session, se sert de son navigateur et lance des commandes en son nom. C'est ce qui le rend utile. C'est aussi pour cela que le choix de la machine décide de ce qu'il peut toucher.

Sa configuration inspecte d'ailleurs l'ordinateur. Depuis OpenClaw 2.0, la grande mise à jour de fin août 2026, « elle va simplement découvrir tout ce qu'elle peut trouver sur ton système », expliquait un membre de l'équipe le 20 août, jusqu'aux applications installées.

Le CERT-FR, le service de l'État qui répond aux cyberattaques, a pris position le 13 avril 2026. Il demande de ne pas installer ce type d'assistant sur un poste de travail tant que le produit n'est pas éprouvé. Il le réserve à un environnement de test isolé, sans données sensibles. Ce texte vise d'abord les entreprises et les administrations. Pour toi, en pratique, cela veut dire une machine qui ne contient aucun de tes comptes personnels en ligne, ni tes fichiers, ni tes mots de passe enregistrés.

Voici les quatre options, avec leur prix au 4 novembre 2026. Hostinger est un autre hébergeur.

Un VPS, pour virtual private server, est un ordinateur loué dans un centre de données, que tu pilotes à distance. Prends 2 Go de mémoire vive au minimum, la mémoire de travail de l'ordinateur. OpenClaw en occupe environ 1,4 Go au repos, sans messagerie ni conversation. C'est le total de ses programmes, 100 secondes après le démarrage, lors du test du 4 novembre 2026.

Avec 1 Go seulement, le système l'a arrêté pendant ce test. Les offres d'entrée ont déjà 4 Go, chez OVHcloud (VPS-1) comme chez Hostinger (KVM 1). Chez Hostinger, les prix affichés sont des tarifs de lancement sur deux ans : le renouvellement coûte plus du double.

Ceux qui ont installé OpenClaw ne sont pas d'accord sur la meilleure machine. Chacun a un bon argument.

• Le serveur loué évite les soucis à la maison. Didier Laket, qui publie des tutoriels d'automatisation, y voit la fin des pannes d'électricité et d'Internet, pour 5 € par mois chez l'hébergeur Hetzner (février 2026, avec un lien qui lui rapporte une commission).
• Un ordinateur chez toi n'est pas exposé à Internet. Le vidéaste américain Alex Finn craint un serveur mal réglé, ouvert à tout Internet (février 2026). Ce risque vient d'un mauvais réglage : d'origine, le tableau de bord d'OpenClaw reste fermé à Internet, comme l'a montré le test du 4 novembre.
• Une machine virtuelle sépare OpenClaw sans rien acheter. C'est une variante de ton ordinateur. Le vidéaste Minutora fait tourner Ubuntu, une version courante de Linux, dans VMware Fusion, un ordinateur simulé à l'intérieur de son Mac. Il prévoit 8 Go de mémoire et une centaine de Go de disque pour lui (mars 2026).

Tous s'accordent sur un point, qui est aussi celui du CERT-FR : une machine à part. Matt Carano, un fondateur qui ne sait pas coder et fait travailler ses agents depuis février 2026, le dit ainsi dans sa vidéo d'octobre : « Si tu ne retiens qu'une chose côté sécurité, retiens celle-ci : mets ton OpenClaw sur une autre machine. »

Sache aussi d'où vient une partie des conseils. Le 4 novembre 2026, sur les 19 premières vidéos de YouTube pour « installer openclaw », au moins 7 affichent un lien ou un code Hostinger dans leur description. Un tel lien rapporte en général une commission au vidéaste. Il ne rend pas le tutoriel faux, mais il peut expliquer le succès du serveur loué dans ces vidéos. Ce guide le conseille pour les raisons données plus haut, sans lien d'affiliation.

Une session à part sur ton propre ordinateur convient pour un essai. Pour la documentation d'OpenClaw, une session d'utilisateur à part sépare deux usages qui ne doivent pas voir les données l'un de l'autre. Crée-la sans droits d'administrateur :

• Sur un Mac. Va dans Réglages Système, puis Utilisateurs et groupes, puis Ajouter un utilisateur. Choisis le type Standard.
• Sous Windows. Va dans Paramètres, puis Comptes, puis Autres utilisateurs. Choisis Ajouter un compte.

Sur un Mac, les dossiers Bureau, Documents, Téléchargements et Bibliothèque d'une session ne sont lisibles que par elle (droits relevés sur macOS 26.2). Ce que ton navigateur retient, mots de passe et connexions, est rangé dans Bibliothèque. Ton agent ne voit donc ni tes fichiers ni ce que retient ton navigateur. Cette session garde trois limites :

• Ton agent partage ton réseau et peut joindre les autres appareils de la maison.
• Une faille du système suffirait à franchir la séparation.
• Ton agent ne tourne que tant que cette session reste ouverte, même si tu travailles dans une autre.

Sur un ordinateur de travail, le CERT-FR demande de ne pas l'installer, même dans une session à part.

Tu n'as pas besoin d'acheter une machine. Beaucoup choisissent un Mac mini pour le laisser allumé, mais à la question « faut-il un Mac mini ? », la documentation répond « non ». Le choix d'un Mac mini pour OpenClaw a son guide, en anglais.

Une machine à toi ne veut pas dire que tes données restent chez toi : ce que tu fais lire à ton agent part en général chez l'entreprise du modèle d'IA, comme OpenAI ou Anthropic. Un agent installé chez soi n'est donc pas forcément privé (guide en anglais).

Voici la preuve que c'est fait. Tu as la machine sous la main, ou ton serveur est commandé. Elle ne contient aucun de tes comptes personnels en ligne. Seule exception : l'essai d'une soirée sur ton ordinateur, dans une session à part.

Étape 2 : lancer l'installation d'OpenClaw

La suite dépend de la machine que tu as choisie. Va directement à ton cas :

• Un serveur loué. Tu le prépares depuis ton ordinateur, puis tu lances le script sur le serveur, jamais sur ton ordinateur.
• Un Mac ou un ordinateur sous Linux. Tu lances le script sur cette machine. Sur un Mac récent, l'application évite le terminal.
• Un PC sous Windows. Tu installes Windows Hub.
• Docker. Si tu veux OpenClaw dans une boîte isolée, sur une machine déjà équipée.
• Une offre gérée. Rien à installer : tout se fait dans l'interface de l'hébergeur.

Prends toujours ce que tu installes à sa source : openclaw.ai, docs.openclaw.ai ou github.com/openclaw. La page officielle s'intitule « Install OpenClaw ». Plusieurs sites au nom proche se classent aussi dans Google. Le 4 novembre 2026, openclaws.io arrivait quatrième sur « openclaw installation » avec un guide d'installation, sans venir de l'équipe d'OpenClaw.

Une ligne collée dans un terminal s'exécute avec tes droits. Compare donc chaque ligne d'installation de ce guide à celle de la page officielle avant de la coller.

Installer OpenClaw sur un serveur loué (VPS)

Un serveur loué demande une préparation de plus, parce qu'il faut d'abord y entrer. Un agent de code installé sur ton ordinateur peut faire ces gestes avec toi, sauf l'achat.

1. Commande le serveur. Prends Ubuntu 24.04 avec 2 Go de mémoire vive ou plus. L'hébergeur te donne un identifiant et l'adresse du serveur, quatre nombres séparés par des points.
2. Connecte-toi depuis ton ordinateur. Dans ton terminal, lance ssh root@<adresse-du-serveur>, ou ssh ubuntu@<adresse-du-serveur> chez OVHcloud. SSH est la connexion chiffrée qui te donne un terminal sur le serveur. À la question Are you sure you want to continue connecting, réponds yes, puis tape ton mot de passe. La ligne commence alors par root@ ou ubuntu@.
3. Chez OVHcloud, change le mot de passe temporaire. Celui de l'e-mail de livraison est à remplacer dès la première connexion. La connexion se ferme ensuite : reconnecte-toi. Cet utilisateur ubuntu est déjà ordinaire, donc passe le geste suivant et utilise ubuntu à la place de <nom>.
4. Ailleurs, crée un utilisateur ordinaire. root est le compte administrateur et ton agent ne doit pas tourner sous ce compte. Lance adduser <nom>, choisis un mot de passe et appuie sur Entrée à chaque question. Lance usermod -aG sudo <nom>, qui l'autorise à agir en administrateur en retapant son mot de passe. Lance enfin exit.
5. Crée ta clé SSH, si tu veux te passer du mot de passe. Ce geste est conseillé, pas obligatoire. Une clé SSH remplace le mot de passe de connexion, avec un fichier gardé sur ton ordinateur. Lance ssh-keygen -t ed25519 et appuie trois fois sur Entrée. Le message Your public key has been saved confirme sa création.
6. Envoie-la au serveur. Sur un Mac ou sous Linux, lance ssh-copy-id <nom>@<adresse-du-serveur> et tape ton mot de passe. La première commande ci-dessous fait la même chose sous Windows. Le message Number of key(s) added: 1 confirme l'envoi sur Mac et Linux.
7. Reconnecte-toi sous ce nom. Lance ssh <nom>@<adresse-du-serveur>. Avec la clé, aucun mot de passe de connexion n'est demandé. La ligne commence par <nom>@ et whoami répond ton nom.
8. Lance le script sur le serveur. C'est la seconde ligne ci-dessous. Elle demande ton mot de passe, car elle installe des logiciels sur tout le serveur.

type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh <nom>@<adresse-du-serveur> "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

curl -fsSL https://openclaw.ai/install.sh | bash

Voici la preuve que c'est fait. Le script affiche OpenClaw installed successfully, puis enchaîne sur les questions de la configuration : réponds-y dans cette même fenêtre. Ce parcours a été testé le 4 novembre 2026 entre deux conteneurs, l'un jouant ton ordinateur et l'autre le serveur. Les écrans d'un vrai hébergeur peuvent différer. La commande de Windows n'a pas été testée.

Installation d'OpenClaw sur Mac ou Linux

Le script est le même partout. Décide d'abord de ta série de versions, car en changer plus tard bloque.

Y venir après coup a échoué lors du test. Sur une installation 2026.10.10 déjà configurée, openclaw update --channel extended-stable a refusé le changement, parce que la version 2026.9.36 de cette série ne sait pas lire les données d'une version plus récente.

Tu peux d'abord voir ce que le script va faire. Enregistre-le, puis lance-le avec l'option --dry-run, un essai qui ne change rien. Il se termine par Dry run complete (no changes made).

curl -fsSL https://openclaw.ai/install.sh -o install-openclaw.sh
bash install-openclaw.sh --dry-run

Pour installer, colle cette ligne dans le terminal de la machine choisie et appuie sur Entrée :

curl -fsSL https://openclaw.ai/install.sh | bash

Elle télécharge le script officiel et l'exécute aussitôt. Compte une à deux minutes : 68 et 106 secondes lors des deux essais du 4 novembre 2026, sur un Ubuntu 24.04 neuf. Le script y a installé, dans cet ordre :

• Des outils de compilation : make, g++, cmake et python3, qui préparent des morceaux d'OpenClaw.
• Node 24.22.2, le moteur qui exécute OpenClaw. Le script ajoute NodeSource, d'où il vient, aux sources de logiciels de la machine.
• Git, le programme qui copie un code et suit ses versions.
• OpenClaw 2026.10.10, qui occupe 643 Mo à lui seul.

L'ensemble a pris 1,6 à 1,7 Go d'espace disque. Sur un Mac, la documentation indique que le script passe par Homebrew, le gestionnaire de logiciels courant sur macOS, puis installe Node 26. Cette partie n'a pas été testée.

Voici la preuve que c'est fait. Le script affiche OpenClaw installed successfully (2026.10.10)! ou un numéro plus récent. Il enchaîne aussitôt sur les questions de la configuration : réponds-y dans cette même fenêtre.

Une fois ces questions finies, ouvre un nouveau terminal, car la fenêtre déjà ouverte peut ne pas trouver openclaw. Sur un serveur, lance exit et reconnecte-toi. openclaw --version doit alors répondre.

Dans une session sans droits d'administrateur, prends l'autre script. install.sh s'y arrête, comme l'a montré le test : sudo is required for system installs on Linux. install-cli.sh range tout dans ton dossier personnel, sans droits d'administrateur. Il a réussi en 24 secondes sur Linux. Il lui faut Git déjà installé.

curl -fsSL https://openclaw.ai/install-cli.sh | bash
~/.openclaw/bin/openclaw onboard

La seconde ligne lance la configuration. Dans cette session, écris ~/.openclaw/bin/openclaw à la place de openclaw dans la suite de ce guide.

La version de Node : laisse le script s'en charger

Node.js est le programme qui fait tourner OpenClaw. Ne l'installe pas toi-même : le script choisit pour toi. Les chiffres qui circulent, eux, se contredisent. Voici ce que disaient ces quatre sources le 4 novembre 2026.

Voici ce que le script a fait ce jour-là sur un Linux, selon ce qu'il trouvait :

• Aucun Node. Il a installé Node 24.22.2.
• Node 22. Il a installé Node 24.22.2 à côté et OpenClaw s'en est servi. Sans le script, l'installation à la main avec npm, l'installateur de paquets de Node, a échoué.
• Node 24.16. Il l'a gardé et OpenClaw a démarré. Cette version est plus ancienne que celle que l'équipe recommande : demande à ton agent de code de la mettre à jour.
• Node 26.13. Il l'a gardé et OpenClaw a démarré.

La recommandation a une raison. Une autorité qui délivre des certificats, eMudhra, a subi un incident en octobre 2026 et des clés de sécurité ont été compromises. Node 24.22.1 et 26.12.1 refusent ces clés. OpenClaw a exigé ces versions du 22 octobre au 3 novembre 2026, puis OpenClaw 2026.10.10 les a seulement recommandées. Si le script a installé Node pour toi, tu n'as rien à faire.

Si tu gères Node à ta façon, vérifie ta version avec node -v et le minimum du jour avec npm view openclaw engines.

Sur Mac, l'application évite le terminal

L'application OpenClaw pour Mac s'affiche dans la barre des menus, en haut de l'écran. Elle installe OpenClaw sans terminal et contient déjà tout ce qu'il lui faut. Elle demande macOS 26.2 (Tahoe) ou plus récent. Sur un Mac plus ancien, passe par le script, prévu dès macOS 13.5.

Sur la page Mac de la documentation, prends le fichier arm64.dmg pour un Mac à puce Apple, ou la version universelle si tu ne sais pas. Ouvre-le, glisse OpenClaw dans Applications et lance-le.

Hannes Rudolph, responsable de la communauté d'OpenClaw, montrait cette application en août 2026. Il décrivait ainsi ce qu'elle remplace : « tu copies-colles quelque chose dans ton terminal et ensuite, tu sais, tu te bats avec les problèmes ». Le script reste le chemin testé ici. L'application, elle, n'a pas été testée et ce qui suit vient de la documentation.

La suite se passe dans l'application. Elle ouvre le tableau de bord sur une conversation qui remplace les questions de la configuration. Elle reprend une connexion existante à ton modèle d'IA ou te demande de te connecter à ChatGPT, puis te guide pour les messageries.

La passerelle s'arrête quand tu quittes l'application. Pour qu'elle reste en marche, active Keep OpenClaw running when the app is closed et Launch at login dans les réglages du tableau de bord. L'application ajoute aussi la commande openclaw à ton terminal, pour le mode prudent et les mises à jour.

Voici la preuve que c'est fait. L'icône d'OpenClaw apparaît dans la barre des menus et ton agent répond dans le tableau de bord.

Comment installer OpenClaw sous Windows

La documentation propose trois chemins. Aucun n'a été testé ici : ce qui suit vient de cette documentation, de vidéos et de signalements datés.

Windows Hub demande quatre gestes. Cette application fonctionne sur Windows 10 (version 20H2 et après) et Windows 11. Elle s'installe sans droits d'administrateur, sauf s'il faut d'abord activer WSL.

1. Télécharge l'installateur. Sur la page des versions de Windows Hub, prends OpenClawCompanion-Setup-x64.exe. Prends la version arm64 si Paramètres, Système, Informations indique un « processeur ARM » à la ligne « Type du système ».
2. Lance-le. Le menu Démarrer affiche cette application sous le nom OpenClaw Companion.
3. Choisis Set up locally. Windows Hub crée alors un Linux à part, nommé OpenClawGateway, puis y installe la passerelle. Un Linux que tu aurais déjà n'est pas touché. WSL, le sous-système Windows pour Linux, fait tourner ce Linux à l'intérieur de Windows.
4. Réponds aux écrans jusqu'à all set, « tout est prêt ». L'icône près de l'horloge passe alors au vert. Son menu ouvre le Command Center, l'écran qui montre si la connexion et les messageries fonctionnent.

Si WSL n'est pas prêt sur ton PC, l'application te le signale. Le vidéaste d'AI Fire Academy l'a vécu en septembre 2026. Il a installé WSL en administrateur, puis redémarré son ordinateur. Pour ouvrir ce terminal, fais un clic droit sur le menu Démarrer, puis choisis Terminal (administrateur) ou Windows PowerShell (administrateur). La commande est wsl --install.

La suite se passe dans Windows Hub. Ce même vidéaste y a enchaîné les permissions, Quick start, le nom de son agent, la connexion à OpenAI, le test du modèle et Telegram, puis le bouton Finish a ouvert le tableau de bord. Ces écrans suivent le même ordre que la configuration décrite plus bas.

Pour les commandes openclaw, ouvre PowerShell et lance wsl -d OpenClawGateway --user openclaw. Tu es alors dans ce Linux, où elles se tapent telles quelles.

Ce Linux est verrouillé. La passerelle y tourne sous un utilisateur openclaw, qui ne peut pas agir en administrateur. Les disques de Windows n'y sont pas branchés, si bien que ton agent ne voit pas tes fichiers Windows.

Windows a aussi un bac à sable, un espace isolé où les commandes s'exécutent sans toucher au reste du système. Il est facultatif. Lors de sa conférence Build du 2 juin 2026, Microsoft l'a montré dans une préversion de Windows Hub, réglé en lecture seule. Sommé d'effacer le bureau de Windows, l'agent de la démonstration a réessayé plusieurs fois et les 94 images posées dessus sont restées. « Il y a six mois, ça aurait marché », a commenté Peter Steinberger, le créateur d'OpenClaw.

Ce bac à sable n'est pas actif d'office. C'est une extension, MXC, qui s'ajoute avec openclaw plugins install @openclaw/mxc-sandbox. Demande à ton agent de code de la régler.

PowerShell convient si tu préfères taper des commandes. La seconde ligne inscrit la passerelle dans le planificateur de tâches de Windows, pour qu'elle démarre avec l'ordinateur.

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

Installé ainsi, ton agent tourne sous ta session Windows et voit tout ce qu'elle voit. Ce chemin est aujourd'hui le moins fiable, d'après les signalements déposés sur GitHub, la plateforme où l'équipe publie son code et ses bugs :

• Le 25 octobre 2026, cette commande documentée a échoué pour tout le monde pendant 72 minutes, avant même d'installer quoi que ce soit, puis l'équipe l'a corrigée (signalement n° 183088).
• Sur Windows 11, un utilisateur a vu sa passerelle mettre 27 minutes à démarrer après une installation neuve (n° 164396, octobre 2026).
• Un autre, avec 13 extensions ajoutées, mesure 17 minutes à chaque démarrage depuis la version 2026.10.1 (n° 168955).

Masdouk Adelakoun, fondateur de la chaîne Tech Man, a filmé cette installation en mars 2026. Le script s'est lancé dès la sixième minute de sa vidéo, mais la passerelle ne se connectait pas. Il a passé près d'une heure à la débloquer, en montrant ses captures d'écran à Claude et en relançant PowerShell en administrateur. Sa conclusion : « vous allez rencontrer définitivement des problèmes ».

Le script d'OpenClaw prévient d'ailleurs lui-même, quand il détecte Windows : « OpenClaw fonctionne très bien sous WSL2 ! Windows natif peut être plus délicat ». Windows natif veut dire Windows sans WSL.

WSL2 à la main te donne un vrai Linux. Dans PowerShell ouvert en administrateur, lance la commande ci-dessous, redémarre si Windows le demande, puis ouvre l'entrée Ubuntu du menu Démarrer. Ubuntu te demande un nom et un mot de passe à la première ouverture.

wsl --install -d Ubuntu-24.04

Dans Ubuntu, colle ce bloc d'un seul coup : il écrit le fichier de réglages de WSL. La première section active systemd, le gestionnaire de services de Linux. Les deux suivantes protègent tes disques Windows. D'origine, WSL les rend lisibles depuis Linux. Avec ces réglages, ton agent ne peut plus les lire ni y lancer des programmes Windows (réglages décrits par Microsoft).

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true

[automount]
enabled=false

[interop]
enabled=false
appendWindowsPath=false
EOF

Redémarre WSL depuis PowerShell avec wsl --shutdown, rouvre Ubuntu et colle la ligne d'installation du script. Pour que ton agent tourne sans session Windows ouverte, la documentation ajoute deux réglages. Voici le premier, dans Ubuntu :

sudo apt-get install -y dbus-x11
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install

Le second se fait dans PowerShell ouvert en administrateur. Cette tâche réveille Ubuntu au démarrage de Windows. Elle est nécessaire parce que les versions récentes de WSL arrêtent Ubuntu 15 à 20 secondes après la déconnexion du dernier programme.

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu-24.04 --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

Voici la preuve que c'est fait. Avec Windows Hub, l'icône est verte. Avec PowerShell ou WSL2, openclaw --version répond dans un nouveau terminal.

Installer OpenClaw avec Docker

Docker fait tourner un logiciel dans un conteneur, une boîte isolée du reste de la machine. La documentation le présente comme optionnel, pour un essai que tu peux effacer ensuite ou un serveur où l'on ne veut rien installer. Il faut d'abord Docker et Git sur la machine : Docker Desktop sur Mac et Windows, Docker Engine sous Linux.

Tu copies ensuite le dépôt, le dossier où l'équipe publie son code. Le script de préparation qu'il contient télécharge l'image officielle, c'est-à-dire le logiciel prêt à lancer, puis ouvre la configuration, génère le jeton et démarre la passerelle. Le jeton est le secret qui protège la passerelle.

git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

N'utilise que les images ghcr.io/openclaw/openclaw ou openclaw/openclaw. Ce bloc prend l'image toute faite. Les 6 Go de mémoire dont parle la documentation ne servent que si tu la fabriques toi-même. Ce script de préparation n'a pas été testé ici.

Dans un conteneur, la passerelle accepte par défaut les connexions venues de partout, pour que Docker puisse les lui transmettre. Sans jeton, elle refuse de démarrer. Le test du 4 novembre 2026 a obtenu ce message : Refusing to bind gateway to auto without auth. Sur un serveur, un port ouvert par Docker contourne en plus UFW, le pare-feu courant d'Ubuntu. Demande à ton agent de code d'ajouter la règle que donne la documentation, nommée DOCKER-USER.

Docker a aussi un prix en temps : ton agent bute souvent sur les limites de la boîte, parce qu'il a besoin de faire ce que tu n'avais pas prévu, ce qui t'oblige à ajuster sans arrêt. Le développeur Melvynx racontait en février 2026 avoir « passé 6 h à tout corriger » sur son installation Docker. La procédure d'installation a changé depuis.

La suite se tape autrement. Depuis le dossier openclaw, chaque commande de ce guide se lance avec docker compose run --rm openclaw-cli devant, sans le mot openclaw : par exemple docker compose run --rm openclaw-cli channels add --channel telegram --token <ton-jeton>.

Voici la preuve que c'est fait. curl -fsS http://127.0.0.1:18789/healthz répond {"ok":true,"status":"live"} sur la machine. Le jeton est écrit dans le fichier .env du dossier openclaw.

OpenClaw géré par un hébergeur : rien à installer

Hostinger propose deux offres. La version gérée s'occupe de tout. La version sur VPS te laisse le serveur, que tu pilotes dans son interface. Les autres hébergeurs n'ont pas été comparés ici.

La plupart des étapes de ce guide se font alors dans l'interface. Voici leur correspondance, d'après la documentation d'OpenClaw :

• La configuration. Un formulaire te demande ta clé API, un code d'accès à un modèle d'IA, ou te vend des crédits d'IA.
• L'arrière-plan. L'hébergeur s'en occupe.
• Le tableau de bord. Il s'ouvre depuis OpenClaw Overview ou le bouton Open de son panneau, hPanel.
• La messagerie. Le formulaire prend le jeton de ton robot Telegram. Tu approuves ton compte depuis la conversation du tableau de bord.
• Le mode prudent. Il se règle dans le tableau de bord, comme l'explique l'étape qui lui est consacrée.
• Les mises à jour. La version gérée se met à jour seule. Sur VPS, c'est le bouton Update du Docker Manager.

Les deux vidéastes cités ici sont payés ou affiliés. Dans une vidéo de septembre 2026 sponsorisée par Hostinger, Renaud Dékode installe OpenClaw ainsi sans taper une commande, en collant une clé API dans un formulaire. Le même mois, la chaîne Creator Magic, avec son code de réduction, dit avoir un agent en marche « en moins de 60 secondes » sur la version gérée.

Une chose reste à vérifier sur la version VPS. En mars 2026, le vidéaste Christian Lempa, spécialiste des serveurs maison, y signalait deux accès au tableau de bord : un accès chiffré et un accès direct par un port ouvert. Prends celui dont l'adresse commence par https://. Cette offre n'a pas été testée ici.

Voici la preuve que c'est fait. Le tableau de bord s'ouvre depuis le panneau et ton agent répond à « Bonjour », y compris sur Telegram une fois ton compte approuvé.

Étape 3 : répondre à la configuration et brancher ton IA

OpenClaw ne fournit aucun modèle d'IA : tu branches le tien et c'est lui qui le fait réfléchir. La configuration démarre seule à la fin du script. Si elle ne démarre pas, lance openclaw onboard. Elle s'affiche en anglais, le seul autre choix étant le chinois. Ton agent, ensuite, te répondra en français.

Les flèches haut et bas déplacent le choix, Entrée le valide. Voici les écrans relevés lors du test du 4 novembre 2026 :

1. How would you like to start? Laisse Quick start (recommended) et appuie sur Entrée.
2. What would you like to create? Laisse One agent et appuie sur Entrée.
3. Model/auth provider. C'est le choix de ton modèle d'IA, expliqué juste après. OpenClaw a d'abord cherché ce que tu as déjà sur la machine.
4. Keep OpenClaw running in the background? Laisse oui et appuie sur Entrée. Cet écran n'existe pas dans un conteneur : il vient de la documentation.
5. Set up memory embeddings? Laisse No et appuie sur Entrée. Cette option de recherche dans sa mémoire s'ajoute plus tard.

Avec un abonnement ChatGPT, voici le chemin. Le vidéaste d'AI Fire Academy l'a suivi en septembre 2026. Il n'a pas été testé ici, faute de vrai compte.

1. Choisis OpenAI. C'est la première ligne de Model/auth provider.
2. Choisis Codex login (device code). C'est la première ligne de OpenAI auth method, prévue pour une machine distante.
3. Ouvre le lien affiché sur ton ordinateur. OpenClaw donne un lien et un code. Connecte-toi à ton compte OpenAI, colle le code et approuve.
4. Attends la confirmation. OpenClaw propose un modèle par défaut. Ce vidéaste l'a jugé trop coûteux et a tapé le nom d'un modèle moins cher.

Avec une clé API, voici le chemin. Choisis OpenAI, puis OpenAI API Key. Colle ta clé à la ligne Enter OpenAI API key : elle s'affiche en petits carrés. Le test s'est arrêté là, avec une fausse clé. Je passe moi-même par des clés API, sur des modèles peu chers. Pour un autre fournisseur, remonte à Model/auth provider, où More… ouvre une liste qui se filtre en tapant son nom.

Ta connexion au modèle est la seule exception à la machine sans comptes. Elle sert à le faire répondre et ne donne accès ni à ton mail ni à ta banque. Pour la séparer encore, prends une clé API réservée à OpenClaw. Le guide d'OpenClaw compare ces accès.

Voici la preuve que c'est fait. Un cadre Inference ready s'affiche, avec la ligne Inference verified et le nom de ton modèle. Le test l'a vu avec un faux modèle, un petit programme qui imite une IA. Si la connexion échoue, une ligne commence par ✗ et OpenClaw te ramène à la liste des fournisseurs. Le test l'a vu aussi, avec sa fausse clé.

Regarde quel compte sera facturé avant de valider, car le modèle est souvent la dépense la plus lourde. Voici un exemple avec une clé. À chaque tâche, ton agent renvoie au modèle ses consignes et son historique. Le développeur et vidéaste Benjamin Code a mesuré environ 60 000 tokens, des fragments de mots qui servent d'unité de facturation, par e-mail traité (mai 2026). Tu peux estimer les tiens avec le calculateur de tokens.

Pour 20 tâches par jour, cela fait 1,2 million de tokens envoyés au modèle. Compte aussi environ 1 000 tokens écrits par le modèle à chaque tâche, soit 20 000 par jour. Au tarif de Claude Sonnet 5.5 le 4 novembre 2026, le million envoyé coûte 2 $ et le million écrit 10 $. La journée revient à 2,40 $ + 0,20 $, soit 2,60 $. Cela fait environ 78 $ par mois.

La note baisse si les tâches s'enchaînent assez vite. Anthropic garde alors tes consignes et ton historique en mémoire cinq minutes : c'est le cache. Il les refacture 0,10 $ le million au lieu de 2 $. Avec 90 % de tokens servis ainsi, la journée coûte 1,08 million × 0,10 $ + 0,12 million × 2 $ + 0,20 $, soit environ 0,55 $. Cela fait environ 16 $ par mois, plus un petit supplément pour la mise en cache. Le coût réel d'OpenClaw détaille les abonnements et le choix du modèle.

Fixe un plafond de dépenses, sur la page de facturation de ton fournisseur, avant de coller ta clé. Didier Laket règle le sien dans OpenRouter, un service qui donne accès à plusieurs modèles avec une seule clé. Il l'a mis à 20 € par jour, soit jusqu'à 600 € par mois : prends un plafond à ta mesure. Si ton fournisseur n'en propose pas, achète des crédits d'avance et laisse la recharge automatique coupée.

Le vidéaste Loïc Frissard prévient contre cette recharge, qui remet de l'argent sur ton compte quand le solde baisse : si ton agent tourne toute la nuit sans limite, « vous savez pas jusqu'où ça peut aller ». Je mets moi aussi un plafond chez le fournisseur quand c'est possible, car cela ne coûte rien.

Étape 4 : laisser OpenClaw tourner en arrière-plan

La passerelle doit rester allumée, sinon ton agent ne répond plus et ses tâches programmées ne partent pas. C'est pour cela que Quick start te pose la question Keep OpenClaw running in the background? Réponds oui, le choix proposé par défaut. OpenClaw installe alors la passerelle comme service, c'est-à-dire un programme que le système relance tout seul.

Si tu as répondu non, la passerelle tourne dans ton terminal et s'arrête avec lui. Appuie sur Ctrl+C dans ce terminal (la touche Ctrl, Mac compris), puis lance openclaw gateway install. Ta configuration est conservée.

Deux cas demandent un geste de plus :

• Sur un serveur loué, empêche l'arrêt à la déconnexion. Le service appartient à ton utilisateur et Linux l'arrête quand ta connexion SSH se ferme. Lance la commande ci-dessous, qui demande ton mot de passe. Sans elle, ton agent semble planter chaque fois que tu fermes ton terminal.
• Sur un Mac ou un portable, désactive la mise en veille automatique. Un ordinateur en veille arrête ton agent : coupe cette veille dans les réglages d'énergie si tu veux qu'il réponde la nuit.

sudo loginctl enable-linger "$(whoami)"

Vérifie ensuite ces trois points :

openclaw --version
openclaw doctor
openclaw gateway status

La première commande affiche la version. La deuxième signale ce qui cloche dans la configuration et a pris environ une minute lors du test : colle ce qu'elle signale dans ChatGPT ou Claude si tu ne comprends pas. La troisième montre l'état de la passerelle.

Voici la preuve que c'est fait. openclaw gateway status affiche Listening: 127.0.0.1:18789. La ligne Loopback-only gateway veut dire que seule ta machine peut s'y connecter. Ferme ton terminal, rouvre-le et relance la commande : la réponse doit rester la même.

Le test a tourné dans un conteneur, qui ne peut pas installer de service. Il a donc vu ces deux lignes avec une passerelle lancée à la main. L'installation du service et enable-linger viennent de la documentation.

Étape 5 : ouvrir le tableau de bord et envoyer un premier message

Le tableau de bord est la page web où tu suis les conversations et règles ton agent. Sur ton Mac ou ton PC, ouvre-le ainsi :

openclaw dashboard

La commande ouvre ton navigateur sur http://127.0.0.1:18789/, avec un lien de connexion à usage unique, valable dix minutes. Écris un premier message dans la conversation.

Voici la preuve que c'est fait. Ton agent répond. Lors du test du 4 novembre 2026, un message tapé dans le terminal est bien passé par la passerelle jusqu'au faux modèle et sa réponse est revenue. Pour la suite, le guide d'OpenClaw montre quoi lui confier en premier.

Sur un serveur, ouvre-le par un tunnel

Le tableau de bord donne la main sur tout ton agent. Garde-le sur l'adresse locale du serveur (127.0.0.1), joignable seulement depuis le serveur lui-même. C'est son réglage d'origine. Pour y accéder, ouvre un tunnel SSH, un passage chiffré entre ton ordinateur et le serveur. Sur ton ordinateur, ouvre un second terminal, lance cette commande et laisse la fenêtre ouverte :

ssh -N -L 18789:127.0.0.1:18789 <nom>@<adresse-du-serveur>

Rien ne s'affiche : c'est normal. À la fin de la configuration, le serveur a affiché Continue in your browser et une adresse qui commence par http://127.0.0.1:18789/#bootstrapToken=. Colle cette adresse dans le navigateur de ton ordinateur. Elle arrive au serveur par le tunnel, donc chiffrée. Lors du test, ce passage a répondu {"ok":true,"status":"live"} et servi la page, sans qu'un vrai navigateur l'ouvre.

Cette adresse ne vaut que dix minutes. Passé ce délai, le tableau de bord demande le jeton. Connecte-toi au serveur dans un autre terminal et lance openclaw gateway auth-token --show, puis colle le résultat dans Gateway secret. Tape cette commande toi-même : lors du test, elle n'a répondu qu'à un terminal ouvert par une personne. Elle a refusé de répondre à un programme, comme un agent de code.

Si le tableau de bord demande d'approuver ton navigateur, lance openclaw devices list sur le serveur, relève l'identifiant, puis lance openclaw devices approve <identifiant>.

Pour ne plus ouvrir de tunnel à chaque fois, deux autres chemins existent :

• Tailscale crée un réseau privé entre tes appareils. Il faut un compte Tailscale et ce logiciel sur le serveur comme sur tes appareils. Lance ensuite openclaw config set gateway.tailscale.mode serve. La passerelle reste sur l'adresse locale et seuls tes appareils voient le tableau de bord. C'est le chemin que la documentation préfère pour un accès permanent. Il n'a pas été testé ici.
• Une adresse publique chiffrée (HTTPS) demande un nom de domaine. Le guide d'OVHcloud, classé dans Google France sur « installer openclaw », passe par Docker et Traefik, un logiciel qui reçoit le trafic et gère le chiffrement. C'est plus de travail et le tableau de bord devient joignable depuis Internet, protégé par son jeton.

N'ouvre jamais le port 18789 directement. Le tutoriel de Hostinger, relu le 4 novembre 2026, indique pourtant http://your-vps-ip:18789 et, en cas de blocage, sudo ufw allow 18789/tcp. La documentation d'OpenClaw dit l'inverse : « N'ajoute pas de règle publique pour le port 18789. Le tunnel l'atteint par SSH. » Une adresse publique en http:// envoie en plus ton jeton sans chiffrement : n'importe qui sur le trajet peut le lire.

Le 31 janvier 2026, la société de sécurité Censys comptait 21 639 tableaux de bord OpenClaw joignables depuis Internet, la plupart encore protégés par un jeton. Le tien n'a aucune raison d'en faire partie.

Vérifie ton serveur depuis l'extérieur. Ouvre http://<adresse-du-serveur>:18789 dans le navigateur de ton ordinateur, sans le tunnel : la page ne doit pas s'ouvrir. Pour un contrôle complet, demande à ton agent de code de lancer nmap -sT -p 1-65535 <adresse-du-serveur> --open, qui liste les portes ouvertes. Lors du test, seule la ligne 22/tcp open ssh est apparue, le port 22 étant celui de SSH. Les ports 80 et 443 s'y ajoutent si tu as choisi une adresse publique.

Si tu fais tourner plusieurs agents, d'autres tableaux de bord existent (guide en anglais).

Étape 6 : relier Telegram ou Discord à ton agent

Ton agent travaille maintenant, mais tu ne lui parles que depuis le tableau de bord. La documentation conseille de commencer par Telegram, la messagerie la plus rapide à brancher. Il suffit d'un robot Telegram et de son jeton. Ce robot est un compte de messagerie piloté par un programme. Ce jeton est le mot de passe de ton robot.

1. Crée le robot. Dans Telegram, ouvre une conversation avec @BotFather, le compte officiel qui crée les robots. L'identifiant doit être exactement @BotFather. Envoie /newbot, choisis un nom, puis un identifiant qui finit par bot.
2. Garde son jeton. BotFather te le renvoie dans la conversation. Traite-le comme un mot de passe.
3. Donne-le à OpenClaw. Lance la première commande ci-dessous sur la machine d'OpenClaw, en remplaçant <ton-jeton>. La seconde doit afficher Telegram default: enabled, configured, sans le mot error.

openclaw channels add --channel telegram --token <ton-jeton>
openclaw channels status --probe

Tu peux aussi le demander à ton agent dans le tableau de bord. Antoine Vigneau, qui forme à l'IA sans code, le fait ainsi dans sa vidéo de mars 2026 : il lui demande de configurer Telegram, suit ses explications et lui colle le jeton. Ton jeton passe alors par la conversation, donc chez le fournisseur du modèle : la commande ci-dessus l'évite.

Par défaut, un inconnu qui écrit à ton robot reçoit un code d'appairage et son message n'est pas traité. Ce code sert à relier un compte Telegram à ton agent. Ton propre premier message passe donc par cette étape. Voici un exemple, avec un robot et un code fictifs. Tu écris « Bonjour » à @mon_assistant_bot. Au lieu de répondre, il t'envoie un code de huit caractères, K7QXMPRA. Sur la machine d'OpenClaw :

openclaw pairing list telegram
openclaw pairing approve telegram K7QXMPRA

La première commande montre la demande en attente, la seconde l'approuve. Un code expire au bout d'une heure et trois demandes au plus peuvent attendre en même temps. La première approbation depuis le terminal fait de ton compte le propriétaire de l'installation, celui qui recevra les demandes d'autorisation.

Voici la preuve que c'est fait. Renvoie « Bonjour » : ton agent répond. Si tu as un second compte Telegram, le robot doit lui renvoyer un code et non une réponse : n'approuve pas celui-là. Le test a utilisé un faux jeton. Il confirme donc que la commande enregistre le robot, mais il n'a pas vu d'échange réel avec Telegram.

Les autres messageries demandent un peu plus de travail.

• Discord range tes échanges par salon, un fil de discussion par sujet. Je parle à mes agents sur un serveur Discord privé : il est sur mon téléphone, je suis seul dessus et c'est efficace.
• WhatsApp demande un deuxième numéro. Si tu relies ton WhatsApp personnel, chaque message que tu reçois devient une consigne pour ton agent.

Le guide d'OpenClaw détaille ces messageries. Pour Discord, la documentation donne ces gestes :

1. Crée l'application. Sur le portail développeur de Discord, clique sur New Application.
2. Règle le robot. Sur sa page Bot, active Message Content Intent et copie le jeton avec Reset Token.
3. Invite-le sur ton serveur Discord. Sur sa page OAuth2, coche bot et applications.commands, donne-lui le droit de lire et d'envoyer des messages, puis ouvre l'adresse générée.
4. Autorise les messages privés. Fais un clic droit sur l'icône de ton serveur, ouvre Privacy Settings et active Direct Messages.
5. Donne le jeton à OpenClaw. Lance openclaw channels add --channel discord --token <ton-jeton>, puis approuve le code comme sur Telegram. Lors du test, cette commande a installé l'extension Discord.

Étape 7 : activer le mode prudent

Une installation qui répond ne dit rien de ce que ton agent a le droit de faire. Par défaut, il lance ses commandes sur la machine sans te demander ton accord. La documentation présente ce choix comme voulu quand une seule personne s'en sert.

Le mode prudent change cela. Il laisse passer les commandes de ta liste autorisée, demande ton accord pour les autres et les refuse si personne ne répond. Au départ, ta liste autorisée est vide. Seules quelques commandes sans risque, qui filtrent du texte, passent sans demande.

Ce réglage refuse de s'appliquer tant que la passerelle tourne : le test a obtenu This operation requires exclusive offline state ownership, soit « cette opération demande que la passerelle soit arrêtée ». Il faut donc l'arrêter, changer le réglage, puis la relancer :

openclaw gateway stop
openclaw exec-policy preset cautious
openclaw gateway start
openclaw exec-policy show

Ton agent ne peut pas faire ce réglage depuis une conversation, puisque ton agent dépend de la passerelle qu'il faudrait arrêter. Un agent de code, lui, le peut. Si tu lui confies ces commandes, la première ligne devient openclaw gateway stop --force.

Sans terminal, le même réglage existe dans le tableau de bord, d'après la documentation. Va dans Devices, puis Command approvals. Choisis Defaults. Règle security sur allowlist, ask sur on-miss et askFallback sur deny, puis clique sur Save. C'est le chemin de l'application Mac, de Windows Hub et des offres gérées. Il n'a pas été testé ici.

Voici la preuve que c'est fait. La dernière commande affiche gateway · allowlist · ask on miss · fallback deny, ce qui veut dire : tout ce qui n'est pas dans ta liste attend ton accord et, sans réponse, c'est refusé. Le test l'a confirmé, sauf la relance, qui demande un service.

Demande ensuite à ton agent de créer un fichier dans un dossier de test : il doit attendre ton accord. Le vidéaste d'AI Fire Academy a vu cette demande s'afficher avant la création d'un dossier, sous Windows (septembre 2026).

Cette demande d'accord s'affiche dans le tableau de bord. Une fois ton compte Telegram appairé, elle arrive aussi dans ta conversation privée avec le robot. Tu réponds une fois, toujours ou non. Chaque « toujours » ajoute la commande à ta liste. Sans réponse, la demande expire au bout de 30 minutes. Les tâches programmées sont plus strictes : leurs demandes ne vont qu'au tableau de bord et aux applications OpenClaw. Si aucun n'est ouvert, la commande est refusée sur-le-champ.

Une tâche de nuit s'arrête donc là, sauf si sa commande est dans ta liste. Avant de la programmer, lance-la une fois dans la conversation et réponds « toujours ». Tu peux aussi ajouter une commande à la main, avec son chemin complet, plutôt que de revenir au mode d'origine. uptime, ici, affiche depuis quand la machine tourne.

openclaw approvals allowlist add "/usr/bin/uptime"

L'audit ne remplace pas ce réglage. Sur une configuration Quick start neuve sous Linux, openclaw exec-policy show a affiché auto · full · no approval prompts, soit « aucune demande d'accord ». openclaw security audit, le contrôle de sécurité fourni avec OpenClaw, a pourtant rendu 0 critical · 1 warn · 1 info, sans un mot sur ces commandes lancées sans accord. Un audit sans alerte critique ne veut donc pas dire un agent prudent.

Le CERT-FR liste quatre mesures. Le mode prudent et l'appairage sont déjà faits si tu as suivi ce guide. Les deux autres sont facultatives pour un premier essai : demande à ton agent de code de les mettre en place avant de confier un vrai compte.

Le bac à sable demande Docker sur la machine et une image à construire une fois, avec la commande donnée sur la page « Images and setup » de la documentation. Lance ensuite les deux commandes ci-dessous : la seconde montre où s'exécutent vraiment les commandes. Elle doit afficher mode: all. Le test a seulement vu la valeur d'origine, mode: off.

openclaw config set agents.defaults.sandbox.mode all
openclaw sandbox explain

Mets ces limites dans les réglages, pas dans une consigne à ton agent. Matt Carano le résume ainsi : « les agents trouvent des arguments pour contourner les règles écrites dans leur fichier de personnalité », le fichier texte qui lui dit comment se comporter. Un contrôle technique, lui, ne se négocie pas (octobre 2026). De mon côté, je n'ai jamais donné d'informations personnelles à mon agent : il travaillait sur des données préparées pour lui.

Les compétences à installer et l'injection de prompt, une consigne cachée dans un mail ou une page que le modèle prend pour un ordre, ont leur chapitre dans le guide d'OpenClaw.

Étape 8 : sauvegarder et mettre à jour

OpenClaw sort beaucoup de versions : 85 entre le 12 mars et le 4 novembre 2026, soit environ une tous les trois jours. Tu n'as pas à les suivre toutes, mais ne reste pas trop longtemps en arrière, car elles corrigent aussi des failles. Les mises à jour cassent encore des installations. Chez moi, c'est arrivé sans arrêt et je passais beaucoup de temps à réparer. Entre le 15 septembre et le 27 octobre 2026, plus de 1 300 signalements ouverts sur GitHub parlaient de mise à jour dans leur titre, contre 358 d'installation. C'est le sujet qui revient le plus, même si tous ne décrivent pas une panne.

Avant chaque mise à jour, fais une sauvegarde vérifiée. Le test a produit une archive .tar.gz dans le dossier personnel, en quelques secondes, avec le message Archive verification: passed. Lance ensuite un essai qui décrit ce qui va changer, puis la mise à jour :

openclaw backup create --verify
openclaw update --dry-run
openclaw update

Voici la preuve que c'est fait. openclaw --version affiche le nouveau numéro et ton agent répond à un message. Si tu as installé la série extended-stable, openclaw update y reste : le test a affiché Channel extended-stable.

Si ton agent ne répond plus après une mise à jour, garde cet ordre, donné par la documentation :

1. Lance openclaw doctor --fix. Il corrige ce qu'il sait corriger.
2. Lance openclaw triage. Ce contrôle cherche la panne à ta place et propose de la confier à un agent de code installé sur ta machine.
3. Regarde si tu peux revenir en arrière. openclaw update --tag <version-d-avant> --dry-run te le dit. Lors du test, le retour de 2026.10.10 à 2026.10.9 a été refusé, parce que la structure des données avait changé entre les deux.
4. Reprends ta sauvegarde en dernier recours. openclaw backup restore <ton-archive> --target ~/restauration-openclaw l'extrait dans un nouveau dossier, sans toucher à ton installation.

Il faut ensuite arrêter la passerelle, mettre ce dossier à la place de ~/.openclaw et réinstaller la version d'avant la mise à jour, que l'archive ne contient pas. Demande à ton agent de code de le faire. Lors du test, un réglage changé après la sauvegarde avait bien disparu une fois le dossier remis en place. Tu perds tout ce qui a changé depuis la sauvegarde.

Mets ensuite en balance le temps passé à réparer et le résultat obtenu. Si tu passes tes soirées à remettre OpenClaw en marche pour une tâche que tu ferais aussi vite toi-même, tu n'y gagnes pas.

Ton plan d'action

Toutes les actions de ce guide, dans l'ordre des étapes, à cocher au fur et à mesure.

Quand l'installation d'OpenClaw bloque

Sur le temps, une seule mesure existe ici : une à deux minutes pour le script. La documentation annonce environ cinq minutes jusqu'au premier message. Deux récits de février 2026, avant OpenClaw 2.0, sont plus longs. Le vidéaste EvoluNoob fait de cette installation simplifiée le premier gros progrès de la version 2.0 (septembre 2026, vidéo sponsorisée par Hostinger). Legin82, un fondateur qui a raconté sa semaine sur Hacker News, le forum où beaucoup de programmeurs échangent, parle d'environ trois heures. Nicolas Guyon, formateur en IA et non développeur, y a passé « quelques jours » avec l'aide de Claude Code (podcast Monde Numérique).

Depuis, openclaw triage cherche la panne à ta place. Ce contrôle ne modifie rien. Il écrit un rapport sans tes mots de passe ni tes clés et propose de le confier à un agent de code installé sur ta machine.

Voici les blocages les plus courants, avec leur message.

• curl: command not found avant même le script. Ce programme de téléchargement manque parfois sur un Linux neuf. Lance sudo apt-get install -y curl, puis relance la ligne.
• sudo is required for system installs on Linux. Ta session n'a pas les droits d'administrateur. Prends install-cli.sh, donné plus haut pour ce cas.
• openclaw: command not found juste après l'installation. Le terminal ouvert avant l'installation ne connaît pas encore le nouveau dossier. Ouvre un nouveau terminal. Si rien ne change, colle ce message dans ChatGPT ou Claude, avec le résultat de npm prefix -g.
• La passerelle reste muette pendant les premières minutes. Le premier démarrage peut durer de 4 secondes, lors du test du 4 novembre, à 264 secondes sur un ordinateur Linux de 8 Go le 26 octobre (signalement n° 184773). C'est bien plus sous Windows sans WSL. Attends la fin des questions, puis relance openclaw gateway status.
• Ton agent ne répond pas à ton premier message. Lance openclaw doctor et lis ce qu'il signale. Le plus souvent, l'accès à ton modèle d'IA n'est pas réglé ou ta clé n'a plus de crédit. Relance openclaw onboard pour le refaire.
• Un message parle de ta version de Node ou de node:sqlite. Ton Node est trop ancien pour cette version d'OpenClaw. Relance le script d'installation : sur Node 22, le test l'a vu en installer un plus récent à côté.
• EADDRINUSE ou another gateway instance is already listening. Une autre passerelle occupe déjà le port 18789, souvent celle lancée par Quick start. openclaw gateway status dit laquelle tourne : arrête-la avec openclaw gateway stop.
• npm affiche « install scripts blocked ». Avec npm 12, une installation à la main sans l'option --allow-scripts=openclaw aboutit quand même, mais saute les scripts de préparation d'OpenClaw. La documentation donne npm install -g openclaw@latest --allow-scripts=openclaw, suivi de openclaw onboard --install-daemon.
• PowerShell refuse de lancer openclaw.ps1. Ne change pas le réglage de sécurité de PowerShell. La documentation donne l'autre fichier, posé à côté : & "$env:APPDATA\npm\openclaw.cmd" --version.
• Would refuse update. Tu demandes une version plus ancienne que tes données et elle ne saurait pas les lire. Reste sur ta version, ou repars d'une installation neuve sur la série que tu veux.

Ce que le test couvre et ce qu'il ne couvre pas

Le test date du 4 novembre 2026, sur OpenClaw 2026.10.10. Il a tourné dans des conteneurs Linux jetables (Ubuntu 24.04, processeur ARM, Docker sur un Mac). Il n'a utilisé aucune vraie clé, seulement un faux modèle sur la machine et un réseau limité aux sites de l'installation.

Ces étapes ont été lancées et leurs messages relus :

• Le script, avec son essai sans changement, en administrateur et en utilisateur ordinaire, avec sa durée et l'espace disque qu'il prend.
• Le script avec Node 22, 24.16 et 26.13 déjà présents.
• install-cli.sh sans droits d'administrateur.
• Le parcours du serveur par SSH, entre deux conteneurs : la clé, le nouvel utilisateur et le tunnel.
• La configuration Quick start, écran par écran, jusqu'à Inference ready avec le faux modèle.
• Un message envoyé à la passerelle depuis le terminal, puis la réponse du faux modèle.
• L'état de la passerelle, la mémoire au repos, le mode prudent, la liste autorisée et l'audit de sécurité.
• L'enregistrement d'un robot Telegram et d'un robot Discord avec de faux jetons.
• La sauvegarde, sa remise en place, l'essai de mise à jour et le changement de série.
• La vérification des mises à jour et sa désactivation.
• La désinstallation du programme.

Ces parties viennent de la documentation, sans avoir été testées :

• Tout ce qui concerne le Mac et Windows.
• L'installation du service et enable-linger, car un conteneur n'a pas de gestionnaire de services.
• Un vrai hébergeur, Tailscale et l'ouverture du tableau de bord dans un navigateur.
• Un vrai modèle et un vrai échange sur Telegram ou Discord.
• Le script de préparation Docker, le bac à sable et l'offre de Hostinger.

Ce qu'OpenClaw envoie de lui-même chaque jour

Une fois par jour, OpenClaw demande à telemetry.openclaw.ai s'il existe une nouvelle version. Il envoie sa version, ton système, ta version de Node et ton type de processeur. Le service note en plus une localisation approximative (pays, région, ville, fuseau horaire), conservée trois mois. OpenClaw peut aussi signaler sa présence, sans dire qui tu es, d'après la documentation. Les statistiques facultatives restent désactivées par défaut. Le test l'a confirmé : Feature stats: disabled.

openclaw telemetry off et DO_NOT_TRACK ne coupent pas cette vérification. Pour la couper aussi, lance la commande ci-dessous. openclaw telemetry show affiche alors Request: none. En échange, tu ne seras plus prévenu des nouvelles versions : surveille-les toi-même. Si tu n'as pas de raison particulière, laisse-la active.

openclaw config set update.checkOnStart false

Désinstaller OpenClaw

Commence par regarder ce qui serait supprimé, puis lance la suppression et retire le programme. openclaw uninstall seul ne retirerait que le service, d'où l'option --all :

openclaw uninstall --dry-run --all --yes
openclaw uninstall --all
npm rm -g openclaw

L'essai liste le service, le dossier ~/.openclaw et l'espace de travail de ton agent. La deuxième commande les supprime. Si le service ne peut pas être retiré, elle garde tes données et le dit, comme lors du test dans un conteneur sans service. La troisième retire le programme installé par le script. Node, Git et les outils de compilation installés par le script restent en place.

Sur les autres chemins, ce dernier geste change, d'après la documentation :

• Sur Mac, avec l'application. Mets OpenClaw.app à la corbeille depuis Applications.
• Sous Windows, avec Windows Hub. Son installateur ajoute un raccourci de désinstallation au menu Démarrer.
• Dans une offre gérée. Résilie-la dans l'interface de l'hébergeur.

Voici la preuve que c'est fait. Sur Mac ou sous Linux, dans un nouveau terminal, command -v openclaw n'affiche plus rien.

Si tu ne veux rien installer, les offres gratuites d'agents IA fonctionnent depuis un navigateur. Si ton besoin tient en une tâche répétée, les alternatives à OpenClaw peuvent t'éviter tout ce travail d'administration. Le comparatif Hermes vs OpenClaw montre comment un autre agent règle les mêmes questions.