Przejdź do głównej treści

​
Aktualizacja

OpenClaw rozwija się szybko (przed „1.0”). Traktuj aktualizacje jak wdrażanie infrastruktury: aktualizacja → uruchomienie kontroli → restart (lub użycie openclaw update, który wykonuje restart) → weryfikacja.

​
Zalecane: ponowne uruchomienie instalatora ze strony (aktualizacja w miejscu)

Preferowaną ścieżką aktualizacji jest ponowne uruchomienie instalatora ze strony internetowej. Wykrywa on istniejące instalacje, aktualizuje je w miejscu i uruchamia openclaw doctor w razie potrzeby. 
curl -fsSL https://openclaw.ai/install.sh | bash
Uwagi:
  • Dodaj --no-onboard, jeśli nie chcesz, aby kreator onboardingu uruchomił się ponownie.
  • Dla instalacji ze źródeł użyj: 
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
    Instalator wykona git pull --rebase tylko wtedy, gdy repozytorium jest czyste.
  • Dla instalacji globalnych skrypt pod spodem używa npm install -g openclaw@latest.
  • starszych wersji: clawdbot pozostaje dostępne jako warstwa kompatybilności.

​
Zanim zaktualizujesz

  • Wiedz, jak instalowałeś: globalnie (npm/pnpm) czy ze źródeł (git clone).
  • Wiedz, jak działa Twój Gateway: terminal na pierwszym planie czy usługa nadzorowana (launchd/systemd).
  • Zrób zrzut krawędzi:
    • Konfiguracja: ~/.openclaw/openclaw.json
    • Poświadczenia: ~/.openclaw/credentials/
    • Obszar roboczy: ~/.openclaw/workspace

​
Aktualizacja (instalacja globalna)

Instalacja globalna (wybierz jedną): 
npm i -g openclaw@latest

pnpm add -g openclaw@latest
Nie zalecamy Bun jako środowiska uruchomieniowego Gateway (błędy WhatsApp/Telegram). Aby przełączyć kanały aktualizacji (instalacje git + npm): 
openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable
Użyj --tag <dist-tag|version> dla jednorazowego tagu/wersji instalacji. Zobacz Kanały rozwojowe, aby poznać semantykę kanałów i informacje o wydaniach. Uwaga: w instalacjach npm gateway przy starcie zapisuje wskazówkę o aktualizacji (sprawdza bieżący tag kanału). Wyłącz przez update.checkOnStart: false. Następnie: 
openclaw doctor
openclaw gateway restart
openclaw health
Uwagi:
  • Jeśli Gateway działa jako usługa, openclaw gateway restart jest preferowane zamiast zabijania PID-ów.
  • Jeśli jesteś przypięty do konkretnej wersji, zobacz „Wycofywanie / przypinanie” poniżej.

​
Aktualizacja (openclaw update)

Dla instalacji ze źródeł (git checkout) preferuj: 
openclaw update
Uruchamia to „w miarę bezpieczny” przepływ aktualizacji:
  • Wymaga czystego drzewa roboczego.
  • Przełącza na wybrany kanał (tag lub gałąź).
  • Pobiera zmiany i wykonuje rebase względem skonfigurowanego upstreamu (kanał dev).
  • Instaluje zależności, buduje, buduje Control UI i uruchamia openclaw doctor.
  • Domyślnie restartuje gateway (użyj --no-restart, aby pominąć).
Jeśli instalowałeś przez npm/pnpm (bez metadanych git), openclaw update spróbuje zaktualizować przez menedżera pakietów. Jeśli nie wykryje instalacji, użyj zamiast tego „Aktualizacja (instalacja globalna)”.

​
Aktualizacja (Control UI / RPC)

Control UI ma opcję Update & Restart (RPC: update.run). Działa ona następująco:
  1. Uruchamia ten sam przepływ aktualizacji ze źródeł co openclaw update (tylko git checkout).
  2. Zapisuje znacznik restartu ze strukturalnym raportem (ogon stdout/stderr).
  3. Restartuje gateway i wysyła raport do ostatniej aktywnej sesji.
Jeśli rebase się nie powiedzie, gateway przerywa i restartuje się bez zastosowania aktualizacji.

​
Aktualizacja (ze źródeł)

Z checkoutu repozytorium: Preferowane: 
openclaw update
Ręcznie (w przybliżeniu równoważne): 
git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health
Uwagi:
  • pnpm build ma znaczenie, gdy uruchamiasz spakowany plik binarny openclaw (openclaw.mjs) lub używasz Node do uruchomienia dist/.
  • Jeśli uruchamiasz z checkoutu repozytorium bez instalacji globalnej, używaj pnpm openclaw ... do poleceń CLI.
  • Jeśli uruchamiasz bezpośrednio z TypeScript (pnpm openclaw ...), przebudowa zwykle nie jest konieczna, ale migracje konfiguracji nadal obowiązują → uruchom doctor.
  • Przełączanie między instalacjami globalnymi i git jest łatwe: zainstaluj drugi wariant, a następnie uruchom openclaw doctor, aby wpis usługi gateway został przepisany na bieżącą instalację.

​
Zawsze uruchamiaj: openclaw doctor

Doctor to polecenie „bezpiecznej aktualizacji”. Jest celowo proste: naprawa + migracja + ostrzeżenia. Uwaga: jeśli korzystasz z instalacji ze źródeł (git checkout), openclaw doctor zaproponuje najpierw uruchomienie openclaw update. Typowe działania:
  • Migracja przestarzałych kluczy konfiguracji / starszych lokalizacji plików konfiguracyjnych.
  • Audyt polityk DM i ostrzeżenia o ryzykownych „otwartych” ustawieniach.
  • Sprawdzenie kondycji Gateway i możliwość zaproponowania restartu.
  • Wykrywanie i migracja starszych usług gateway (launchd/systemd; legacy schtasks) do bieżących usług OpenClaw.
  • Na Linuksie: zapewnienie włączonego lingeringu użytkownika systemd (aby Gateway przetrwał wylogowanie).
Szczegóły: Doctor

​
Uruchamianie / zatrzymywanie / restart Gateway

CLI (działa niezależnie od systemu): 
openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow
Jeśli masz nadzór usług:
  • macOS launchd (LaunchAgent dołączony do aplikacji): launchctl kickstart -k gui/$UID/bot.molt.gateway (użyj bot.molt.<profile>; starsze com.openclaw.* nadal działa)
  • Linux systemd (usługa użytkownika): systemctl --user restart openclaw-gateway[-<profile>].service
  • Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
    • launchctl/systemctl działają tylko, jeśli usługa jest zainstalowana; w przeciwnym razie uruchom openclaw gateway install.
Runbook + dokładne etykiety usług: Gateway runbook

​
Wycofywanie / przypinanie (gdy coś się psuje)

​
Przypinanie (instalacja globalna)

Zainstaluj znaną, działającą wersję (zastąp <version> ostatnią działającą): 
npm i -g openclaw@<version>

pnpm add -g openclaw@<version>
Wskazówka: aby zobaczyć aktualnie opublikowaną wersję, uruchom npm view openclaw version. Następnie restart + ponowne uruchomienie doctor: 
openclaw doctor
openclaw gateway restart

​
Przypinanie (ze źródeł) według daty

Wybierz commit z danej daty (przykład: „stan main na dzień 2026-01-01”): 
git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
Następnie ponownie zainstaluj zależności + restart: 
pnpm install
pnpm build
openclaw gateway restart
Jeśli później chcesz wrócić do najnowszej wersji: 
git checkout main
git pull

​
Jeśli utknąłeś