OpenClaw mit Nix installieren

Kennst du das Problem? Du hast dein Setup auf einem Rechner perfekt konfiguriert, aber sobald du auf ein anderes Gerät wechselst, fehlen Abhängigkeiten oder Umgebungsvariablen sind falsch gesetzt. Manuelle Installationen führen oft zu einem Zustand, den man kaum reproduzieren kann.

Wenn du eine saubere, deklarative Umgebung bevorzugst, ist Nix die beste Wahl. Mit nix-openclaw erhältst du ein fertiges Home Manager Modul, das die gesamte Komplexität abstrahiert.

Voraussetzungen

Bevor du startest, stelle sicher, dass du folgende Voraussetzungen erfüllst:

• Determinate Nix ist auf deinem System installiert
• Ein lokaler Flake unter ~/code/openclaw-local (basierend auf templates/agent-first/flake.nix)
• Ein Telegram Bot (erstellt via @BotFather) und deine Chat ID (von @userinfobot)
• Hinterlegte Secrets (Bot Token, Anthropic Key) in einfachen Dateien unter ~/.secrets/

Schnellstart

Am schnellsten geht es, wenn du diese Anweisungen direkt an deinen AI Agent (wie Claude oder Cursor) übergibst:

I want to set up nix-openclaw on my Mac.
Repository: github:openclaw/nix-openclaw

What I need you to do:
1. Check if Determinate Nix is installed (if not, install it)
2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine
5. Fill in the template placeholders and run home-manager switch
6. Verify: launchd running, bot responds to messages

Reference the nix-openclaw README for module options.

Mit diesem Setup erhältst du sofort:

• Gateway, macOS App und Tools (Whisper, Spotify, Kameras) in festen Versionen
• Einen Launchd Service, der Neustarts übersteht
• Ein Plugin-System mit deklarativer Konfiguration
• Instant Rollback via home-manager switch --rollback

Nix Mode Runtime Verhalten

Wenn du nix-openclaw nutzt, wird automatisch OPENCLAW_NIX_MODE=1 gesetzt. Dieser Modus sorgt für deterministische Konfigurationen und deaktiviert automatische Installations-Flows.

Du kannst den Modus auch manuell in deiner Shell aktivieren:

export OPENCLAW_NIX_MODE=1

Pfade für Config und State

OpenClaw liest die JSON5-Konfiguration aus OPENCLAW_CONFIG_PATH und speichert veränderliche Daten in OPENCLAW_STATE_DIR. Nutze OPENCLAW_HOME, um das Basisverzeichnis für die interne Pfadauflösung zu steuern.

• OPENCLAW_HOME (Standard: HOME, USERPROFILE oder os.homedir())
• OPENCLAW_STATE_DIR (Standard: ~/.openclaw)
• OPENCLAW_CONFIG_PATH (Standard: $OPENCLAW_STATE_DIR/openclaw.json)

Unter Nix solltest du diese Pfade explizit auf Orte setzen, die nicht im Read-only Nix Store liegen.

Fehlerbehebung

GUI App übernimmt Umgebungsvariablen nicht

Auf macOS erben GUI Apps nicht automatisch die Umgebungsvariablen deiner Shell. Wenn der Nix Mode in der App nicht aktiv ist, nutze diesen Befehl:

defaults write bot.molt.mac openclaw.nixMode -bool true

Fehlende Abhängigkeiten

Im Nix Mode sind Auto-Install-Flows deaktiviert. Sollten Abhängigkeiten fehlen, zeigt OpenClaw spezifische Hinweise zur Behebung unter Nix an. Zudem erscheint ein “Read-only Nix Mode” Banner in der UI.

macOS Packaging

Falls du das Paket selbst baust: Der Packaging-Flow erwartet das Info.plist Template unter apps/macos/Sources/OpenClaw/Resources/Info.plist. Das Skript scripts/package-mac-app.sh patcht dynamische Felder wie die Git SHA oder Versionen, damit der Build auch ohne volle Xcode-Toolchain deterministisch bleibt.

Besuche den AI Setup Assistant für weitere Unterstützung.

Nächste Schritte

• nix-openclaw – Der vollständige Setup-Guide
• Wizard – CLI-Setup ohne Nix
• Docker – Container-basiertes Setup
• Configuration – Alle Optionen im Detail