Releasekanalen

OpenClaw wordt via vier updatekanalen uitgebracht:

• stable: npm-dist-tag latest. Aanbevolen voor de meeste gebruikers.
• extended-stable: npm-dist-tag extended-stable. Een volledig nieuw pakketkanaal voor een eerdere, nog ondersteunde maand. Het is uitsluitend beschikbaar als pakket en installatie vindt alleen op de voorgrond plaats. Een opgeslagen selectie ontvangt alleen-lezen updatehints wanneer update.checkOnStart is ingeschakeld, maar past updates nooit automatisch toe.
• beta: npm-dist-tag beta. Valt terug op latest wanneer beta ontbreekt of ouder is dan de huidige stabiele release.
• dev: de verplaatsende kop van main (git). npm-dist-tag dev wanneer gepubliceerd. main is bedoeld voor experimenten en actieve ontwikkeling; deze kan onvolledige functies of ingrijpende wijzigingen bevatten. Gebruik deze niet voor Gateways in productie.

Stabiele builds worden doorgaans eerst via beta uitgebracht, daar gevalideerd en vervolgens zonder versieverhoging naar latest gepromoveerd. Onderhouders kunnen ook rechtstreeks naar latest publiceren. Dist-tags zijn de gezaghebbende bron voor npm-installaties.

Van kanaal wisselen

openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel slaat de keuze permanent op in update.channel in de configuratie en stuurt beide installatiepaden aan:

Voor dev-git-installaties is de standaardcheckout ~/openclaw (of $OPENCLAW_HOME/openclaw wanneer OPENCLAW_HOME is ingesteld); overschrijf dit met OPENCLAW_GIT_DIR.

Eenmalig een versie of tag kiezen

Gebruik --tag om voor één update een specifieke dist-tag, versie of pakketspecificatie te kiezen, zonder het opgeslagen kanaal te wijzigen:

# Een specifieke versie installerenopenclaw update --tag 2026.4.1-beta.1 # Installeren vanaf de beta-dist-tag (eenmalig, wordt niet opgeslagen)openclaw update --tag beta # Overschakelen naar de verplaatsende GitHub-main-checkout (permanent)openclaw update --channel dev # Een specifieke npm-pakketspecificatie installerenopenclaw update --tag openclaw@2026.4.1-beta.1 # Eenmalig installeren vanaf GitHub main zonder het kanaal op te slaanopenclaw update --tag main

Opmerkingen:

• --tag is alleen van toepassing op pakketinstallaties (npm); git-installaties negeren deze optie.
• De tag wordt niet opgeslagen; de volgende openclaw update gebruikt het geconfigureerde kanaal.
• --tag main wordt voor die ene uitvoering toegewezen aan de npm-compatibele specificatie github:openclaw/openclaw#main. Gebruik voor een permanente, verplaatsende main-installatie openclaw update --channel dev (pakketinstallaties schakelen over naar een git-checkout), of installeer opnieuw met de git-methode van het installatieprogramma: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. Het npm-installatiepad weigert GitHub-/git-brondoelen volledig en verwijst u in plaats daarvan naar de git-methode.
• Bescherming tegen downgraden: als de doelversie ouder is dan de huidige versie, vraagt OpenClaw om bevestiging (sla dit over met --yes).
• Extended-stable gebruikt altijd zijn geverifieerde, exacte pakketdoel. Het is geen eenmalige alias voor --tag extended-stable en --tag kan niet worden gecombineerd met een effectief extended-stable-kanaal.
• --channel beta verschilt van --tag beta: de kanaalprocedure kan terugvallen op stable/latest wanneer beta ontbreekt of ouder is, terwijl --tag beta voor die ene uitvoering altijd rechtstreeks de dist-tag beta kiest.

Proefuitvoering

Bekijk vooraf wat openclaw update zou doen zonder wijzigingen aan te brengen:

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

De proefuitvoering meldt het effectieve kanaal, de doelversie, de geplande acties en of bevestiging voor een downgrade vereist zou zijn.

Plugins en kanalen

Wanneer u met openclaw update van kanaal wisselt, worden ook de Plugin-bronnen gesynchroniseerd:

• dev schakelt geïnstalleerde Plugins met een gebundelde tegenhanger terug naar hun gebundelde bron (git-checkout).
• stable en beta herstellen via npm of ClawHub geïnstalleerde Plugin-pakketten.
• extended-stable koppelt in aanmerking komende officiële npm-Plugins met kale/standaard- of latest-intentie aan de exact geïnstalleerde kernversie. Tijdens runtime worden geen @extended-stable-tags van Plugins opgevraagd.
• Via npm geïnstalleerde Plugins worden bijgewerkt nadat de kernupdate is voltooid.

Huidige status controleren

openclaw update status

Toont het actieve kanaal (met de bron die dit heeft bepaald: configuratie, git-tag, git-branch, geïnstalleerde versie of standaardwaarde), het installatietype (git of pakket), de huidige versie en de beschikbaarheid van updates.

Aanbevolen werkwijzen voor tags

• Tag releases waarop git-checkouts moeten uitkomen: vYYYY.M.PATCH voor stable en vYYYY.M.PATCH-beta.N voor beta. Benoemde prerelease-achtervoegsels zoals -alpha.N, -rc.N en -next.N zijn geen doelen voor stable of beta.
• Verouderde numerieke stable-tags zoals vYYYY.M.PATCH-1 en v1.0.1-1 worden voor compatibiliteit nog steeds als stabiele git-tags herkend.
• vYYYY.M.PATCH.beta.N (gescheiden door punten) wordt eveneens voor compatibiliteit herkend; geef de voorkeur aan -beta.N.
• Houd tags onveranderlijk: verplaats of hergebruik een tag nooit.
• npm-dist-tags blijven de gezaghebbende bron voor npm-installaties:
  • latest -> stable
  • extended-stable -> pakketrelease van een eerdere, nog ondersteunde maand
  • beta -> kandidaatbuild of stabiele build die eerst via beta wordt uitgebracht
  • dev -> momentopname van main (optioneel)

Beschikbaarheid van de macOS-app

Beta- en dev-builds bevatten mogelijk geen release van de macOS-app. Dat is geen probleem:

• De git-tag en npm-dist-tag kunnen nog steeds afzonderlijk worden gepubliceerd.
• Vermeld "geen macOS-build voor deze beta" in de releaseopmerkingen of changelog.

Gerelateerd

• Bijwerken
• Interne werking van het installatieprogramma