Passer au contenu principal

​
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.) : 
I want to set up nix-openclaw on my Mac.
Repository: github:openclaw/nix-openclaw

What I need you to do:
1. Check if Determinate Nix is installed (if not, install it)
2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine
5. Fill in the template placeholders and run home-manager switch
6. Verify: launchd running, bot responds to messages

Reference the nix-openclaw README for module options.
📦 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 : 
OPENCLAW_NIX_MODE=1
Sur macOS, l’application GUI n’herite pas automatiquement des variables d’environnement du shell. Vous pouvez egalement activer le mode Nix via defaults : 
defaults write bot.molt.mac openclaw.nixMode -bool true

​
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 : 
apps/macos/Sources/OpenClaw/Resources/Info.plist
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