Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Installeer OpenClaw declaratief met nix-openclaw — een complete Home Manager-module.
De nix-openclaw-repository is de leidende bron voor Nix-installatie. Deze pagina is een kort overzicht.

​
Wat je krijgt

  • Gateway + macOS-app + tools (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

Installeer Determinate Nix

Als Nix nog niet is geïnstalleerd, volg dan de instructies van de Determinate Nix installer.
2

Maak een lokale flake

Gebruik de agent-first-template uit de nix-openclaw-repository:
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Configureer secrets

Stel je messaging-bottoken en API-sleutel voor de modelprovider in. Gewone bestanden in ~/.secrets/ werken prima.
4

Vul de tijdelijke aanduidingen in de template in en schakel over

home-manager switch
5

Verifieer

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

​
Runtimegedrag in Nix-modus

Wanneer OPENCLAW_NIX_MODE=1 is ingesteld (automatisch met nix-openclaw), gaat OpenClaw naar een deterministische modus waarin automatische installatiestromen zijn uitgeschakeld. Je kunt dit ook handmatig instellen: 
export OPENCLAW_NIX_MODE=1
Op macOS erft de GUI-app niet automatisch shell-omgevingsvariabelen. Schakel de Nix-modus daarom in via defaults: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Wat verandert er in Nix-modus

  • Automatische installatie en zelfmuterende stromen zijn uitgeschakeld
  • Ontbrekende afhankelijkheden tonen Nix-specifieke herstelmeldingen
  • De UI toont een alleen-lezen banner voor Nix-modus

​
Configuratie- en statuspaden

OpenClaw leest JSON5-configuratie uit OPENCLAW_CONFIG_PATH en slaat veranderlijke gegevens op in OPENCLAW_STATE_DIR. Wanneer je onder Nix draait, stel je deze expliciet in op door Nix beheerde locaties zodat runtimestatus en configuratie buiten de onveranderlijke store blijven.
VariabeleStandaard
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Service-PATH-detectie

De launchd/systemd Gateway-service detecteert Nix-profielbinaries automatisch, zodat plugins en tools die shellen naar met nix geïnstalleerde uitvoerbare bestanden werken zonder handmatige PATH-instelling:
  • Wanneer NIX_PROFILES is ingesteld, wordt elke entry toegevoegd aan de service-PATH met voorrang van rechts naar links (komt overeen met de voorrang van Nix-shell — meest rechts wint).
  • Wanneer NIX_PROFILES niet is ingesteld, wordt ~/.nix-profile/bin als fallback toegevoegd.
Dit geldt voor zowel macOS launchd- als Linux systemd-serviceomgevingen.

​
Gerelateerd

  • nix-openclaw — volledige installatiehandleiding
  • Wizard — niet-Nix CLI-installatie
  • Docker — gecontaineriseerde installatie