Aperçu de l'installation

Installation

Vous avez déjà suivi le Guide de démarrage ? Tout est prêt — cette page est dédiée aux méthodes d'installation alternatives, aux instructions spécifiques aux plateformes et à la maintenance.

Configuration système requise

ℹ️ Sur Windows, nous recommandons fortement d'exécuter OpenClaw sous WSL2.

Méthodes d'installation

💡 Le script d'installation est la méthode recommandée pour installer OpenClaw. Il gère la détection de Node, l'installation et l'intégration en une seule étape.

⚠️ Pour les hébergements VPS/cloud, évitez autant que possible les images "1-clic" des marketplaces tiers. Préférez une image de base propre du système d'exploitation (par exemple Ubuntu LTS), puis installez OpenClaw vous-même avec le script d'installation.

Autres méthodes d'installation

Docker

Déploiements conteneurisés ou sans interface.

Podman

Conteneur sans privilèges root : exécutez setup-podman.sh une fois, puis le script de lancement.

Nix

Installation déclarative via Nix.

Ansible

Provisionnement automatisé de parc.

Bun

Utilisation CLI uniquement via le runtime Bun.

Après l'installation

Vérifiez que tout fonctionne :

openclaw doctor         # vérifier les problèmes de configuration
openclaw status         # état de la passerelle
openclaw dashboard      # ouvrir l'interface utilisateur dans le navigateur

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 des données modifiables
  • OPENCLAW_CONFIG_PATH pour l'emplacement du fichier de configuration

Consultez Variables d'environnement pour l'ordre de priorité et les détails complets.

Dépannage : openclaw introuvable

Mise à jour / Désinstallation

Mise à jour

Maintenez OpenClaw à jour.

Migration

Déplacez vers une nouvelle machine.

Désinstaller

Supprimez OpenClaw complètement.

Fonctionnement interne de l'installateur