Containers
Nix
Installeer OpenClaw declaratief met nix-openclaw, de officiële, compleet uitgeruste Home Manager-module.
Wat u krijgt
- Gateway + macOS-app + hulpmiddelen (whisper, spotify, camera's), allemaal vastgezet op specifieke versies
- Launchd-service die na opnieuw opstarten actief blijft
- Pluginsysteem met declaratieve configuratie
- Direct terugdraaien:
home-manager switch --rollback
Snel aan de slag
Determinate Nix installeren
Als Nix nog niet is geïnstalleerd, volgt u de instructies voor 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 uw berichtenbot en de API-sleutel van uw modelprovider in. Gewone bestanden in ~/.secrets/ werken prima.
Sjabloonplaatshouders invullen en overschakelen
home-manager switchVerifiëren
Controleer of de launchd-service actief is en uw 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.
U kunt deze ook handmatig instellen:
export OPENCLAW_NIX_MODE=1Op macOS neemt de GUI-app geen shell-omgevingsvariabelen over. Schakel de Nix-modus daarom 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 van kracht en configuratieschrijvers (installatie, onboarding, wijzigendeopenclaw update, installatie/bijwerking/verwijdering/inschakeling 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 statusgegevens
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 opslag 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-service van de Gateway 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 elke vermelding met prioriteit van rechts naar links aan het service-PATH toegevoegd (overeenkomstig de prioriteit van de Nix-shell: de meest rechtse vermelding wint). - Wanneer
NIX_PROFILESniet is ingesteld, wordt~/.nix-profile/binals terugvaloptie toegevoegd.
Dit geldt voor zowel macOS-launchd- als Linux-systemd-serviceomgevingen.
