Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Prérequis système

  • Node 24 (recommandé) ou Node 22.16+ - le script d’installation s’en charge automatiquement
  • macOS, Linux ou Windows - Windows natif et WSL2 sont tous deux pris en charge ; WSL2 est plus stable. Consultez Windows.
  • pnpm est nécessaire uniquement si vous compilez depuis les sources

​
Recommandé : script d’installation

La façon la plus rapide d’installer. Il détecte votre OS, installe Node si nécessaire, installe OpenClaw et lance l’onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Pour installer sans exécuter l’onboarding : 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Pour tous les flags et les options CI/automatisation, consultez Fonctionnement interne de l’installateur.

​
Méthodes d’installation alternatives

​
Installateur à préfixe local (install-cli.sh)

Utilisez ceci lorsque vous souhaitez conserver OpenClaw et Node sous un préfixe local tel que ~/.openclaw, sans dépendre d’une installation système de Node : 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Il prend en charge les installations npm par défaut, ainsi que les installations depuis un checkout git dans le même flux de préfixe. Référence complète : Fonctionnement interne de l’installateur. Déjà installé ? Basculez entre les installations par package et par git avec openclaw update --channel dev et openclaw update --channel stable. Consultez Mise à jour.

​
npm, pnpm ou bun

Si vous gérez déjà Node vous-même : 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Si sharp échoue à cause d’un libvips installé globalement :
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Depuis les sources

Pour les contributeurs ou toute personne souhaitant exécuter depuis un checkout local : 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Ou ignorez le lien et utilisez pnpm openclaw ... depuis l’intérieur du dépôt. Consultez Configuration pour les flux de développement complets.

​
Installer depuis GitHub main

npm install -g github:openclaw/openclaw#main

​
Conteneurs et gestionnaires de packages

Docker

Déploiements conteneurisés ou headless.

Podman

Alternative à Docker avec conteneurs rootless.

Nix

Installation déclarative via une flake Nix.

Ansible

Provisionnement automatisé de parc.

Bun

Utilisation CLI uniquement via l’environnement d’exécution Bun.

​
Vérifier l’installation

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Si vous souhaitez un démarrage géré après l’installation :
  • macOS : LaunchAgent via openclaw onboard --install-daemon ou openclaw gateway install
  • Linux/WSL2 : service utilisateur systemd via les mêmes commandes
  • Windows natif : tâche planifiée en premier, avec un élément de connexion par utilisateur dans le dossier de démarrage comme solution de secours si la création de la tâche est refusée

​
Hébergement et déploiement

Déployez OpenClaw sur un serveur cloud ou un VPS :

VPS

N’importe quel VPS Linux

Docker VM

Étapes Docker partagées

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Mettre à jour, migrer ou désinstaller

Updating

Gardez OpenClaw à jour.

Migrating

Passer à une nouvelle machine.

Uninstall

Supprimer complètement OpenClaw.

​
Dépannage : openclaw introuvable

Si l’installation a réussi mais que openclaw est introuvable dans votre terminal : 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
Si $(npm prefix -g)/bin n’est pas dans votre $PATH, ajoutez-le à votre fichier de démarrage du shell (~/.zshrc ou ~/.bashrc) : 
export PATH="$(npm prefix -g)/bin:$PATH"
Ouvrez ensuite un nouveau terminal. Consultez Configuration de Node pour plus de détails.