Zum Hauptinhalt springen

​
Nix-Installation

Installieren Sie OpenClaw deklarativ mit nix-openclaw — einem Home-Manager-Modul mit allem Nötigen.
Das Repository nix-openclaw ist die maßgebliche Quelle für die Nix-Installation. Diese Seite ist ein kurzer Überblick.

​
Was Sie erhalten

  • Gateway + macOS-App + Tools (whisper, spotify, cameras) — alles fixiert
  • Launchd-Dienst, der Neustarts übersteht
  • Plugin-System mit deklarativer Konfiguration
  • Sofortiges Rollback: home-manager switch --rollback

​
Schnellstart

1

Determinate Nix installieren

Wenn Nix noch nicht installiert ist, folgen Sie den Anweisungen des Determinate Nix installer.
2

Ein lokales Flake erstellen

Verwenden Sie die agent-first-Vorlage aus dem Repository nix-openclaw:
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Geheimnisse konfigurieren

Richten Sie Ihr Messaging-Bot-Token und den API-Schlüssel Ihres Modell-Providers ein. Einfache Dateien unter ~/.secrets/ funktionieren gut.
4

Platzhalter in der Vorlage ausfüllen und umschalten

home-manager switch
5

Überprüfen

Bestätigen Sie, dass der launchd-Dienst läuft und Ihr Bot auf Nachrichten antwortet.
Siehe die nix-openclaw README für vollständige Moduloptionen und Beispiele.

​
Laufzeitverhalten im Nix-Modus

Wenn OPENCLAW_NIX_MODE=1 gesetzt ist (automatisch mit nix-openclaw), wechselt OpenClaw in einen deterministischen Modus, der Auto-Installationsabläufe deaktiviert. Sie können es auch manuell setzen: 
export OPENCLAW_NIX_MODE=1
Unter macOS übernimmt die GUI-App Shell-Umgebungsvariablen nicht automatisch. Aktivieren Sie den Nix-Modus stattdessen über defaults: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Was sich im Nix-Modus ändert

  • Auto-Installations- und Selbstmodifikationsabläufe sind deaktiviert
  • Fehlende Abhängigkeiten zeigen Nix-spezifische Hinweise zur Behebung an
  • Die UI zeigt ein schreibgeschütztes Nix-Modus-Banner an

​
Konfigurations- und Statuspfade

OpenClaw liest JSON5-Konfiguration aus OPENCLAW_CONFIG_PATH und speichert veränderbare Daten in OPENCLAW_STATE_DIR. Beim Ausführen unter Nix sollten Sie diese explizit auf von Nix verwaltete Orte setzen, damit Laufzeitstatus und Konfiguration aus dem unveränderlichen Store herausgehalten werden.
VariableStandard
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Verwandt

  • nix-openclaw — vollständiger Einrichtungsleitfaden
  • Wizard — CLI-Einrichtung ohne Nix
  • Docker — containerisierte Einrichtung