Vai al contenuto principale

​
Installazione Nix

Installa OpenClaw in modo dichiarativo con nix-openclaw — un modulo Home Manager completo di tutto.
Il repo nix-openclaw è la fonte di verità per l’installazione Nix. Questa pagina è una panoramica rapida.

​
Cosa ottieni

  • Gateway + app macOS + strumenti (whisper, spotify, fotocamere) — tutto fissato
  • Servizio launchd che sopravvive ai riavvii
  • Sistema di plugin con configurazione dichiarativa
  • Rollback istantaneo: home-manager switch --rollback

​
Avvio rapido

1

Installa Determinate Nix

Se Nix non è già installato, segui le istruzioni del programma di installazione Determinate Nix.
2

Crea un flake locale

Usa il template agent-first dal repo nix-openclaw:
mkdir -p ~/code/openclaw-local
# Copia templates/agent-first/flake.nix dal repo nix-openclaw
3

Configura i secret

Imposta il token del tuo bot di messaggistica e la API key del provider di modelli. I file in chiaro in ~/.secrets/ vanno bene.
4

Compila i placeholder del template ed esegui lo switch

home-manager switch
5

Verifica

Conferma che il servizio launchd sia in esecuzione e che il tuo bot risponda ai messaggi.
Vedi il README di nix-openclaw per tutte le opzioni 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 che disabilita i flussi di installazione automatica. 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-modifica sono disabilitati
  • Le dipendenze mancanti mostrano messaggi di correzione specifici per Nix
  • La UI mostra un banner di modalità Nix in sola lettura

​
Percorsi di configurazione e stato

OpenClaw legge la configurazione JSON5 da OPENCLAW_CONFIG_PATH e memorizza i dati modificabili in OPENCLAW_STATE_DIR. Quando viene eseguito sotto Nix, impostali esplicitamente su percorsi gestiti da Nix in modo che stato runtime e configurazione restino fuori dallo store immutabile.
VariabilePredefinito
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Correlati

  • nix-openclaw — guida completa alla configurazione
  • Wizard — configurazione CLI non Nix
  • Docker — configurazione containerizzata