Bijwerken

Houd OpenClaw up-to-date.

Zie voor het vervangen van Docker-, Podman- en Kubernetes-images Container-images upgraden. De Gateway voert vóór de gereedheidscontrole upgradebewerkingen uit die veilig zijn tijdens het opstarten en wordt afgesloten als gekoppelde status handmatig moet worden hersteld.

Aanbevolen: openclaw update

Detecteert je installatietype (npm of git), haalt de nieuwste versie op, voert openclaw doctor uit en herstart de Gateway.

openclaw update

Wissel van kanaal of kies een specifieke versie:

openclaw update --channel betaopenclaw update --channel extended-stableopenclaw update --channel devopenclaw update --dry-run   # voorbeeldweergave zonder wijzigingen toe te passen

openclaw update heeft geen vlag --verbose (het installatieprogramma wel). Gebruik voor diagnostiek --dry-run om geplande acties vooraf te bekijken, --json voor gestructureerde resultaten of openclaw update status --json om de status van het kanaal en de beschikbaarheid te controleren.

--channel beta geeft de voorkeur aan de npm-dist-tag beta, maar valt terug op stable/latest wanneer de beta-tag ontbreekt of de versie ervan ouder is dan de nieuwste stabiele release. Gebruik in plaats daarvan --tag beta voor een eenmalige pakketupdate die is vastgezet op de onbewerkte npm- dist-tag beta.

--channel extended-stable werkt alleen met pakketten en de installatie blijft uitsluitend op de voorgrond plaatsvinden. OpenClaw leest de openbare npm-selector extended-stable, verifieert het exact geselecteerde pakket en installeert precies die versie. Ontbrekende of inconsistente registergegevens leiden tot een veilige fout; er wordt nooit teruggevallen op latest. Als de geselecteerde versie ouder is dan de geïnstalleerde versie, blijft de normale bevestiging voor downgraden van toepassing. De CLI slaat het kanaal op na een geslaagde update van de kern; een rechtstreekse npm install -g openclaw@extended-stable werkt update.channel niet bij. Na het vervangen van de kern worden geschikte officiële npm-plugins met een ongespecificeerde/standaardintentie of latest-intentie afgestemd op exact die kernversie. Exact vastgezette versies en expliciete andere tags dan latest, plugins van derden en bronnen die niet van npm afkomstig zijn, blijven ongewijzigd. Catalogusinstallaties die door huidige OpenClaw-versies zijn aangemaakt, behouden die standaard- intentie. Oudere records die alleen een exacte versie bevatten, blijven vastgezet omdat OpenClaw niet veilig onderscheid kan maken tussen een oude automatische vastzetting en een vastzetting door een gebruiker; voer eenmalig openclaw plugins update @openclaw/name uit op het extended-stable-kanaal om die plugin opnieuw exacte kernversies te laten volgen.

--channel dev biedt een permanente, bewegende GitHub-check-out van main. Voor een eenmalige pakketupdate wordt --tag main omgezet naar de pakketspecificatie github:openclaw/openclaw#main en rechtstreeks geïnstalleerd via het gekozen pakketbeheer (npm/pnpm/bun).

Voor beheerde plugins is een ontbrekende betarelease een waarschuwing en geen fout: de kernupdate kan nog steeds slagen terwijl een plugin terugvalt op de geregistreerde standaard-/nieuwste release.

Zie Releasekanalen voor de semantiek van kanalen.

Wisselen tussen npm- en git-installaties

Gebruik kanalen om het installatietype te wijzigen. De updater behoudt je status, configuratie, aanmeldgegevens en werkruimte in ~/.openclaw; alleen de OpenClaw- code-installatie die de CLI en Gateway gebruiken, wordt gewijzigd.

# npm-pakketinstallatie -> bewerkbare git-check-outopenclaw update --channel dev # git-check-out -> npm-pakketinstallatieopenclaw update --channel stable

Bekijk eerst een voorbeeld van de wisseling van installatiemodus:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

dev zorgt voor een git-check-out, bouwt deze en installeert de globale CLI vanuit die check-out. De kanalen stable, extended-stable en beta gebruiken pakket- installaties. Extended-stable wordt bij een git-check-out geweigerd zonder deze te wijzigen of te converteren. Als de Gateway al is geïnstalleerd, vernieuwt openclaw update de servicemetadata en herstart de service, tenzij je --no-restart doorgeeft.

Voor pakketinstallaties met een beheerde Gateway-service richt openclaw update zich op de pakketroot die door die service wordt gebruikt. Als de shellopdracht openclaw uit een andere installatie afkomstig is, toont de updater beide roots en het Node-pad van de beheerde service, en controleert de Node-versie aan de hand van de engines.node-vereiste van de doelrelease voordat het pakket wordt vervangen.

Alternatief: voer het installatieprogramma opnieuw uit

curl -fsSL https://openclaw.ai/install.sh | bash

Voeg --no-onboard toe om de onboarding over te slaan. Geef --install-method git --no-onboard of --install-method npm --no-onboard door om een specifiek installatietype af te dwingen.

Als openclaw update mislukt na de installatiefase van het npm-pakket, voer dan het installatieprogramma opnieuw uit. Dit roept de updater niet aan; het voert de globale pakket- installatie rechtstreeks uit en kan een gedeeltelijk bijgewerkte npm-installatie herstellen.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Zet het herstel met --version vast op een specifieke versie of dist-tag:

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 installaties onder servicebeheer: hiermee kan het vervangen van het pakket worden gecoördineerd met de actieve Gateway-service. Als je een installatie onder servicebeheer handmatig bijwerkt, stop dan eerst de beheerde Gateway. Pakketbeheerders vervangen bestanden ter plaatse, waardoor een actieve Gateway anders kan proberen kern- of pluginbestanden te laden terwijl de vervanging bezig is. Herstart de Gateway nadat het pakketbeheer is voltooid, zodat de nieuwe installatie wordt geladen.

Als openclaw update bij een globale Linux-systeeminstallatie die eigendom is van root mislukt met EACCES, herstel dan met de npm van het systeem terwijl de Gateway gestopt blijft voor de handmatige vervanging. Gebruik dezelfde profielvlaggen/-omgeving die je normaal voor die Gateway gebruikt. Vervang /usr/bin/npm door de systeem-npm die eigenaar is van het globale rootprefix op je host:

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

Verifieer daarna:

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

Wanneer openclaw update een globale npm-installatie beheert, installeert het eerst het doel in een tijdelijk npm-prefix, verifieert het de verpakte dist-inventaris en verwisselt het vervolgens de schone pakketstructuur met het werkelijke globale prefix — zodat npm geen nieuw pakket over verouderde bestanden van het oude pakket heen legt. Als de installatie- opdracht mislukt, probeert OpenClaw het eenmaal opnieuw met --omit=optional, wat helpt op hosts waar optionele native afhankelijkheden niet kunnen worden gecompileerd.

Door OpenClaw beheerde npm-update- en pluginupdate-opdrachten wissen ook de min-release-age-quarantaine voor de toeleveringsketen van npm (of de oudere configuratiesleutel before) voor het onderliggende npm-proces. Dat beleid bestaat voor algemene bescherming, maar een expliciete OpenClaw-update betekent: "installeer de geselecteerde release nu."

pnpm add -g openclaw@latest

bun add -g openclaw@latest

Geavanceerde onderwerpen voor npm-installaties

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Automatische updater

Standaard uitgeschakeld. Schakel deze in via ~/.openclaw/openclaw.json:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

De Gateway registreert bij het opstarten ook een updatehint (schakel dit uit met update.checkOnStart: false). Opgeslagen extended-stable-selecties gebruiken dit alleen-lezen hintpad en het bestaande hintinterval van 24 uur, maar roepen nooit automatische installatie, overdracht, herstart, stabiele vertraging/spreiding of betacontrole aan. Stel voor een downgrade of herstel na een incident 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.

Updates van pakketbeheer die via het live besturingsvlak van de Gateway (update.run) worden aangevraagd, vervangen de pakketstructuur niet binnen het actieve Gateway- proces. Bij installaties met een beheerde service start de Gateway een losgekoppelde overdracht, wordt afgesloten en laat het normale CLI-pad openclaw update --yes --json de service stoppen, het pakket vervangen, servicemetadata vernieuwen, herstarten, de Gateway-versie en bereikbaarheid verifiëren en waar mogelijk een geïnstalleerde maar niet-geladen macOS- LaunchAgent herstellen. Als de Gateway die overdracht niet veilig kan uitvoeren, rapporteert update.run een veilige shellopdracht in plaats van het pakketbeheer binnen het proces uit te voeren.

De updatekaart in de zijbalk van de Control UI start dezelfde update.run-stroom. In de ondertekende macOS-app werkt de kaart eerst de app bij via Sparkle; na het opnieuw starten brengt de app de beheerde lokale Gateway naar de overeenkomende versie.

Na het bijwerken

openclaw doctor

openclaw gateway restart

openclaw health

Terugdraaien

Een versie vastzetten (npm)

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Een commit vastzetten (broncode)

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

Om terug te keren naar de nieuwste versie: git checkout main && git pull.

Als je vastloopt

• Voer openclaw doctor opnieuw uit en lees de uitvoer zorgvuldig.
• Voor openclaw update --channel dev bij check-outs van de broncode initialiseert de updater pnpm indien nodig automatisch. Als je een pnpm-/corepack-initialisatiefout ziet, installeer pnpm dan handmatig (of schakel corepack opnieuw in) en voer de update opnieuw uit.
• Raadpleeg: Probleemoplossing
• Vraag het in Discord: https://discord.gg/clawd

Gerelateerd

• Installatieoverzicht: alle installatiemethoden.
• Doctor: statuscontroles na updates.
• Migreren: migratiehandleidingen voor hoofdversies.