OpenClaw sur Nix

Les utilisateurs de Nix ont une voie officielle : nix-openclaw, le module Home Manager tout inclus que la documentation appelle la source de vérité pour l’installation Nix, la page de documentation n’étant qu’un aperçu rapide. Voici ce que le module vous donne, le démarrage rapide, ce que le mode Nix change dans OpenClaw une fois l’installation déclarative, où vivent la configuration et l’état, et comment le service trouve les binaires installés par Nix.

Ce que vous obtenez

• La passerelle, l’application macOS et des outils comme whisper, spotify et les caméras, tous épinglés.
• Un service launchd qui survit aux redémarrages, et un système d’extensions avec configuration déclarative.
• Un retour arrière instantané avec un seul basculement Home Manager vers la génération précédente.
• Le démarrage rapide : installer Determinate Nix, copier le gabarit de flake agent-first du dépôt dans un répertoire local, mettre le jeton du bot et la clé du fournisseur de modèles dans des fichiers simples sous votre répertoire de secrets, remplir les espaces réservés, basculer, puis confirmer que le service launchd tourne et que le bot répond.

openclaw.json est traité comme immuable.

Le mode Nix

Quand la variable du mode Nix est définie, automatique avec nix-openclaw, OpenClaw entre dans un mode déterministe pour les installations gérées par Nix. Les flux d’installation automatique et d’automodification sont désactivés. Le fichier de configuration est immuable : les valeurs par défaut dérivées au démarrage restent en mémoire seulement, et chaque écrivain de configuration, la configuration initiale, l’assistant de démarrage, une mise à jour modifiante, l’installation, la mise à jour, la désinstallation ou l’activation d’une extension, la correction et la génération de jeton du docteur, et la commande de définition de configuration, refuse de le modifier ; vous modifiez la source Nix à la place, sous les options de configuration du module. Les dépendances manquantes affichent des messages de remédiation propres à Nix, et l’interface montre une bannière de mode Nix en lecture seule. Sur macOS, l’application graphique n’hérite pas des variables du shell, donc le mode Nix s’active par une écriture de defaults à la place.

Les chemins et le PATH du service

• OpenClaw lit la configuration JSON5 depuis la variable du chemin de configuration et stocke les données modifiables dans le répertoire d’état ; sous Nix, les deux sont définis explicitement vers des emplacements gérés par Nix pour que l’état et la configuration restent hors du magasin immuable.
• Les valeurs par défaut : la variable de dossier personnel retombe sur le dossier de l’utilisateur, le répertoire d’état sur le dossier .openclaw qu’il contient, et le chemin de configuration sur openclaw.json dans le répertoire d’état.
• Le service launchd ou systemd ajoute chaque entrée de la variable des profils Nix à son PATH par priorité de droite à gauche, ou le répertoire bin du profil utilisateur quand la variable est absente, pour que les extensions et outils qui appellent des exécutables installés par Nix fonctionnent sans réglage manuel.

La configuration d’OpenClaw explique le fichier que le mode Nix gèle, et Mettre à jour OpenClaw le chemin de mise à jour d’une installation gérée par Home Manager.

Sans Nix

La même application de configuration immuable existe pour toute configuration gérée de l’extérieur : une variable de configuration en lecture seule l’applique avec des messages génériques et aucun des comportements propres à Nix, ce que la documentation suggère à ceux qui gèrent le fichier avec autre chose que Nix. Installer OpenClaw sur un Mac est l’installation macOS classique et OpenClaw sur Docker l’alternative en conteneur que la page cite.

Sur Diali

Diali applique la même discipline sans le flake : la configuration est générée pour chaque assistant depuis le tableau de bord, validée avant d’être écrite et remplacée à chaque release, si bien que rien ne la modifie sur la machine. OpenClaw hébergé sur Diali est l’assistant.

• Un module Home Manager, épinglé de bout en bout.
• Le mode Nix gèle la configuration et désactive l’automodification.
• Le retour arrière tient en un basculement.