Houd OpenClaw up-to-date.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.
Aanbevolen: openclaw update
De snelste manier om bij te werken. Deze detecteert je installatietype (npm of git), haalt de nieuwste versie op, voert openclaw doctor uit en herstart de Gateway.
--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 Ontwikkelkanalen voor kanaalsemantiek.
Wisselen tussen npm- en git-installaties
Gebruik kanalen wanneer je het installatietype wilt wijzigen. De updater behoudt je status, configuratie, inloggegevens en werkruimte in~/.openclaw; hij wijzigt alleen
welke OpenClaw-code-installatie de CLI en Gateway gebruiken.
--dry-run om de exacte wissel van installatiemodus 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.
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 mislukt 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 een globale npm-installatie beheert, installeert deze het doel eerst in
een tijdelijke npm-prefix, verifieert de verpakte dist-inventaris en wisselt daarna
de schone pakketboom naar de echte globale prefix. Dat voorkomt dat npm een
nieuw pakket over verouderde bestanden uit het oude 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.
Geavanceerde npm-installatieonderwerpen
Alleen-lezen pakketboom
Alleen-lezen pakketboom
OpenClaw behandelt verpakte globale installaties tijdens runtime als alleen-lezen, zelfs wanneer de globale pakketmap beschrijfbaar is voor de huidige gebruiker. Gebundelde Plugin-runtimeafhankelijkheden worden in plaats daarvan in een beschrijfbare runtimemap klaargezet, zonder de pakketboom te wijzigen. Dit voorkomt dat
openclaw update botst met een draaiende Gateway of lokale agent die tijdens dezelfde installatie Plugin-afhankelijkheden repareert.Sommige Linux-npm-installaties plaatsen globale pakketten onder mappen die eigendom zijn van root, zoals /usr/lib/node_modules/openclaw. OpenClaw ondersteunt die indeling via hetzelfde externe stagingpad.Verharde systemd-units
Verharde systemd-units
Stel een beschrijfbare stagingmap in die is opgenomen in Als
ReadWritePaths:OPENCLAW_PLUGIN_STAGE_DIR accepteert ook een lijst met paden. OpenClaw lost gebundelde Plugin-runtimeafhankelijkheden van links naar rechts op over de vermelde roots, behandelt eerdere roots als alleen-lezen vooraf geinstalleerde lagen en installeert of repareert alleen in de laatste beschrijfbare root:OPENCLAW_PLUGIN_STAGE_DIR niet is ingesteld, gebruikt OpenClaw $STATE_DIRECTORY wanneer systemd die levert, en valt daarna terug op ~/.openclaw/plugin-runtime-deps. De reparatiestap behandelt die stage als een lokale pakketroot die eigendom is van OpenClaw en negeert de npm-prefix en globale instellingen van de gebruiker, zodat globale npm-installatieconfiguratie gebundelde Plugin-afhankelijkheden niet omleidt naar ~/node_modules of de globale pakketboom.Voorcontrole op schijfruimte
Voorcontrole op schijfruimte
Voor pakketupdates en reparaties van gebundelde runtimeafhankelijkheden probeert OpenClaw naar beste kunnen de schijfruimte voor het doelvolume te controleren. 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 npm-installatie, kopie en verificatie na installatie blijven leidend.
Gebundelde Plugin-runtimeafhankelijkheden
Gebundelde Plugin-runtimeafhankelijkheden
Verpakte installaties houden gebundelde Plugin-runtimeafhankelijkheden buiten de alleen-lezen pakketboom. Bij het opstarten en tijdens
openclaw doctor --fix repareert OpenClaw runtimeafhankelijkheden alleen voor gebundelde plugins die actief zijn in de configuratie, actief zijn via verouderde kanaalconfiguratie of ingeschakeld zijn door hun standaardinstelling in het gebundelde manifest. Alleen opgeslagen kanaal-authenticatiestatus activeert geen reparatie van runtimeafhankelijkheden bij het opstarten van de Gateway.Expliciet uitschakelen heeft voorrang. Een uitgeschakelde Plugin of uitgeschakeld kanaal krijgt zijn runtimeafhankelijkheden niet gerepareerd alleen omdat het in het pakket bestaat. Externe plugins en aangepaste laadpaden blijven openclaw plugins install of openclaw plugins update gebruiken.Automatische updater
De automatische updater staat standaard uit. Schakel deze in~/.openclaw/openclaw.json in:
| 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 herstel na incidenten stel je OPENCLAW_NO_AUTO_UPDATE=1 in de Gateway-omgeving in om automatische toepassingen te blokkeren, zelfs wanneer update.auto.enabled is geconfigureerd. Updatetips bij het opstarten kunnen nog steeds worden uitgevoerd, tenzij update.checkOnStart ook is uitgeschakeld.
Na het bijwerken
Migreert configuratie, controleert DM-beleid en controleert de gezondheid van de Gateway. Details: Doctor
Terugdraaien
Zet een versie vast (npm)
Zet een commit vast (bron)
git checkout main && git pull.
Als je vastloopt
- Voer
openclaw doctoropnieuw uit en lees de uitvoer zorgvuldig. - Voor
openclaw update --channel devop broncheckouts bootstrappt 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: migratiehandleidingen voor hoofdversies.