Skip to main content
Installieren Sie OpenClaw deklarativ mit nix-openclaw, dem offiziellen Home-Manager-Modul mit Komplettausstattung.
Das Repository nix-openclaw ist die maßgebliche Quelle für die Nix-Installation. Diese Seite bietet einen kurzen Überblick.

​
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

1

Determinate Nix installieren

Falls Nix noch nicht installiert ist, folgen Sie den Anweisungen des Determinate-Nix-Installationsprogramms.
2

Lokalen Flake erstellen

Verwenden Sie die auf Agenten ausgerichtete Vorlage aus dem nix-openclaw-Repository:
3

Geheimnisse konfigurieren

Richten Sie das Token Ihres Messaging-Bots und den API-Schlüssel des Modell-Providers ein. Einfache Dateien unter ~/.secrets/ sind ausreichend.
4

Platzhalter der Vorlage ausfüllen und Konfiguration aktivieren

5

Überprüfen

Vergewissern Sie sich, dass der Launchd-Dienst ausgeführt wird und Ihr Bot auf Nachrichten antwortet.
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:
Unter macOS übernimmt die GUI-App keine Shell-Umgebungsvariablen. Aktivieren Sie den Nix-Modus stattdessen über defaults:

​
Ä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

nix-openclaw

Maßgebliches Home-Manager-Modul und vollständige Einrichtungsanleitung.

Einrichtungsassistent

Schritt-für-Schritt-Anleitung für die CLI-Einrichtung ohne Nix.

Docker

Containerisierte Einrichtung als Alternative ohne Nix.

Aktualisierung

Aktualisierung von durch Home Manager verwalteten Installationen zusammen mit dem Paket.