Nix

Installeer OpenClaw declaratief met nix-openclaw - de first-party Home Manager-module met alles inbegrepen.

# Wat je krijgt

• Gateway + macOS-app + tools (whisper, spotify, camera's) -- allemaal vastgepind
• Launchd-service die herstarts overleeft
• Plugin-systeem met declaratieve configuratie
• Direct terugdraaien: home-manager switch --rollback

# Snelstart

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

home-manager switch

Zie de nix-openclaw README voor alle moduleopties en voorbeelden.

# Runtimegedrag in Nix-modus

Wanneer OPENCLAW_NIX_MODE=1 is ingesteld (automatisch met nix-openclaw), gaat OpenClaw naar een deterministische modus voor door Nix beheerde installaties. Andere Nix-pakketten kunnen dezelfde modus instellen; nix-openclaw is de first-party referentie.

Je kunt dit ook handmatig instellen:

export OPENCLAW_NIX_MODE=1

Op macOS neemt de GUI-app shell-omgevingsvariabelen niet automatisch over. Schakel Nix-modus in plaats daarvan via defaults in:

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

# Wat verandert in Nix-modus

• Flows voor automatisch installeren en zelfmutatie zijn uitgeschakeld
• openclaw.json wordt als onveranderlijk behandeld. Bij het opstarten afgeleide standaardwaarden blijven alleen runtimewaarden, en config-schrijvers zoals setup, onboarding, muterende openclaw update, Plugin installeren/bijwerken/verwijderen/inschakelen, doctor --fix, doctor --generate-gateway-token en openclaw config set weigeren het bestand te bewerken.
• Agents moeten in plaats daarvan de Nix-bron bewerken. Gebruik voor nix-openclaw de agent-first Snelstart en stel configuratie in onder programs.openclaw.config of instances.<name>.config.
• Ontbrekende afhankelijkheden tonen Nix-specifieke herstelberichten
• De UI toont een alleen-lezen banner voor Nix-modus

# Configuratie- en statuspaden

OpenClaw leest JSON5-configuratie uit OPENCLAW_CONFIG_PATH en slaat muteerbare data op in OPENCLAW_STATE_DIR. Stel deze bij gebruik onder Nix expliciet in op door Nix beheerde locaties, zodat runtimestatus en configuratie buiten de onveranderlijke store blijven.

# Service-PATH-detectie

De launchd/systemd Gateway-service detecteert Nix-profielbinaries automatisch, zodat plugins en tools die shellen naar met nix geïnstalleerde uitvoerbare bestanden werken zonder handmatige PATH-configuratie:

• Wanneer NIX_PROFILES is ingesteld, wordt elke entry toegevoegd aan de service-PATH met voorrang van rechts naar links (komt overeen met Nix-shellvoorrang - de meest rechtse wint).
• Wanneer NIX_PROFILES niet is ingesteld, wordt ~/.nix-profile/bin als fallback toegevoegd.

Dit geldt voor zowel macOS launchd- als Linux systemd-serviceomgevingen.

# Gerelateerd