Skip to main content

​
Installation Nix

La methode recommandee pour executer OpenClaw avec Nix est via nix-openclaw — un module Home Manager « tout inclus ».

​
Demarrage rapide

Collez ceci dans votre agent IA (Claude, Cursor, etc.) :
📦 Guide complet : github.com/openclaw/nix-openclaw Le depot nix-openclaw est la source de verite pour l’installation Nix. Cette page n’est qu’un apercu rapide.

​
Ce que vous obtenez

  • Gateway (passerelle) + application macOS + outils (whisper, spotify, cameras) — tous figes
  • Service Launchd qui survit aux redemarrages
  • Systeme de plugins avec configuration declarative
  • Retour en arriere instantane : home-manager switch --rollback

​
Comportement a l’execution en mode Nix

Lorsque OPENCLAW_NIX_MODE=1 est defini (automatique avec nix-openclaw) : OpenClaw prend en charge un mode Nix qui rend la configuration deterministe et desactive les flux d’auto-installation. Activez-le en exportant :
Sur macOS, l’application GUI n’herite pas automatiquement des variables d’environnement du shell. Vous pouvez egalement activer le mode Nix via defaults :

​
Chemins de configuration et d’etat

OpenClaw lit la configuration JSON5 depuis OPENCLAW_CONFIG_PATH et stocke les donnees mutables dans OPENCLAW_STATE_DIR. Si nécessaire, vous pouvez également définir OPENCLAW_HOME pour contrôler le répertoire personnel de base utilisé pour la résolution interne des chemins.
  • OPENCLAW_HOME (priorité par défaut : HOME / USERPROFILE / os.homedir())
  • OPENCLAW_STATE_DIR (par defaut : ~/.openclaw)
  • OPENCLAW_CONFIG_PATH (par defaut : $OPENCLAW_STATE_DIR/openclaw.json)
Lors de l’execution sous Nix, definissez-les explicitement vers des emplacements geres par Nix afin que l’etat d’execution et la configuration restent hors du store immuable.

​
Comportement a l’execution en mode Nix

  • Les flux d’auto-installation et d’auto-mutation sont desactives
  • Les dependances manquantes affichent des messages de remediation specifiques a Nix
  • L’interface affiche une bannière de mode Nix en lecture seule lorsqu’elle est presente

​
Note de packaging (macOS)

Le flux de packaging macOS s’attend a un modele Info.plist stable a l’emplacement :
scripts/package-mac-app.sh copie ce modele dans le bundle de l’application et corrige les champs dynamiques (ID de bundle, version/build, Git SHA, cles Sparkle). Cela permet de conserver un plist deterministe pour le packaging SwiftPM et les builds Nix (qui ne s’appuient pas sur une chaine d’outils Xcode complete).

​
Associe