Skip to main content
Installeer OpenClaw declaratief met nix-openclaw, de officiële, compleet uitgeruste Home Manager-module.
De nix-openclaw-repository is de gezaghebbende bron voor Nix-installatie. Deze pagina biedt een kort overzicht.

​
Wat je krijgt

  • Gateway + macOS-app + hulpmiddelen (whisper, spotify, camera’s), allemaal vastgezet
  • Launchd-service die herstarts overleeft
  • Plugin-systeem met declaratieve configuratie
  • Direct terugdraaien: home-manager switch --rollback

​
Snel aan de slag

1

Determinate Nix installeren

Als Nix nog niet is geïnstalleerd, volg je de instructies van het Determinate Nix-installatieprogramma.
2

Een lokale flake maken

Gebruik de agentgerichte sjabloon uit de nix-openclaw-repository:
3

Geheimen configureren

Stel het token van je berichtenbot en de API-sleutel van de modelprovider in. Platte bestanden op ~/.secrets/ werken prima.
4

De tijdelijke aanduidingen in de sjabloon invullen en overschakelen

5

Verifiëren

Controleer of de launchd-service actief is en je bot op berichten reageert.
Raadpleeg de README van nix-openclaw voor alle moduleopties en voorbeelden.

​
Runtimegedrag in Nix-modus

Wanneer OPENCLAW_NIX_MODE=1 is ingesteld (automatisch met nix-openclaw), schakelt OpenClaw over naar een deterministische modus voor door Nix beheerde installaties. Andere Nix-pakketten kunnen dezelfde modus instellen; nix-openclaw is de officiële referentie. Je kunt deze ook handmatig instellen:
Op macOS neemt de GUI-app geen omgevingsvariabelen van de shell over. Schakel de Nix-modus in plaats daarvan in via defaults:

​
Wat er verandert in de Nix-modus

  • Automatische installatie en zelfwijzigingsprocessen zijn uitgeschakeld.
  • openclaw.json wordt als onveranderlijk behandeld. Bij het opstarten afgeleide standaardwaarden blijven uitsluitend tijdens runtime beschikbaar en configuratieschrijvers (installatie, onboarding, wijzigende openclaw update, installeren/bijwerken/verwijderen/inschakelen van Plugins, doctor --fix, doctor --generate-gateway-token, openclaw config set) weigeren het bestand te bewerken.
  • Bewerk in plaats daarvan de Nix-bron. Gebruik voor nix-openclaw de agentgerichte Snelstartgids en stel de configuratie in onder programs.openclaw.config of instances.<name>.config.
  • Bij ontbrekende afhankelijkheden worden Nix-specifieke herstelberichten weergegeven.
  • De gebruikersinterface toont een alleen-lezenbanner voor de Nix-modus.

​
Paden voor configuratie en status

OpenClaw leest JSON5-configuratie uit OPENCLAW_CONFIG_PATH en slaat wijzigbare gegevens op in OPENCLAW_STATE_DIR. Stel deze onder Nix expliciet in op door Nix beheerde locaties, zodat runtimestatus en configuratie buiten de onveranderlijke store blijven.

​
PATH-detectie voor services

De launchd/systemd-Gateway-service detecteert automatisch binaire bestanden in Nix-profielen, zodat Plugins en hulpmiddelen die via de shell door nix geïnstalleerde uitvoerbare bestanden aanroepen zonder handmatige PATH-configuratie werken:
  • Wanneer NIX_PROFILES is ingesteld, wordt elk item van rechts naar links volgens de voorrangsvolgorde toegevoegd aan het PATH van de service (overeenkomstig de voorrangsvolgorde van de Nix-shell: het meest rechtse item heeft voorrang).
  • Wanneer NIX_PROFILES niet is ingesteld, wordt ~/.nix-profile/bin als terugvaloptie toegevoegd.
Dit geldt voor zowel macOS-launchd- als Linux-systemd-serviceomgevingen.

​
Gerelateerd

nix-openclaw

Gezaghebbende Home Manager-module en volledige installatiegids.

Installatiewizard

Stapsgewijze configuratie via de CLI zonder Nix.

Docker

Gecontaineriseerde installatie als alternatief zonder Nix.

Bijwerken

Door Home Manager beheerde installaties samen met het pakket bijwerken.