Releasekanalen

OpenClaw wordt geleverd met vier updatekanalen:

• stable: npm-dist-tag latest. Aanbevolen voor de meeste gebruikers.
• extended-stable: npm-dist-tag extended-stable. Een volledig nieuw pakketkanaal voor een eerdere ondersteunde maand. Het is uitsluitend voor pakketten en installatie kan alleen op de voorgrond plaatsvinden. 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: bewegende kop van main (git). npm-dist-tag dev indien gepubliceerd. main is bedoeld voor experimenten en actieve ontwikkeling; het kan onvolledige functies of brekende wijzigingen bevatten. Gebruik het niet voor productie-Gateways.

Stabiele builds worden meestal eerst uitgebracht via beta, daar gecontroleerd en vervolgens zonder versieverhoging gepromoveerd naar latest. Beheerders kunnen ook rechtstreeks naar latest publiceren. Dist-tags zijn de bron van waarheid voor npm-installaties.

Van kanaal wisselen

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

--channel slaat de keuze 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 bewegende GitHub-main-checkout (blijvend)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 dit.
• De tag wordt niet opgeslagen; de volgende openclaw update gebruikt het geconfigureerde kanaal.
• --tag main wordt voor die ene uitvoering omgezet naar de npm-compatibele specificatie github:openclaw/openclaw#main. Gebruik voor een blijvende bewegende 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 je 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 kanaalflow kan terugvallen op stable/latest wanneer beta ontbreekt of ouder is, terwijl --tag beta voor die ene uitvoering altijd de onbewerkte 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 een bevestiging voor een downgrade vereist zou zijn.

Plugins en kanalen

Van kanaal wisselen met openclaw update synchroniseert ook Plugin-bronnen:

• dev schakelt geïnstalleerde Plugins met een meegeleverde tegenhanger terug naar hun meegeleverde bron (git-checkout).
• stable en beta herstellen Plugin-pakketten die via npm of ClawHub zijn geïnstalleerd.
• extended-stable zet geschikte officiële npm-Plugins met kale/standaardintentie of latest-intentie om naar exact de geïnstalleerde kernversie. Het vraagt tijdens runtime geen Plugin-tags @extended-stable op.
• 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, vYYYY.M.PATCH-beta.N voor beta. Benoemde prerelease-achtervoegsels zoals -alpha.N, -rc.N en -next.N zijn geen stable- of beta-doelen.
• Verouderde numerieke stable-tags zoals vYYYY.M.PATCH-1 en v1.0.1-1 worden voor compatibiliteit nog steeds herkend als stabiele git-tags.
• vYYYY.M.PATCH.beta.N (gescheiden door punten) wordt voor compatibiliteit ook herkend; geef de voorkeur aan -beta.N.
• Houd tags onveranderlijk: verplaats of hergebruik een tag nooit.
• npm-dist-tags blijven de bron van waarheid voor npm-installaties:
  • latest -> stable
  • extended-stable -> pakketrelease voor een eerdere ondersteunde maand
  • beta -> kandidaatbuild of stabiele build die eerst via beta wordt uitgebracht
  • dev -> main-snapshot (optioneel)

Beschikbaarheid van de macOS-app

Beta- en dev-builds bevatten mogelijk geen macOS-apprelease. Dat is geen probleem:

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

Gerelateerd

• Bijwerken
• Interne werking van het installatieprogramma