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

Installatieoverzicht

Andere installatiemethoden

Onderhoud

Hosting en implementatie

Geavanceerd

Nix

Nix-installatie

Snelle start

Wat je krijgt

Runtime-gedrag in Nix-modus

Config- en staatspaden

Runtime-gedrag in Nix-modus

Packaging-opmerking (macOS)

Gerelateerd

​Nix-installatie

​Snelle start

​Wat je krijgt

​Runtime-gedrag in Nix-modus

​Config- en staatspaden

​Runtime-gedrag in Nix-modus

​Packaging-opmerking (macOS)

​Gerelateerd

Nix-installatie

Snelle start

Wat je krijgt

Runtime-gedrag in Nix-modus

Config- en staatspaden

Runtime-gedrag in Nix-modus

Packaging-opmerking (macOS)

Gerelateerd