Instalacja

# Wymagania systemowe

• Node 24 (zalecane) albo Node 22.14+ - skrypt instalacyjny obsługuje to automatycznie
• macOS, Linux albo Windows - obsługiwany jest zarówno natywny Windows, jak i WSL2; WSL2 jest stabilniejszy. Zobacz Windows.
• pnpm jest potrzebny tylko wtedy, gdy budujesz ze źródeł

# Zalecane: skrypt instalacyjny

Najszybszy sposób instalacji. Wykrywa Twój system operacyjny, instaluje Node, jeśli potrzeba, instaluje OpenClaw i uruchamia wdrożenie.

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

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

Aby zainstalować bez uruchamiania wdrożenia:

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

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

Wszystkie flagi oraz opcje CI/automatyzacji znajdziesz w sekcji Szczegóły wewnętrzne instalatora.

# Alternatywne metody instalacji

# Instalator z lokalnym prefiksem (install-cli.sh)

Użyj tego, gdy chcesz trzymać 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 wewnętrzne instalatora.

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

# npm, pnpm albo bun

Jeśli samodzielnie zarządzasz już Node:

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

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# Ze źródeł

Dla kontrybutorów lub osób, które chcą uruchamiać z lokalnego checkoutu:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

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

# Instalacja z GitHub main

npm install -g github:openclaw/openclaw#main

# Kontenery i menedżery pakietów

# Weryfikacja instalacji

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

Jeśli po instalacji chcesz zarządzane uruchamianie przy starcie:

• macOS: LaunchAgent przez openclaw onboard --install-daemon albo 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:

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

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