Nix

Installieren Sie OpenClaw deklarativ mit nix-openclaw, dem offiziellen Home-Manager-Modul mit Komplettausstattung.

Funktionsumfang

• Gateway + macOS-App + Tools (Whisper, Spotify, Kameras), alle auf feste Versionen festgelegt
• Launchd-Dienst, der Neustarts übersteht
• Plugin-System mit deklarativer Konfiguration
• Sofortiges Rollback: home-manager switch --rollback

Schnellstart

mkdir -p ~/code/openclaw-local# templates/agent-first/flake.nix aus dem nix-openclaw-Repository kopieren

home-manager switch

Vollständige Moduloptionen und Beispiele finden Sie in der README von nix-openclaw.

Laufzeitverhalten im Nix-Modus

Wenn OPENCLAW_NIX_MODE=1 gesetzt ist (bei nix-openclaw automatisch), wechselt OpenClaw für Nix-verwaltete Installationen in einen deterministischen Modus. Andere Nix-Pakete können denselben Modus festlegen; nix-openclaw ist die offizielle Referenzimplementierung.

Sie können ihn auch manuell festlegen:

export OPENCLAW_NIX_MODE=1

Unter macOS übernimmt die GUI-App keine Shell-Umgebungsvariablen. Aktivieren Sie den Nix-Modus stattdessen über defaults:

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

Änderungen im Nix-Modus

• Abläufe zur automatischen Installation und Selbstmodifikation sind deaktiviert.
• openclaw.json wird als unveränderlich behandelt. Beim Start abgeleitete Standardwerte bleiben ausschließlich zur Laufzeit bestehen, und Konfigurationsschreiber (Einrichtung, Onboarding, verändernde openclaw update, Installation/Aktualisierung/Deinstallation/Aktivierung von Plugins, doctor --fix, doctor --generate-gateway-token, openclaw config set) verweigern die Bearbeitung der Datei.
• Bearbeiten Sie stattdessen die Nix-Quelle. Verwenden Sie für nix-openclaw den auf Agenten ausgerichteten Schnellstart und legen Sie die Konfiguration unter programs.openclaw.config oder instances.<name>.config fest.
• Bei fehlenden Abhängigkeiten werden Nix-spezifische Hinweise zur Behebung angezeigt.
• Die Benutzeroberfläche zeigt ein schreibgeschütztes Banner für den Nix-Modus an.

Konfigurations- und Zustandspfade

OpenClaw liest die JSON5-Konfiguration aus OPENCLAW_CONFIG_PATH und speichert veränderliche Daten in OPENCLAW_STATE_DIR. Legen Sie diese unter Nix explizit auf Nix-verwaltete Speicherorte fest, damit Laufzeitstatus und Konfiguration nicht im unveränderlichen Store gespeichert werden.

PATH-Ermittlung für Dienste

Der Launchd-/systemd-Gateway-Dienst erkennt Binärdateien aus Nix-Profilen automatisch, sodass Plugins und Tools, die über die Shell mit nix installierte ausführbare Dateien aufrufen, ohne manuelle PATH-Konfiguration funktionieren:

• Wenn NIX_PROFILES gesetzt ist, wird jeder Eintrag mit einer Priorität von rechts nach links zum PATH des Dienstes hinzugefügt (entspricht der Priorität der Nix-Shell: Der Eintrag ganz rechts hat Vorrang).
• Wenn NIX_PROFILES nicht gesetzt ist, wird ~/.nix-profile/bin als Ausweichoption hinzugefügt.

Dies gilt sowohl für macOS-Launchd- als auch für Linux-systemd-Dienstumgebungen.

Verwandte Themen