Nix

Installa OpenClaw in modo dichiarativo con nix-openclaw, il modulo Home Manager ufficiale con tutto incluso.

# Cosa ottieni

• Gateway + app macOS + strumenti (whisper, spotify, cameras) -- tutti bloccati a versioni specifiche
• Servizio launchd che sopravvive ai riavvii
• Sistema Plugin con configurazione dichiarativa
• Rollback immediato: home-manager switch --rollback

# Avvio rapido

mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo

home-manager switch

Consulta il README di nix-openclaw per le opzioni complete del modulo e gli esempi.

# Comportamento runtime in modalità Nix

Quando OPENCLAW_NIX_MODE=1 è impostato (automatico con nix-openclaw), OpenClaw entra in una modalità deterministica per le installazioni gestite da Nix. Anche altri pacchetti Nix possono impostare la stessa modalità; nix-openclaw è il riferimento ufficiale.

Puoi anche impostarlo manualmente:

export OPENCLAW_NIX_MODE=1

Su macOS, l'app GUI non eredita automaticamente le variabili d'ambiente della shell. Abilita invece la modalità Nix tramite defaults:

defaults write ai.openclaw.mac openclaw.nixMode -bool true

# Cosa cambia in modalità Nix

• I flussi di installazione automatica e auto-mutazione sono disabilitati
• openclaw.json è trattato come immutabile. I valori predefiniti derivati dall'avvio restano solo runtime, e gli strumenti che scrivono la configurazione, come setup, onboarding, openclaw update mutante, installazione/aggiornamento/disinstallazione/abilitazione di Plugin, doctor --fix, doctor --generate-gateway-token e openclaw config set, rifiutano di modificare il file.
• Gli agenti dovrebbero invece modificare la sorgente Nix. Per nix-openclaw, usa l'Avvio rapido agent-first e imposta la configurazione sotto programs.openclaw.config o instances.<name>.config.
• Le dipendenze mancanti mostrano messaggi di correzione specifici per Nix
• L'interfaccia utente mostra un banner di modalità Nix in sola lettura

# Percorsi di configurazione e stato

OpenClaw legge la configurazione JSON5 da OPENCLAW_CONFIG_PATH e archivia i dati mutabili in OPENCLAW_STATE_DIR. Quando è in esecuzione sotto Nix, impostali esplicitamente su posizioni gestite da Nix, così lo stato runtime e la configurazione restano fuori dallo store immutabile.

# Rilevamento del PATH del servizio

Il servizio Gateway launchd/systemd rileva automaticamente i binari del profilo Nix, così i Plugin e gli strumenti che eseguono comandi shell verso eseguibili installati con nix funzionano senza configurazione manuale del PATH:

• Quando NIX_PROFILES è impostato, ogni voce viene aggiunta al PATH del servizio con precedenza da destra a sinistra (corrisponde alla precedenza della shell Nix: vince la voce più a destra).
• Quando NIX_PROFILES non è impostato, ~/.nix-profile/bin viene aggiunto come fallback.

Questo si applica sia agli ambienti di servizio launchd su macOS sia a quelli systemd su Linux.

# Correlati