Bijwerken

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

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

# 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,
    },
  },
}

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

openclaw doctor

openclaw gateway restart

openclaw health

# Terugdraaien

# Zet een versie vast (npm)

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

# 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

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