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.

Houd OpenClaw up-to-date.

​
Aanbevolen: openclaw update

De snelste manier om bij te werken. Het detecteert je installatietype (npm of git), haalt de nieuwste versie op, voert openclaw doctor uit en herstart de Gateway. 
openclaw update
Om van kanaal te wisselen of een specifieke versie te kiezen: 
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # voorbeeldweergave zonder toe te passen
openclaw update accepteert geen --verbose. Gebruik voor updatediagnostiek --dry-run om de geplande acties vooraf te bekijken, --json voor gestructureerde resultaten, of openclaw update status --json om de kanaal- en beschikbaarheidsstatus te inspecteren. Het installatieprogramma heeft een eigen --verbose-vlag, maar die vlag maakt geen deel uit van openclaw update. --channel beta geeft de voorkeur aan beta, maar de runtime valt terug op stable/latest wanneer de beta-tag ontbreekt of ouder is dan de nieuwste stabiele release. Gebruik --tag beta als je de ruwe npm beta dist-tag wilt voor een eenmalige pakketupdate. Zie Ontwikkelingskanalen voor kanaalsemantiek.

​
Wisselen tussen npm- en git-installaties

Gebruik kanalen wanneer je het installatietype wilt wijzigen. De updater behoudt je status, configuratie, referenties en werkruimte in ~/.openclaw; het wijzigt alleen welke OpenClaw-code-installatie de CLI en Gateway gebruiken. 
# npm-pakketinstallatie -> bewerkbare git-checkout
openclaw update --channel dev

# git-checkout -> npm-pakketinstallatie
openclaw update --channel stable
Voer eerst uit met --dry-run om de exacte wissel van installatiemodus vooraf te bekijken: 
openclaw update --channel dev --dry-run
openclaw update --channel stable --dry-run
Het dev-kanaal zorgt voor een git-checkout, bouwt die en installeert de globale CLI vanuit die checkout. De stable- en beta-kanalen gebruiken pakketinstallaties. Als de Gateway al is geinstalleerd, vernieuwt openclaw update de servicemetadata en herstart het de service, tenzij je --no-restart meegeeft.

​
Alternatief: voer het installatieprogramma opnieuw uit

curl -fsSL https://openclaw.ai/install.sh | bash
Voeg --no-onboard toe om onboarding over te slaan. Om een specifiek installatietype via het installatieprogramma af te dwingen, geef je --install-method git --no-onboard of --install-method npm --no-onboard mee. Als openclaw update mislukt na de npm-pakketinstallatiefase, voer dan het installatieprogramma opnieuw uit. Het installatieprogramma roept de oude updater niet aan; het voert de globale pakketinstallatie direct uit en kan een gedeeltelijk bijgewerkte npm-installatie herstellen. 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
Om het herstel vast te zetten op een specifieke versie of dist-tag, voeg je --version toe: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

​
Alternatief: handmatig met npm, pnpm of bun

npm i -g openclaw@latest
Geef de voorkeur aan openclaw update voor beheerde installaties, omdat dit de pakketwissel kan coordineren met de draaiende Gateway-service. Als je handmatig bijwerkt terwijl een beheerde Gateway draait, herstart de Gateway dan onmiddellijk nadat de package manager klaar is, zodat het oude proces niet blijft werken vanuit vervangen pakketbestanden. Wanneer openclaw update een globale npm-installatie beheert, installeert het eerst het doel in een tijdelijke npm-prefix, verifieert het de verpakte dist-inventaris en wisselt het daarna de schone pakketboom naar de echte globale prefix. Dat voorkomt dat npm een nieuw pakket over oude bestanden uit het vorige pakket heen legt. Als de installatieopdracht mislukt, probeert OpenClaw het een keer opnieuw met --omit=optional. Die nieuwe poging helpt hosts waarop native optionele afhankelijkheden niet kunnen compileren, terwijl de oorspronkelijke fout zichtbaar blijft als de fallback ook mislukt. 
pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Geavanceerde npm-installatieonderwerpen

OpenClaw behandelt verpakte globale installaties tijdens runtime als alleen-lezen, zelfs wanneer de globale pakketdirectory beschrijfbaar is voor de huidige gebruiker. Plugin-pakketinstallaties staan in door OpenClaw beheerde npm/git-roots onder de gebruikersconfiguratiedirectory, en het starten van de Gateway wijzigt de OpenClaw-pakketboom niet.Sommige Linux-npm-configuraties installeren globale pakketten onder directories die eigendom zijn van root, zoals /usr/lib/node_modules/openclaw. OpenClaw ondersteunt die indeling omdat Plugin-installatie- en updateopdrachten buiten die globale pakketdirectory schrijven.
Geef OpenClaw schrijftoegang tot zijn configuratie-/statusroots zodat expliciete Plugin-installaties, Plugin-updates en doctor-opruiming hun wijzigingen kunnen bewaren:
ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
Voor pakketupdates en expliciete Plugin-installaties probeert OpenClaw een best-effort schijfruimtecontrole voor het doelvolume. Weinig ruimte levert een waarschuwing op met het gecontroleerde pad, maar blokkeert de update niet, omdat bestandssysteemquota, snapshots en netwerkvolumes na de controle kunnen veranderen. De daadwerkelijke package-manager-installatie en verificatie na installatie blijven gezaghebbend.

​
Auto-updater

De auto-updater staat standaard uit. Schakel deze in via ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
KanaalGedrag
stableWacht stableDelayHours en past daarna toe met deterministische jitter over stableJitterHours (gespreide uitrol).
betaControleert elke betaCheckIntervalHours (standaard: elk uur) en past onmiddellijk toe.
devGeen automatische toepassing. Gebruik openclaw update handmatig.
De Gateway logt ook een updatehint bij het opstarten (uitschakelen met update.checkOnStart: false). Voor downgrade of herstel na een incident stel je OPENCLAW_NO_AUTO_UPDATE=1 in de Gateway-omgeving in om automatische toepassingen te blokkeren, zelfs wanneer update.auto.enabled is geconfigureerd. Updatehints bij het opstarten kunnen nog steeds worden uitgevoerd, tenzij update.checkOnStart ook is uitgeschakeld. Package-manager-updates die via de live Gateway-control-plane-handler worden aangevraagd forceren na de pakketwissel een niet-uitgestelde updateherstart zonder cooldown. Dat voorkomt dat een oud proces in het geheugen lang genoeg blijft bestaan om chunks lazy te laden uit een pakketboom die al is vervangen. Shell openclaw update blijft het voorkeursproces voor beheerde installaties, omdat het de service rond de update kan stoppen en herstarten.

​
Na het bijwerken

1
Voer doctor uit
2
openclaw doctor
3
Migreert configuratie, auditeert DM-beleid en controleert de Gateway-gezondheid. Details: Doctor
4
Herstart de Gateway
5
openclaw gateway restart
6
Verifieer
7
openclaw health

​
Terugdraaien

​
Zet een versie vast (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
npm view openclaw version toont de huidige gepubliceerde versie.

​
Zet een commit vast (broncode)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
Om terug te keren naar de nieuwste versie: git checkout main && git pull.

​
Als je vastzit

  • Voer openclaw doctor opnieuw uit en lees de uitvoer zorgvuldig.
  • Voor openclaw update --channel dev op source-checkouts bootstrap de updater pnpm automatisch wanneer nodig. Als je een pnpm/corepack-bootstrapfout ziet, installeer pnpm dan handmatig (of schakel corepack opnieuw in) en voer de update opnieuw uit.
  • Controleer: Probleemoplossing
  • Vraag het in Discord: https://discord.gg/clawd

​
Gerelateerd