Zum Hauptinhalt springen

​
Aktualisieren

Halten Sie OpenClaw auf dem neuesten Stand.

​
Empfohlen: openclaw update

Der schnellste Weg zum Aktualisieren. Erkennt Ihren Installationstyp (npm oder git), lädt die neueste Version, führt openclaw doctor aus und startet das Gateway neu. 
openclaw update
Um Kanäle zu wechseln oder eine bestimmte Version als Ziel zu verwenden: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # Vorschau ohne Anwendung
--channel beta bevorzugt Beta, aber die Runtime fällt auf stable/latest zurück, wenn das Beta-Tag fehlt oder älter ist als die neueste stabile Veröffentlichung. Verwenden Sie --tag beta, wenn Sie das rohe npm-Beta-dist-tag für ein einmaliges Paket-Update möchten. Siehe Development channels für die Semantik von Kanälen.

​
Alternative: Installer erneut ausführen

curl -fsSL https://openclaw.ai/install.sh | bash
Fügen Sie --no-onboard hinzu, um das Onboarding zu überspringen. Für Installationen aus dem Quellcode übergeben Sie --install-method git --no-onboard.

​
Alternative: manuell mit npm, pnpm oder bun

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Auto-Updater

Der Auto-Updater ist standardmäßig deaktiviert. Aktivieren Sie ihn in ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
ChannelVerhalten
stableWartet stableDelayHours und wendet dann mit deterministischem Jitter über stableJitterHours an (gestaffelte Ausrollung).
betaPrüft alle betaCheckIntervalHours (Standard: stündlich) und wendet sofort an.
devKeine automatische Anwendung. Verwenden Sie openclaw update manuell.
Das Gateway protokolliert beim Start außerdem einen Update-Hinweis (deaktivierbar mit update.checkOnStart: false).

​
Nach dem Update

1
Doctor ausführen
2
openclaw doctor
3
Migriert die Konfiguration, prüft DM-Richtlinien und überprüft den Zustand des Gateways. Details: Doctor
4
Gateway neu starten
5
openclaw gateway restart
6
Überprüfen
7
openclaw health

​
Rollback

​
Version fixieren (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Tipp: npm view openclaw version zeigt die aktuell veröffentlichte Version an.

​
Commit fixieren (Quellcode)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
Zurück zur neuesten Version: git checkout main && git pull.

​
Wenn Sie nicht weiterkommen

  • Führen Sie openclaw doctor erneut aus und lesen Sie die Ausgabe sorgfältig.
  • Bei openclaw update --channel dev auf Checkouts aus dem Quellcode bootstrapped der Updater bei Bedarf automatisch pnpm. Wenn ein Bootstrap-Fehler mit pnpm/corepack angezeigt wird, installieren Sie pnpm manuell (oder aktivieren Sie corepack erneut) und führen Sie das Update erneut aus.
  • Prüfen Sie: Fehlerbehebung
  • Fragen Sie in Discord: https://discord.gg/clawd

​
Verwandt