Przejdź do głównej treści

​
Aktualizowanie

Utrzymuj OpenClaw na bieżąco.

​
Zalecane: openclaw update

Najszybszy sposób aktualizacji. Wykrywa typ instalacji (npm lub git), pobiera najnowszą wersję, uruchamia openclaw doctor i restartuje gateway. 
openclaw update
Aby przełączyć kanały lub wskazać konkretną wersję: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # podgląd bez stosowania zmian
--channel beta preferuje beta, ale runtime wraca do stable/latest, gdy brakuje tagu beta lub jest on starszy niż najnowsze wydanie stable. Użyj --tag beta, jeśli chcesz surowy npm dist-tag beta dla jednorazowej aktualizacji pakietowej. Semantykę kanałów opisano w Development channels.

​
Alternatywa: uruchom ponownie instalator

curl -fsSL https://openclaw.ai/install.sh | bash
Dodaj --no-onboard, aby pominąć onboarding. Dla instalacji ze źródeł przekaż --install-method git --no-onboard.

​
Alternatywa: ręcznie przez npm, pnpm lub bun

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Auto-updater

Auto-updater jest domyślnie wyłączony. Włącz go w ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
KanałZachowanie
stableCzeka stableDelayHours, a następnie stosuje aktualizację z deterministycznym jitterem w zakresie stableJitterHours (rozłożone wdrożenie).
betaSprawdza co betaCheckIntervalHours (domyślnie: co godzinę) i stosuje natychmiast.
devBez automatycznego stosowania. Używaj ręcznie openclaw update.
Gateway zapisuje także wskazówkę o aktualizacji przy starcie (wyłącz przez update.checkOnStart: false).

​
Po aktualizacji

1
Uruchom doctor
2
openclaw doctor
3
Migruje config, wykonuje audyt polityk DM i sprawdza kondycję gateway. Szczegóły: Doctor
4
Zrestartuj gateway
5
openclaw gateway restart
6
Zweryfikuj
7
openclaw health

​
Rollback

​
Przypnij wersję (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Wskazówka: npm view openclaw version pokazuje bieżącą opublikowaną wersję.

​
Przypnij commit (ze źródeł)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
Aby wrócić do najnowszej wersji: git checkout main && git pull.

​
Jeśli utkniesz

​
Powiązane

  • Install Overview — wszystkie metody instalacji
  • Doctor — kontrole kondycji po aktualizacjach
  • Migrating — przewodniki migracji między głównymi wersjami