Passer au contenu principal

​
Installation Nix

Installez OpenClaw de manière déclarative avec nix-openclaw — un module Home Manager tout compris.
Le dépôt nix-openclaw est la source de référence pour l’installation Nix. Cette page n’est qu’un aperçu rapide.

​
Ce que vous obtenez

  • Gateway + application macOS + outils (whisper, spotify, caméras) — tous épinglés
  • Service launchd qui survit aux redémarrages
  • Système de plugins avec configuration déclarative
  • Restauration instantanée : home-manager switch --rollback

​
Démarrage rapide

1

Installer Determinate Nix

Si Nix n’est pas encore installé, suivez les instructions de l’installateur Determinate Nix.
2

Créer un flake local

Utilisez le modèle orienté agent du dépôt nix-openclaw :
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Configurer les secrets

Configurez le jeton de votre bot de messagerie et la clé API de votre fournisseur de modèles. De simples fichiers dans ~/.secrets/ conviennent très bien.
4

Remplir les espaces réservés du modèle puis appliquer

home-manager switch
5

Vérifier

Confirmez que le service launchd est en cours d’exécution et que votre bot répond aux messages.
Consultez le README nix-openclaw pour toutes les options du module et les exemples.

​
Comportement d’exécution du mode Nix

Lorsque OPENCLAW_NIX_MODE=1 est défini (automatique avec nix-openclaw), OpenClaw entre dans un mode déterministe qui désactive les flux d’installation automatique. Vous pouvez aussi le définir manuellement : 
export OPENCLAW_NIX_MODE=1
Sur macOS, l’application GUI n’hérite pas automatiquement des variables d’environnement du shell. Activez plutôt le mode Nix via defaults : 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Ce qui change en mode Nix

  • Les flux d’installation automatique et d’auto-mutation sont désactivés
  • Les dépendances manquantes affichent des messages de remédiation spécifiques à Nix
  • L’interface affiche une bannière de mode Nix en lecture seule

​
Chemins de configuration et d’état

OpenClaw lit la configuration JSON5 depuis OPENCLAW_CONFIG_PATH et stocke les données mutables dans OPENCLAW_STATE_DIR. Lors de l’exécution sous Nix, définissez-les explicitement vers des emplacements gérés par Nix afin que l’état d’exécution et la configuration restent hors du store immuable.
VariableValeur par défaut
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Lié

  • nix-openclaw — guide d’installation complet
  • Wizard — configuration CLI hors Nix
  • Docker — configuration conteneurisée