Nix

Installieren Sie OpenClaw deklarativ mit nix-openclaw, dem offiziellen, vollständig ausgestatteten Home-Manager-Modul.

Enthaltene Komponenten

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

Schnellstart

mkdir -p ~/code/openclaw-local# Vorlage templates/agent-first/flake.nix aus dem Repository nix-openclaw 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 von 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 grafische App keine Umgebungsvariablen der Shell. 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 gelten nur zur Laufzeit, und Konfigurationsschreiber (Einrichtung, Onboarding, veränderndes 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 agentenorientierten Schnellstart und legen Sie die Konfiguration unter programs.openclaw.config oder instances.<name>.config fest.
• Fehlende Abhängigkeiten werden mit Nix-spezifischen Hinweisen zur Behebung gemeldet.
• Die Benutzeroberfläche zeigt ein schreibgeschütztes Banner für den Nix-Modus an.

Pfade für Konfiguration und Zustand

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 von Nix verwaltete Speicherorte fest, damit Laufzeitdaten und Konfiguration nicht im unveränderlichen Store gespeichert werden.

PATH-Ermittlung für Dienste

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

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

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

Verwandte Themen