Aktualizacja OpenClaw — jak zaktualizować do najnowszej wersji

Aktualizacja OpenClaw

Regularne aktualizacje zapewniają dostęp do najnowszych funkcji, poprawek bezpieczeństwa i usprawnień wydajności. OpenClaw oferuje kilka metod aktualizacji dopasowanych do różnych scenariuszy.

Podstawowa metoda — openclaw update

Zalecanym sposobem aktualizacji jest wbudowane polecenie:

openclaw update

To polecenie automatycznie:

1. Wykrywa typ Twojej instalacji (npm, skrypt, źródła).
2. Pobiera najnowszą wersję.
3. Uruchamia diagnostykę (openclaw doctor).
4. Restartuje Gateway.

Opcje polecenia update

Możesz precyzyjnie kontrolować proces aktualizacji:

# Aktualizacja do wersji beta
openclaw update --channel beta

# Aktualizacja do konkretnej wersji
openclaw update --tag v2.5.0

# Podglad zmian bez ich stosowania
openclaw update --dry-run

Kanał beta automatycznie przechodzi na wersję stabilną, jeśli beta nie jest dostępna.

Alternatywne metody aktualizacji

Ponowna instalacja skryptem

curl -fsSL https://openclaw.ai/install.sh | bash

Skrypt można uruchomić ponownie, opcjonalnie pomijając onboarding.

Przez menedżer pakietów

# npm
npm install -g @openclaw/openclaw@latest

# pnpm
pnpm add -g @openclaw/openclaw@latest

# bun
bun install -g @openclaw/openclaw@latest

Automatyczne aktualizacje

Auto-updater jest domyślnie wyłączony. Aby go włączyć, dodaj odpowiedni wpis w pliku konfiguracyjnym openclaw.json:

{
  "autoUpdate": {
    "enabled": true,
    "channel": "stable"
  }
}

Działanie auto-updatera zależy od wybranego kanału:

• Kanał stable — czeka przed zastosowaniem aktualizacji, z losowym opóźnieniem rozłożonym na kilka godzin.
• Kanał beta — sprawdza co godzinę i stosuje natychmiast.

Czynności po aktualizacji

Po każdej aktualizacji wykonaj następujące kroki:

# Diagnostyka i migracja konfiguracji
openclaw doctor

# Restart Gateway
openclaw gateway restart

# Weryfikacja dzialania
openclaw health

Cofanie aktualizacji (rollback)

Jeśli nowa wersja powoduje problemy, możesz wrócić do starszej:

Instalacja npm

# Przypnij konkretna wersje
npm install -g @openclaw/openclaw@2.4.3
openclaw gateway restart

Instalacja ze źródeł

cd /sciezka/do/openclaw
git checkout v2.4.3
npm install
npm run build
openclaw gateway restart

Rozwiązywanie problemów

• Aktualizacja się nie udaje — uruchom openclaw doctor i sprawdź, czy Node.js jest w wymaganej wersji.
• Brakuje pnpm — zainstaluj ręcznie: npm install -g pnpm.
• Gateway nie startuje po aktualizacji — sprawdź logi i uruchom diagnostykę; może być konieczna migracja konfiguracji.