Containers
Nix
Installeer OpenClaw declaratief met nix-openclaw, de officiële, compleet uitgeruste Home Manager-module.
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
Determinate Nix installeren
Als Nix nog niet is geïnstalleerd, volg je de instructies van het Determinate Nix-installatieprogramma.
Een lokale flake maken
Gebruik de agentgerichte sjabloon uit de nix-openclaw-repository:
mkdir -p ~/code/openclaw-local# Kopieer templates/agent-first/flake.nix uit de nix-openclaw-repositoryGeheimen configureren
Stel het token van je berichtenbot en de API-sleutel van de modelprovider in. Platte bestanden op ~/.secrets/ werken prima.
De tijdelijke aanduidingen in de sjabloon invullen en overschakelen
home-manager switchVerifië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:
export OPENCLAW_NIX_MODE=1Op macOS neemt de GUI-app geen omgevingsvariabelen van de shell over. Schakel de Nix-modus in plaats daarvan in via defaults:
defaults write ai.openclaw.mac openclaw.nixMode -bool trueWat er verandert in de Nix-modus
- Automatische installatie en zelfwijzigingsprocessen zijn uitgeschakeld.
openclaw.jsonwordt als onveranderlijk behandeld. Bij het opstarten afgeleide standaardwaarden blijven uitsluitend tijdens runtime beschikbaar en configuratieschrijvers (installatie, onboarding, wijzigendeopenclaw 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.configofinstances.<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.
| Variabele | Standaardwaarde |
|---|---|
OPENCLAW_HOME |
HOME / USERPROFILE / os.homedir() |
OPENCLAW_STATE_DIR |
~/.openclaw |
OPENCLAW_CONFIG_PATH |
$OPENCLAW_STATE_DIR/openclaw.json |
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_PROFILESis 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_PROFILESniet is ingesteld, wordt~/.nix-profile/binals terugvaloptie toegevoegd.
Dit geldt voor zowel macOS-launchd- als Linux-systemd-serviceomgevingen.
