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.
openclaw update
Werk OpenClaw veilig bij en wissel tussen stable-/beta-/dev-kanalen.
Als je hebt geïnstalleerd via npm/pnpm/bun (globale installatie, zonder git-metadata),
worden updates uitgevoerd via de package-manager-flow in Bijwerken.
Gebruik
Opties
--no-restart: sla het herstarten van de Gateway-service over na een geslaagde update. Package-manager-updates die de Gateway wel herstarten, verifiëren dat de herstarte service de verwachte bijgewerkte versie rapporteert voordat de opdracht slaagt.--channel <stable|beta|dev>: stel het updatekanaal in (git + npm; opgeslagen in de configuratie).--tag <dist-tag|version|spec>: overschrijf het package-doel alleen voor deze update. Voor package-installaties wordtmaingekoppeld aangithub:openclaw/openclaw#main.--dry-run: toon een voorbeeld van geplande updateacties (kanaal/tag/doel/herstart-flow) zonder configuratie te schrijven, te installeren, Plugins te synchroniseren of te herstarten.--json: druk machineleesbareUpdateRunResult-JSON af, inclusiefpostUpdate.plugins.warningswanneer corrupte of niet-laadbare beheerde Plugins reparatie nodig hebben nadat de core-update is geslaagd, details over Plugin-terugval voor het betakanaal wanneer een Plugin geen betarelease heeft, enpostUpdate.plugins.integrityDriftswanneer drift in npm-Plugin-artefacten wordt gedetecteerd tijdens Plugin-synchronisatie na de update.--timeout <seconds>: time-out per stap (standaard 1800 s).--yes: sla bevestigingsprompts over (bijvoorbeeld bevestiging voor downgraden).
openclaw update heeft geen --verbose-vlag. Gebruik --dry-run om een voorbeeld
te bekijken van de geplande kanaal-/tag-/installatie-/herstartacties, --json voor
machineleesbare resultaten, en openclaw update status --json wanneer je alleen
kanaal- en beschikbaarheidsdetails nodig hebt. Als je Gateway-logboeken rond een
update debugt, zijn consoleverbosity en bestandslogniveau gescheiden: Gateway
--verbose beïnvloedt terminal-/WebSocket-uitvoer, terwijl bestandslogboeken
logging.level: "debug" of "trace" in de configuratie vereisen. Zie
Gateway-logboekregistratie.
In Nix-modus (
OPENCLAW_NIX_MODE=1) zijn muterende openclaw update-runs uitgeschakeld. Werk in plaats daarvan de Nix-bron of flake-input voor deze installatie bij; gebruik voor nix-openclaw de agent-first Snelstart. openclaw update status en openclaw update --dry-run blijven alleen-lezen.update status
Toon het actieve updatekanaal + git-tag/-branch/-SHA (voor source-checkouts), plus updatebeschikbaarheid.
--json: druk machineleesbare status-JSON af.--timeout <seconds>: time-out voor controles (standaard 3 s).
update wizard
Interactieve flow om een updatekanaal te kiezen en te bevestigen of de Gateway
na het bijwerken moet worden herstart (standaard wordt herstart). Als je dev
selecteert zonder git-checkout, wordt aangeboden er een te maken.
Opties:
--timeout <seconds>: time-out voor elke updatestap (standaard1800)
Wat het doet
Wanneer je expliciet van kanaal wisselt (--channel ...), houdt OpenClaw ook de
installatiemethode in lijn:
dev→ zorgt voor een git-checkout (standaard:~/openclaw, overschrijfbaar metOPENCLAW_GIT_DIR), werkt deze bij en installeert de globale CLI vanuit die checkout.stable→ installeert vanuit npm metlatest.beta→ geeft de voorkeur aan npm-dist-tagbeta, maar valt terug oplatestwanneer beta ontbreekt of ouder is dan de huidige stable-release.
update.run package-manager-updates
forceren een niet-uitgestelde updateherstart zonder cooldown na de package-wissel,
omdat het oude Gateway-proces mogelijk nog chunks in het geheugen heeft die verwijzen naar
bestanden die door het nieuwe package zijn verwijderd.
Voor package-manager-installaties bepaalt openclaw update de doelversie van het package
voordat de package manager wordt aangeroepen. Globale npm-installaties gebruiken een gestagede
installatie: OpenClaw installeert het nieuwe package in een tijdelijke npm-prefix, verifieert
daar de meegeleverde dist-inventaris, en wisselt vervolgens die schone package-tree naar de
echte globale prefix. Als verificatie mislukt, worden doctor na de update, Plugin-synchronisatie
en herstartwerk niet uitgevoerd vanuit de verdachte tree. Zelfs wanneer de geïnstalleerde versie
al overeenkomt met het doel, ververst de opdracht de globale package-installatie en voert daarna
Plugin-synchronisatie, een verversing van core-opdrachtvoltooiing en herstartwerk uit. Dit houdt
meegeleverde sidecars en kanaalbeheerde Plugin-records in lijn met de geïnstalleerde OpenClaw-build,
terwijl volledige herbouws van Plugin-opdrachtvoltooiing worden overgelaten aan expliciete
openclaw completion --write-state-runs.
Wanneer een lokale beheerde Gateway-service is geïnstalleerd en herstarten is ingeschakeld,
stoppen package-manager-updates de draaiende service voordat de package-tree wordt vervangen,
verversen vervolgens de servicemetadata vanuit de bijgewerkte installatie, herstarten de
service en verifiëren dat de herstarte Gateway de verwachte versie rapporteert voordat succes
wordt gemeld. Op macOS verifieert de controle na de update ook dat de LaunchAgent is geladen/draait
voor het actieve profiel en dat de geconfigureerde loopbackpoort gezond is. Als de plist is
geïnstalleerd maar launchd deze niet superviseert, bootstrapt OpenClaw de LaunchAgent automatisch
opnieuw en voert daarna de controles voor gezondheid/versie/kanaalgereedheid opnieuw uit. Een
verse bootstrap laadt de RunAtLoad-job rechtstreeks, zodat updateherstel niet meteen kickstart -k
uitvoert op de nieuw gestarte Gateway. Als de Gateway nog steeds niet gezond wordt, sluit de opdracht
af met een niet-nulstatus en drukt het pad naar het herstartlogboek plus expliciete instructies
voor herstarten, opnieuw installeren en package-rollback af. Met --no-restart wordt de
package-vervanging nog steeds uitgevoerd, maar de beheerde service wordt niet gestopt of herstart,
waardoor de draaiende Gateway oude code kan blijven gebruiken totdat je deze handmatig herstart.
Git-checkout-flow
Kanaalselectie
stable: checkout de nieuwste niet-beta-tag, bouw daarna en voer doctor uit.beta: geef de voorkeur aan de nieuwste-beta-tag, maar val terug op de nieuwste stable-tag wanneer beta ontbreekt of ouder is.dev: checkoutmain, haal daarna op en rebase.
Updatestappen
Preflight build (dev only)
Voert de TypeScript-build uit in een tijdelijke worktree. Als de tip mislukt, loopt deze tot 10 commits terug om de nieuwste bouwbare commit te vinden. Stel
OPENCLAW_UPDATE_PREFLIGHT_LINT=1 in om tijdens deze preflight ook lint uit te voeren; lint draait in beperkte seriële modus, omdat updatehosts van gebruikers vaak kleiner zijn dan CI-runners.Install dependencies
Gebruikt de package manager van de repo. Voor pnpm-checkouts bootstrapt de updater
pnpm op aanvraag (eerst via corepack, daarna met een tijdelijke fallback npm install pnpm@11) in plaats van npm run build binnen een pnpm-workspace uit te voeren.@beta-release. Als de Plugin geen
betarelease heeft, valt OpenClaw terug op de vastgelegde standaard-/latest-specificatie en rapporteert
dat als waarschuwing. Voor npm-Plugins valt OpenClaw ook terug wanneer het beta-package
bestaat maar installatievalidatie mislukt. Deze waarschuwingen over Plugin-terugval laten
de core-update niet mislukken. Exacte versies en expliciete tags worden niet herschreven.
Fouten bij Plugin-synchronisatie na de update die beperkt zijn tot een beheerde Plugin en waar het synchronisatiepad omheen kan routeren (bijv. een onbereikbaar npm-register voor een niet-essentiële Plugin), worden gerapporteerd als waarschuwingen nadat de core-update is geslaagd. Het JSON-resultaat behoudt de update-
status: "ok" op topniveau en rapporteert postUpdate.plugins.status: "warning" met begeleiding voor openclaw doctor --fix en openclaw plugins inspect <id> --runtime --json. Onverwachte updater- of synchronisatie-excepties laten het updateresultaat nog steeds mislukken. Los de Plugin-installatie- of updatefout op en voer daarna openclaw doctor --fix of openclaw update opnieuw uit.Na de synchronisatiestap per Plugin voert openclaw update een verplichte post-core convergentie-pass uit voordat de Gateway wordt herstart: deze repareert ontbrekende geconfigureerde Plugin-payloads, valideert elk actief bijgehouden installatierecord op schijf en verifieert statisch dat de package.json parsebaar is (en dat elke expliciet gedeclareerde main bestaat). Fouten uit deze pass — en een ongeldig OpenClaw-configuratiesnapshot — retourneren postUpdate.plugins.status: "error" en zetten de update-status op topniveau op "error", zodat openclaw update afsluit met een niet-nulstatus en de Gateway niet wordt herstart met een niet-geverifieerde Plugin-set. De fout bevat gestructureerde regels postUpdate.plugins.warnings[].guidance die verwijzen naar openclaw doctor --fix en openclaw plugins inspect <id> --runtime --json voor opvolging. Uitgeschakelde Plugin-items en records die geen official sync targets zijn die aan een trusted source zijn gekoppeld, worden hier overgeslagen, in lijn met het skipDisabledPlugins-beleid dat wordt gebruikt door de controle op ontbrekende payloads, zodat een verouderd uitgeschakeld Plugin-record een verder geldige update niet kan blokkeren.Wanneer de bijgewerkte Gateway start, is het laden van Plugins alleen-verificatie: startup voert geen package managers uit en muteert geen dependency-trees. Package-manager-update.run-herstarts omzeilen de normale idle-uitstel en herstart-cooldown nadat de package-tree is gewisseld, zodat het oude proces niet lazy-loading kan blijven doen van verwijderde chunks.Als pnpm-bootstrap nog steeds mislukt, stopt de updater vroeg met een package-manager-specifieke fout in plaats van npm run build binnen de checkout te proberen.--update-afkorting
openclaw --update wordt herschreven naar openclaw update (handig voor shells en launcher-scripts).
Gerelateerd
openclaw doctor(biedt aan eerst update uit te voeren op git-checkouts)- Ontwikkelingskanalen
- Bijwerken
- CLI-referentie