Nix-installatie¶

De aanbevolen manier om OpenClaw met Nix te draaien is via nix-openclaw — een Home Manager-module met alles inbegrepen.

Snelle start¶

Plak dit in je AI-agent (Claude, Cursor, enz.):

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.

📦 Volledige gids: github.com/openclaw/nix-openclaw

De nix-openclaw-repo is de bron van waarheid voor Nix-installatie. Deze pagina is slechts een snel overzicht.

Wat je krijgt¶

• Gateway + macOS-app + tools (whisper, spotify, camera’s) — allemaal vastgepind
• Launchd-service die herstarts overleeft
• Pluginsysteem met declaratieve config
• Directe rollback: home-manager switch --rollback

Runtime-gedrag in Nix-modus¶

Wanneer OPENCLAW_NIX_MODE=1 is ingesteld (automatisch met nix-openclaw):

Ondersteunt OpenClaw een Nix-modus die configuratie deterministisch maakt en auto-installatiestromen uitschakelt. Schakel deze in door te exporteren:

OPENCLAW_NIX_MODE=1

Op macOS neemt de GUI-app shell-omgevingsvariabelen niet automatisch over. Je kunt Nix-modus ook inschakelen via defaults:

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

Config- en staatspaden¶

OpenClaw leest JSON5-configuratie uit OPENCLAW_CONFIG_PATH en slaat muteerbare data op in OPENCLAW_STATE_DIR. Indien nodig kun je ook OPENCLAW_HOME instellen om de basishomemap te bepalen die wordt gebruikt voor interne padresolutie.

• OPENCLAW_HOME (standaardvoorrang: HOME / USERPROFILE / os.homedir())
• OPENCLAW_STATE_DIR (standaard: ~/.openclaw)
• OPENCLAW_CONFIG_PATH (standaard: $OPENCLAW_STATE_DIR/openclaw.json)

Wanneer je onder Nix draait, stel deze expliciet in op door Nix beheerde locaties, zodat runtime-staat en configuratie buiten de onveranderlijke store blijven.

Runtime-gedrag in Nix-modus¶

• Auto-installatie en zelf-mutatiestromen zijn uitgeschakeld
• Ontbrekende afhankelijkheden tonen Nix-specifieke herstelmeldingen
• De UI toont een alleen-lezen Nix-modusbanner wanneer aanwezig

Packaging-opmerking (macOS)¶

De macOS-packagingflow verwacht een stabiel Info.plist-sjabloon op:

apps/macos/Sources/OpenClaw/Resources/Info.plist

scripts/package-mac-app.sh kopieert dit sjabloon naar de app-bundel en past dynamische velden aan (bundle-ID, versie/build, Git SHA, Sparkle-sleutels). Dit houdt de plist deterministisch voor SwiftPM- packaging en Nix-builds (die niet afhankelijk zijn van een volledige Xcode-toolchain).

Gerelateerd¶

• nix-openclaw — volledige installatiegids
• Wizard — niet-Nix CLI-installatie
• Docker — containerized installatie