Naar hoofdinhoud gaan

Documentation Index

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

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

Installeer OpenClaw declaratief met nix-openclaw - de first-party Home Manager-module met alles inbegrepen.
De nix-openclaw-repo is de bron van waarheid voor Nix-installatie. Deze pagina is een kort overzicht.

​
Wat je krijgt

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

​
Snelstart

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-repo:
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Configureer geheimen

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

Vul template-placeholders in en schakel over

home-manager switch
5

Verifieer

Controleer of de launchd-service draait en 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 voor door Nix beheerde installaties. Andere Nix-pakketten kunnen dezelfde modus instellen; nix-openclaw is de first-party referentie. Je kunt dit ook handmatig instellen: 
export OPENCLAW_NIX_MODE=1
Op macOS neemt de GUI-app shell-omgevingsvariabelen niet automatisch over. Schakel Nix-modus in plaats daarvan via defaults in: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Wat verandert in Nix-modus

  • Flows voor automatisch installeren en zelfmutatie zijn uitgeschakeld
  • openclaw.json wordt als onveranderlijk behandeld. Bij het opstarten afgeleide standaardwaarden blijven alleen runtimewaarden, en config-schrijvers zoals setup, onboarding, muterende openclaw update, Plugin installeren/bijwerken/verwijderen/inschakelen, doctor --fix, doctor --generate-gateway-token en openclaw config set weigeren het bestand te bewerken.
  • Agents moeten in plaats daarvan de Nix-bron bewerken. Gebruik voor nix-openclaw de agent-first Snelstart en stel configuratie in onder programs.openclaw.config of instances.<name>.config.
  • Ontbrekende afhankelijkheden tonen Nix-specifieke herstelberichten
  • De UI toont een alleen-lezen banner voor Nix-modus

​
Configuratie- en statuspaden

OpenClaw leest JSON5-configuratie uit OPENCLAW_CONFIG_PATH en slaat muteerbare data op in OPENCLAW_STATE_DIR. Stel deze bij gebruik onder Nix 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-configuratie:
  • Wanneer NIX_PROFILES is ingesteld, wordt elke entry toegevoegd aan de service-PATH met voorrang van rechts naar links (komt overeen met Nix-shellvoorrang - de meest rechtse 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

Bron-van-waarheid Home Manager-module en volledige setupgids.

Setupwizard

Niet-Nix CLI-setupwalkthrough.

Docker

Gecontaineriseerde setup als niet-Nix alternatief.

Bijwerken

Door Home Manager beheerde installaties bijwerken naast het pakket.