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ł lub wskazać konkretną wersję: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # podgląd bez zastosowania
--channel beta preferuje kanał beta, ale runtime przechodzi awaryjnie do stable/latest, gdy tag beta nie istnieje albo jest starszy niż najnowsze stabilne wydanie. Użyj --tag beta, jeśli chcesz użyć surowego npm dist-tag beta do jednorazowej aktualizacji pakietu. Informacje o semantyce kanałów znajdziesz w Kanały deweloperskie.

​
Alternatywa: uruchom instalator ponownie

curl -fsSL https://openclaw.ai/install.sh | bash
Dodaj --no-onboard, aby pominąć wdrożenie. W przypadku instalacji ze źródeł podaj --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,
    },
  },
}
ChannelZachowanie
stableCzeka stableDelayHours, a następnie stosuje aktualizację z deterministycznym jitterem rozłożonym na stableJitterHours (stopniowe wdrażanie).
betaSprawdza co betaCheckIntervalHours (domyślnie: co godzinę) i stosuje aktualizację natychmiast.
devBrak automatycznego stosowania. Użyj openclaw update ręcznie.
Gateway zapisuje też przy uruchomieniu wskazówkę o aktualizacji w logach (wyłącz przez update.checkOnStart: false).

​
Po aktualizacji

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

​
Wycofanie zmian

​
Przypnij wersję (npm)

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

​
Przypnij commit (źródła)

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

  • Uruchom ponownie openclaw doctor i uważnie przeczytaj dane wyjściowe.
  • W przypadku openclaw update --channel dev w checkoutach ze źródeł updater automatycznie bootstrapuje pnpm, gdy jest to potrzebne. Jeśli zobaczysz błąd bootstrapu pnpm/corepack, zainstaluj pnpm ręcznie (albo ponownie włącz corepack) i uruchom aktualizację jeszcze raz.
  • Sprawdź: Rozwiązywanie problemów
  • Zapytaj na Discordzie: https://discord.gg/clawd

​
Powiązane