Instalacja

Wymagania systemowe

• Node 22.22.3+, 24.15+ lub 25.9+ — Node 24 jest domyślną wersją docelową; skrypt instalacyjny obsługuje to automatycznie.
• macOS, Linux lub Windows — użytkownicy systemu Windows mogą zacząć od natywnej aplikacji Windows Hub, instalatora CLI dla PowerShell lub Gateway w WSL2. Zobacz Windows.
• pnpm jest wymagany tylko w przypadku kompilowania ze źródeł.

Zalecane: skrypt instalacyjny

Najszybszy sposób instalacji. Wykrywa system operacyjny, w razie potrzeby instaluje Node, instaluje OpenClaw i uruchamia konfigurację początkową.

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

iwr -useb https://openclaw.ai/install.ps1 | iex

Aby zainstalować bez uruchamiania konfiguracji początkowej:

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Opis wszystkich flag oraz opcji CI i automatyzacji znajduje się w sekcji Szczegóły działania instalatora.

Alternatywne metody instalacji

Instalator z lokalnym prefiksem (install-cli.sh)

Tej metody należy użyć, aby przechowywać OpenClaw i Node pod lokalnym prefiksem, takim jak ~/.openclaw, bez zależności od ogólnosystemowej instalacji Node:

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

Domyślnie obsługuje instalacje npm, a także instalacje z kopii roboczej git w ramach tego samego przepływu z prefiksem. Pełna dokumentacja: Szczegóły działania instalatora.

OpenClaw jest już zainstalowany? Między instalacjami z pakietu i z repozytorium git można przełączać się za pomocą openclaw update --channel dev i openclaw update --channel stable. Zobacz Aktualizowanie.

npm, pnpm lub bun

Jeśli środowisko Node jest już zarządzane samodzielnie:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Ze źródeł

Dla współtwórców lub osób, które chcą uruchamiać OpenClaw z lokalnej kopii roboczej:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Można też pominąć tworzenie dowiązania i użyć pnpm openclaw ... wewnątrz repozytorium. Pełny opis przepływów programistycznych znajduje się w sekcji Konfiguracja.

Instalacja z głównej kopii roboczej repozytorium GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Kontenery i menedżery pakietów

Weryfikacja instalacji

openclaw --version      # sprawdź, czy CLI jest dostępnyopenclaw doctor         # sprawdź problemy z konfiguracjąopenclaw gateway status # sprawdź, czy Gateway działa

Aby po instalacji skonfigurować zarządzane uruchamianie:

• macOS: LaunchAgent za pomocą openclaw onboard --install-daemon lub openclaw gateway install
• Linux/WSL2: usługa użytkownika systemd za pomocą tych samych poleceń
• Natywny Windows: najpierw zadanie harmonogramu, a jeśli utworzenie zadania zostanie odrzucone — awaryjnie element logowania w folderze Autostart użytkownika

Hosting i wdrażanie

OpenClaw można wdrożyć na serwerze w chmurze lub VPS. Pełny wybór dostawców (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi i inni) znajduje się w sekcji Serwer Linux. Można też wdrożyć system deklaratywnie na Render.

Aktualizowanie, migracja lub odinstalowywanie

Rozwiązywanie problemów: nie znaleziono openclaw

Prawie zawsze oznacza to problem ze zmienną PATH: globalny katalog plików binarnych npm nie znajduje się w zmiennej PATH powłoki. Pełne rozwiązanie, w tym ścieżkę dla systemu Windows, opisano w sekcji Rozwiązywanie problemów z Node.js.

node -v           # Czy Node jest zainstalowany?npm prefix -g     # Gdzie znajdują się pakiety globalne?echo "$PATH"      # Czy globalny katalog plików binarnych znajduje się w PATH?