Instalacja

Wymagania systemowe

• Node 24 (zalecane) lub Node 22.19+ - skrypt instalatora obsługuje to automatycznie
• macOS, Linux lub Windows - użytkownicy Windows mogą zacząć od natywnej aplikacji Windows Hub, instalatora CLI dla PowerShell albo Gateway w WSL2. Zobacz Windows.
• pnpm jest potrzebny tylko wtedy, gdy budujesz ze źródeł

Zalecane: skrypt instalatora

Najszybszy sposób instalacji. Wykrywa system operacyjny, instaluje Node w razie potrzeby, instaluje OpenClaw i uruchamia wprowadzenie.

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

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

Aby zainstalować bez uruchamiania wprowadzenia:

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

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

Wszystkie flagi i opcje CI/automatyzacji znajdziesz w sekcji Szczegóły instalatora.

Alternatywne metody instalacji

Instalator z lokalnym prefiksem (install-cli.sh)

Użyj tego, gdy chcesz przechowywać OpenClaw i Node pod lokalnym prefiksem, takim jak ~/.openclaw, bez zależności od systemowej instalacji Node:

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

Domyślnie obsługuje instalacje npm, a także instalacje z checkoutu git w tym samym przepływie prefiksu. Pełna dokumentacja: Szczegóły instalatora.

Masz już instalację? Przełączaj się między instalacjami pakietowymi 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 kontrybutorów lub wszystkich, którzy chcą uruchamiać z lokalnego checkoutu:

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

Możesz też pominąć link i używać pnpm openclaw ... z wnętrza repozytorium. Pełne przepływy deweloperskie znajdziesz w sekcji Konfiguracja.

Instalacja z checkoutu GitHub main

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      # potwierdź, że CLI jest dostępneopenclaw doctor         # sprawdź problemy z konfiguracjąopenclaw gateway status # zweryfikuj, że Gateway działa

Jeśli po instalacji chcesz zarządzane uruchamianie:

• macOS: LaunchAgent przez openclaw onboard --install-daemon lub openclaw gateway install
• Linux/WSL2: usługa użytkownika systemd przez te same polecenia
• Natywny Windows: najpierw zaplanowane zadanie, z awaryjnym elementem logowania w folderze Autostart dla użytkownika, jeśli utworzenie zadania zostanie odrzucone

Hosting i wdrażanie

Wdróż OpenClaw na serwerze w chmurze lub VPS:

Aktualizacja, migracja lub odinstalowanie

Rozwiązywanie problemów: nie znaleziono openclaw

Jeśli instalacja się powiodła, ale openclaw nie jest znajdowany w terminalu:

node -v           # Node zainstalowany?npm prefix -g     # Gdzie są pakiety globalne?echo "$PATH"      # Czy globalny katalog bin jest w PATH?

Jeśli $(npm prefix -g)/bin nie znajduje się w Twoim $PATH, dodaj go do pliku startowego powłoki (~/.zshrc lub ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Następnie otwórz nowy terminal. Więcej szczegółów znajdziesz w sekcji Konfiguracja Node.