Aller au contenu
OpenClaw Docs

Install

Install

Section intitulée « Install »

Vous avez déjà suivi Getting Started ? Vous êtes prêt — cette page présente des méthodes d’installation alternatives, des instructions spécifiques à la plate-forme et la maintenance.

System requirements

Section intitulée « System requirements »
  • Node 24 (recommandé) (Node 22 LTS, actuellement 22.16+, est toujours pris en charge pour la compatibilité ; le script d’installation installera Node 24 s’il est manquant)
  • macOS, Linux ou Windows
  • pnpm uniquement si vous compilez à partir du code source

Install methods

Section intitulée « Install methods »

Script d'installation

Télécharge la CLI, l’installe globalement via npm et lance l’onboarding.

Fenêtre de terminal
curl -fsSL https://openclaw.ai/install.sh | bash

C’est tout — le script gère la détection de Node, l’installation et l’onboarding.

Pour ignorer l’onboarding et simplement installer le binaire :

Fenêtre de terminal
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Pour tous les drapeaux, les env vars et les options CI/automatisation, consultez Installer internals.

npm / pnpm

Si vous gérez déjà Node vous-même, nous recommandons Node 24. OpenClaw prend toujours en charge Node 22 LTS, actuellement 22.16+, pour la compatibilité :

Fenêtre de terminal
npm install -g openclaw@latest
openclaw onboard --install-daemon
sharp build errors?

Si vous avez libvips installé globalement (courant sur macOS via Homebrew) et que sharp échoue, forcez les binaires préconstruits :

Fenêtre de terminal
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Si vous voyez sharp: Please add node-gyp to your dependencies, installez soit les outils de compilation (macOS : Xcode CLT + npm install -g node-gyp) soit utilisez la env var ci-dessus.

Vous voulez la tête actuelle main de GitHub avec une installation via gestionnaire de paquets ?

Fenêtre de terminal
npm install -g github:openclaw/openclaw#main
Fenêtre de terminal
pnpm add -g github:openclaw/openclaw#main
From source

Pour les contributeurs ou toute personne souhaitant exécuter à partir d’une extraction locale.

  1. Clone and build

    Clonez le dépôt OpenClaw et construisez :

    Fenêtre de terminal
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build

  2. Link the CLI

    Rendez la commande openclaw disponible globalement :

    Fenêtre de terminal
    pnpm link --global

    Alternativement, sautez le lien et exécutez les commandes via pnpm openclaw ... depuis l’intérieur du dépôt.

  3. Run onboarding

    Fenêtre de terminal
    openclaw onboard --install-daemon

Pour des flux de travail de développement plus approfondis, voir Setup.

Autres méthodes d’installation

Section intitulée « Autres méthodes d’installation »
Docker

Déploiements conteneurisés ou sans interface.

Podman

Conteneur sans racine : exécutez setup-podman.sh une fois, puis le script de lancement.

Nix

Installation déclarative via Nix.

Ansible

Approvisionnement automatisé de flotte.

Bun

Utilisation en CLI uniquement via le runtime Bun.

Après l’installation

Section intitulée « Après l’installation »

Vérifiez que tout fonctionne :

Fenêtre de terminal
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

Si vous avez besoin de chemins d’exécution personnalisés, utilisez :

  • OPENCLAW_HOME pour les chemins internes basés sur le répertoire personnel
  • OPENCLAW_STATE_DIR pour l’emplacement de l’état mutable
  • OPENCLAW_CONFIG_PATH pour l’emplacement du fichier de configuration

Voir Variables d’environnement pour la priorité et les détails complets.

Dépannage : openclaw introuvable

Section intitulée « Dépannage : openclaw introuvable »
Diagnostic et correction du PATH

Diagnostic rapide :

Fenêtre de terminal
node -v
npm -v
npm prefix -g
echo "$PATH"

Si $(npm prefix -g)/bin (macOS/Linux) ou $(npm prefix -g) (Windows) n’est pas dans votre $PATH, votre shell ne peut pas trouver les binaires globaux npm (y compris openclaw).

Correction — ajoutez-le à votre fichier de démarrage de shell (~/.zshrc ou ~/.bashrc) :

Fenêtre de terminal
export PATH="$(npm prefix -g)/bin:$PATH"

Sur Windows, ajoutez la sortie de npm prefix -g à votre PATH.

Ensuite, ouvrez un nouveau terminal (ou rehash dans zsh / hash -r dans bash).

Mise à jour / désinstallation

Section intitulée « Mise à jour / désinstallation »
Updating

Gardez OpenClaw à jour.

Migrating

Passer à une nouvelle machine.

Uninstall

Désinstaller OpenClaw complètement.