Aanbevolen: openclaw update
De snelste manier om te updaten. Het detecteert je installatietype (npm of git), haalt de nieuwste versie op, voert openclaw doctor uit en herstart de Gateway.
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.
Gebruik --channel dev voor een permanente, bewegende GitHub main-checkout. Voor pakketupdates
wordt --tag main voor een enkele run gekoppeld aan github:openclaw/openclaw#main, en
GitHub/git-bronspecificaties worden in een tijdelijke tarball verpakt voordat de gefaseerde
npm-installatie plaatsvindt.
Voor beheerde plugins is terugval van het beta-kanaal een waarschuwing: de core-update kan
nog steeds slagen terwijl een plugin de vastgelegde standaard-/nieuwste release gebruikt omdat er geen
plugin-beta beschikbaar is.
Zie Ontwikkelingskanalen voor kanaalsemantiek.
Wisselen tussen npm- en git-installaties
Gebruik kanalen wanneer je het installatietype wilt wijzigen. De updater behoudt je state, config, inloggegevens en workspace in~/.openclaw; hij wijzigt alleen
welke OpenClaw-code-installatie de CLI en Gateway gebruiken.
--dry-run om de exacte installatiemoduswissel vooraf te bekijken:
dev-kanaal zorgt voor een git-checkout, bouwt die en installeert de globale CLI
vanuit die checkout. De kanalen stable en beta gebruiken pakketinstallaties. Als de
Gateway al is geinstalleerd, vernieuwt openclaw update de servicemetadata
en herstart deze, tenzij je --no-restart meegeeft.
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 komt, print de updater beide roots en het Node-pad van de beheerde service. De pakketupdate gebruikt de pakketbeheerder die eigenaar is van de service-root
en controleert de Node van de beheerde service tegen de engine van de doelrelease
voordat het pakket wordt vervangen.
Alternatief: voer het installatieprogramma opnieuw uit
--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 faalt na de npm-pakketinstallatiefase, voer dan het
installatieprogramma opnieuw uit. Het installatieprogramma roept de oude updater niet aan; het voert de globale
pakketinstallatie rechtstreeks uit en kan een gedeeltelijk bijgewerkte npm-installatie herstellen.
--version toe:
Alternatief: handmatig npm, pnpm of bun
openclaw update voor begeleide installaties omdat het de
pakketwissel kan coordineren met de draaiende Gateway-service. Als je handmatig updatet op een
begeleide installatie, stop dan de beheerde Gateway voordat de pakketbeheerder start.
Pakketbeheerders vervangen bestanden ter plaatse, en een draaiende Gateway kan anders proberen
core- of plugin-bestanden te laden terwijl de pakketstructuur tijdelijk half verwisseld is.
Herstart de Gateway nadat de pakketbeheerder klaar is, zodat de service de
nieuwe installatie oppakt.
Voor een Linux-systeembrede installatie die eigendom is van root: als openclaw update faalt met
EACCES en je herstelt met systeem-npm, houd de Gateway dan gestopt tijdens de
handmatige pakketvervanging. Gebruik dezelfde openclaw-profielvlaggen of omgeving
die je normaal voor die Gateway gebruikt. Vervang /usr/bin/npm door de systeem-npm
die eigenaar is van de root-owned globale prefix op je host:
openclaw update een globale npm-installatie beheert, installeert het eerst het doel in
een tijdelijke npm-prefix, verifieert de verpakte dist-inventaris en wisselt daarna
de schone pakketstructuur naar de echte globale prefix. Dat voorkomt dat npm een
nieuw pakket over oude bestanden van het vorige pakket heen legt. Als de installatieopdracht faalt,
probeert OpenClaw het eenmaal opnieuw met --omit=optional. Die retry helpt hosts waar native
optionele afhankelijkheden niet kunnen compileren, terwijl de oorspronkelijke fout zichtbaar blijft
als de fallback ook faalt.
Door OpenClaw beheerde npm-update- en plugin-update-opdrachten wissen ook de npm
min-release-age-quarantaine voor het child-npm-proces. npm kan dat beleid rapporteren als
een afgeleide before-grens; beide zijn nuttig voor algemene supply-chain-quarantainebeleidsregels,
maar een expliciete OpenClaw-update betekent: “installeer de geselecteerde
OpenClaw-release nu.”
Geavanceerde npm-installatieonderwerpen
Alleen-lezen pakketstructuur
Alleen-lezen pakketstructuur
OpenClaw behandelt verpakte globale installaties tijdens runtime als alleen-lezen, zelfs wanneer de globale pakketdirectory schrijfbaar 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-pakketstructuur 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 opdrachten voor het installeren/updaten van plugins buiten die globale pakketdirectory schrijven.Versterkte systemd-units
Versterkte systemd-units
Geef OpenClaw schrijftoegang tot zijn config-/state-roots zodat expliciete plugin-installaties, plugin-updates en doctor-opruiming hun wijzigingen kunnen opslaan:
Schijfruimte-preflight
Schijfruimte-preflight
Voor pakketupdates en expliciete plugin-installaties probeert OpenClaw een best-effort schijfruimtecontrole uit te voeren voor het doelvolume. Weinig ruimte levert een waarschuwing op met het gecontroleerde pad, maar blokkeert de update niet omdat filesystemquota, snapshots en netwerkvolumes na de controle kunnen veranderen. De daadwerkelijke pakketbeheerderinstallatie en post-installverificatie blijven leidend.
Auto-updater
De auto-updater staat standaard uit. Schakel deze in via~/.openclaw/openclaw.json:
| Kanaal | Gedrag |
|---|---|
stable | Wacht stableDelayHours en past daarna toe met deterministische jitter over stableJitterHours (gespreide uitrol). |
beta | Controleert elke betaCheckIntervalHours (standaard: elk uur) en past onmiddellijk toe. |
dev | Geen automatische toepassing. Gebruik openclaw update handmatig. |
update.checkOnStart: false).
Voor downgrade of incidentherstel 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 draaien tenzij update.checkOnStart ook is uitgeschakeld.
Pakketbeheerderupdates die via de live Gateway-control-plane-handler worden aangevraagd,
vervangen de pakketstructuur niet binnen het draaiende Gateway-proces. Bij beheerde
service-installaties start de Gateway een losgekoppelde overdracht, sluit af 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 geinstalleerde-maar-niet-geladen macOS LaunchAgent herstellen. Als de Gateway die overdracht niet veilig kan uitvoeren, rapporteert update.run een
veilige shellopdracht in plaats van de pakketbeheerder in-process uit te voeren.
Na het updaten
Migreert config, controleert DM-beleid en controleert de Gateway-gezondheid. Details: Doctor
Terugdraaien
Zet een versie vast (npm)
Zet een commit vast (source)
git checkout main && git pull.
Als je vastzit
- Voer
openclaw doctoropnieuw uit en lees de uitvoer zorgvuldig. - Voor
openclaw update --channel devop source-checkouts bootstrapt de updaterpnpmautomatisch wanneer dat nodig is. Als je een pnpm/corepack-bootstrapfout ziet, installeerpnpmdan handmatig (of schakelcorepackopnieuw in) en voer de update opnieuw uit. - Controleer: Probleemoplossing
- Vraag het in Discord: https://discord.gg/clawd
Gerelateerd
- Installatieoverzicht: alle installatiemethoden.
- Doctor: gezondheidscontroles na updates.
- Migreren: migratiegidsen voor hoofdversies.