Instalacja

Wymagania systemowe

• Node 22.19+, 23.11+ lub 24+ — Node 24 jest domyślną wersją docelową; skrypt instalacyjny obsługuje ją 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 potrzebny tylko podczas 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 znajdziesz w sekcji Szczegóły działania instalatora.

Alternatywne metody instalacji

Instalator z lokalnym prefiksem (install-cli.sh)

Użyj go, jeśli chcesz przechowywać OpenClaw i Node w lokalnym prefiksie, 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 za pomocą 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.

Masz już zainstalowany OpenClaw? Przełączaj się między instalacjami z pakietu i git za pomocą openclaw update --channel dev oraz openclaw update --channel stable. Zobacz Aktualizowanie.

npm, pnpm lub bun

Jeśli samodzielnie zarządzasz już Node:

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ć program 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żesz też pominąć tworzenie dowiązania i używać pnpm openclaw ... wewnątrz repozytorium. Pełny opis procesów programistycznych znajdziesz w sekcji Konfiguracja.

Instalacja z głównej kopii roboczej w 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

Weryfikowanie instalacji

openclaw --version      # potwierdź dostępność CLIopenclaw doctor         # sprawdź problemy z konfiguracjąopenclaw gateway status # sprawdź, czy Gateway działa

Jeśli po instalacji chcesz korzystać z zarządzanego uruchamiania:

• 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 Zaplanowane zadanie, a jeśli utworzenie zadania zostanie odrzucone — element logowania w folderze Autostart danego użytkownika

Hosting i wdrażanie

Wdróż OpenClaw 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) znajdziesz w sekcji Serwer Linux. Możesz też wdrożyć go deklaratywnie na Render.

Aktualizowanie, migrowanie lub odinstalowywanie

Rozwiązywanie problemów: nie znaleziono openclaw

Prawie zawsze jest to problem ze zmienną PATH: globalny katalog plików wykonywalnych npm nie znajduje się w zmiennej PATH powłoki. Pełne rozwiązanie, w tym ścieżkę dla systemu Windows, znajdziesz 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 wykonywalnych znajduje się w PATH?