Aktualizowanie

Utrzymuj OpenClaw w aktualnej wersji.

Zalecane: openclaw update

Najszybszy sposób aktualizacji. Wykrywa typ instalacji (npm albo git), pobiera najnowszą wersję, uruchamia openclaw doctor i restartuje Gateway.

openclaw update

Aby przełączyć kanały albo wskazać konkretną wersję:

openclaw update --channel betaopenclaw update --channel devopenclaw update --dry-run   # preview without applying

openclaw update nie przyjmuje --verbose. Do diagnostyki aktualizacji użyj --dry-run, aby podejrzeć planowane działania, --json dla wyników strukturalnych albo openclaw update status --json, aby sprawdzić stan kanału i dostępności. Instalator ma własną flagę --verbose, ale ta flaga nie jest częścią openclaw update.

--channel beta preferuje wersję beta, ale środowisko uruchomieniowe wraca do stable/latest, gdy tag beta jest niedostępny albo starszy niż najnowsze wydanie stable. Użyj --tag beta, jeśli chcesz użyć surowego npm dist-tag beta do jednorazowej aktualizacji pakietu.

Użyj --channel dev dla trwałego, ruchomego checkoutu GitHub main. Dla aktualizacji pakietów --tag main mapuje się na github:openclaw/openclaw#main dla jednego uruchomienia, a specyfikacje źródeł GitHub/git są pakowane do tymczasowego archiwum tar przed etapową instalacją npm.

Dla zarządzanych pluginów fallback kanału beta jest ostrzeżeniem: aktualizacja rdzenia może nadal się powieść, podczas gdy Plugin użyje zapisanego domyślnego/najnowszego wydania, ponieważ nie ma dostępnej wersji beta tego pluginu.

Zobacz Kanały deweloperskie, aby poznać semantykę kanałów.

Przełączanie między instalacjami npm i git

Używaj kanałów, gdy chcesz zmienić typ instalacji. Aktualizator zachowuje Twój stan, konfigurację, dane logowania i workspace w ~/.openclaw; zmienia tylko to, z której instalacji kodu OpenClaw korzystają CLI i Gateway.

# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw update --channel stable

Najpierw uruchom z --dry-run, aby podejrzeć dokładne przełączenie trybu instalacji:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

Kanał dev zapewnia checkout git, buduje go i instaluje globalne CLI z tego checkoutu. Kanały stable i beta używają instalacji pakietowych. Jeśli Gateway jest już zainstalowany, openclaw update odświeża metadane usługi i restartuje ją, chyba że przekażesz --no-restart.

Dla instalacji pakietowych z zarządzaną usługą Gateway openclaw update celuje w katalog główny pakietu używany przez tę usługę. Jeśli polecenie powłoki openclaw pochodzi z innej instalacji, aktualizator wypisuje oba katalogi główne i ścieżkę Node zarządzanej usługi. Aktualizacja pakietu używa menedżera pakietów, który jest właścicielem katalogu głównego usługi, i sprawdza Node zarządzanej usługi względem silnika docelowego wydania przed zastąpieniem pakietu.

Alternatywa: ponowne uruchomienie instalatora

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

Dodaj --no-onboard, aby pominąć onboarding. Aby wymusić konkretny typ instalacji przez instalator, przekaż --install-method git --no-onboard albo --install-method npm --no-onboard.

Jeśli openclaw update nie powiedzie się po fazie instalacji pakietu npm, uruchom ponownie instalator. Instalator nie wywołuje starego aktualizatora; uruchamia globalną instalację pakietu bezpośrednio i może naprawić częściowo zaktualizowaną instalację npm.

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

Aby przypiąć odzyskiwanie do konkretnej wersji albo dist-tag, dodaj --version:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

Alternatywa: ręczne npm, pnpm albo bun

npm i -g openclaw@latest

Preferuj openclaw update dla nadzorowanych instalacji, ponieważ może skoordynować podmianę pakietu z działającą usługą Gateway. Jeśli aktualizujesz ręcznie instalację nadzorowaną, zatrzymaj zarządzany Gateway przed uruchomieniem menedżera pakietów. Menedżery pakietów zastępują pliki w miejscu, a działający Gateway może w przeciwnym razie próbować ładować pliki rdzenia albo pluginu, gdy drzewo pakietu jest tymczasowo podmienione tylko częściowo. Po zakończeniu pracy menedżera pakietów zrestartuj Gateway, aby usługa użyła nowej instalacji.

Dla systemowej globalnej instalacji Linuksa należącej do root, jeśli openclaw update kończy się błędem EACCES i odzyskujesz ją za pomocą systemowego npm, pozostaw Gateway zatrzymany podczas ręcznej wymiany pakietu. Użyj tych samych flag profilu openclaw albo środowiska, których zwykle używasz dla tego Gateway. Zastąp /usr/bin/npm systemowym npm, który jest właścicielem globalnego prefiksu należącego do root na Twoim hoście:

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

Następnie zweryfikuj usługę:

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

Gdy openclaw update zarządza globalną instalacją npm, najpierw instaluje cel do tymczasowego prefiksu npm, weryfikuje spis zapakowanego dist, a następnie podmienia czyste drzewo pakietu do rzeczywistego globalnego prefiksu. Zapobiega to nakładaniu przez npm nowego pakietu na nieaktualne pliki ze starego pakietu. Jeśli polecenie instalacji się nie powiedzie, OpenClaw ponawia próbę raz z --omit=optional. Ta ponowna próba pomaga hostom, na których natywne zależności opcjonalne nie mogą się skompilować, jednocześnie zachowując widoczność pierwotnego błędu, jeśli fallback również się nie powiedzie.

Zarządzane przez OpenClaw polecenia aktualizacji npm i aktualizacji pluginów czyszczą także kwarantannę npm min-release-age dla podrzędnego procesu npm. npm może zgłosić tę politykę jako pochodną granicę before; oba mechanizmy są przydatne dla ogólnych polityk kwarantanny łańcucha dostaw, ale jawna aktualizacja OpenClaw oznacza „zainstaluj wybrane wydanie OpenClaw teraz”.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

Zaawansowane tematy instalacji npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Automatyczny aktualizator

Automatyczny aktualizator jest domyślnie wyłączony. Włącz go w ~/.openclaw/openclaw.json:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

Gateway zapisuje też podpowiedź o aktualizacji przy starcie (wyłącz przez update.checkOnStart: false). Do downgrade'u albo odzyskiwania po incydencie ustaw OPENCLAW_NO_AUTO_UPDATE=1 w środowisku Gateway, aby blokować automatyczne zastosowania nawet wtedy, gdy skonfigurowano update.auto.enabled. Podpowiedzi aktualizacji przy starcie nadal mogą działać, chyba że update.checkOnStart także jest wyłączone.

Aktualizacje menedżera pakietów żądane przez działający handler płaszczyzny sterowania Gateway nie zastępują drzewa pakietu wewnątrz działającego procesu Gateway. W instalacjach usługi zarządzanej Gateway uruchamia odłączone przekazanie, wychodzi i pozwala normalnej ścieżce CLI openclaw update --yes --json zatrzymać usługę, zastąpić pakiet, odświeżyć metadane usługi, zrestartować, zweryfikować wersję i osiągalność Gateway oraz odzyskać zainstalowany, ale niewczytany macOS LaunchAgent, gdy to możliwe. Jeśli Gateway nie może bezpiecznie wykonać takiego przekazania, update.run zgłasza bezpieczne polecenie powłoki zamiast uruchamiać menedżera pakietów w procesie.

Po aktualizacji

openclaw doctor

openclaw gateway restart

openclaw health

Wycofanie

Przypnij wersję (npm)

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Przypnij commit (źródło)

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

Aby wrócić do najnowszej wersji: git checkout main && git pull.

Jeśli utkniesz

• Uruchom ponownie openclaw doctor i uważnie przeczytaj wynik.
• Dla openclaw update --channel dev na checkoutach źródłowych aktualizator 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ę ponownie.
• Sprawdź: Rozwiązywanie problemów
• Zapytaj na Discord: https://discord.gg/clawd

Powiązane

• Przegląd instalacji: wszystkie metody instalacji.
• Doctor: kontrole kondycji po aktualizacjach.
• Migracja: przewodniki po migracji wersji głównych.