Przejdź do głównej treści

​
Instalacja

Masz już za sobą Pierwsze kroki? Świetnie — ta strona dotyczy alternatywnych metod instalacji, instrukcji specyficznych dla platform oraz utrzymania.

​
Wymagania systemowe

  • Node 22+ (skrypt instalatora zainstaluje go, jeśli go brakuje)
  • macOS, Linux lub Windows
  • pnpm tylko jeśli budujesz ze źródeł
W systemie Windows zdecydowanie zalecamy uruchamianie OpenClaw w WSL2.

​
Metody instalacji

Skrypt instalatora to zalecany sposób instalacji OpenClaw. W jednym kroku obsługuje wykrywanie Node, instalację oraz onboarding.

Installer script

Pobiera CLI, instaluje je globalnie przez npm i uruchamia kreator onboardingu.
curl -fsSL https://openclaw.ai/install.sh | bash
To wszystko — skrypt zajmuje się wykrywaniem Node, instalacją i onboardingiem.Aby pominąć onboarding i tylko zainstalować binarkę:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Wszystkie flagi, zmienne środowiskowe oraz opcje CI/automatyzacji znajdziesz w Wnętrzu instalatora.
Jeśli masz już Node 22+ i wolisz samodzielnie zarządzać instalacją:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Jeśli masz globalnie zainstalowane libvips (częste na macOS przez Homebrew) i sharp kończy się niepowodzeniem, wymuś prekompilowane binaria:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Jeśli zobaczysz sharp: Please add node-gyp to your dependencies, zainstaluj narzędzia do budowania (macOS: Xcode CLT + npm install -g node-gyp) albo użyj powyższej zmiennej środowiskowej.
Dla współtwórców lub każdego, kto chce uruchamiać z lokalnego checkoutu.
1

Klonowanie i budowanie

Sklonuj repozytorium OpenClaw i zbuduj:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

Podlinkowanie CLI

Udostępnij polecenie openclaw globalnie:
pnpm link --global
Alternatywnie pomiń linkowanie i uruchamiaj polecenia przez pnpm openclaw ... z poziomu repozytorium.
3

Uruchom onboarding

openclaw onboard --install-daemon
Bardziej zaawansowane przepływy deweloperskie znajdziesz w Konfiguracji.

​
Inne metody instalacji

Docker

Wdrożenia kontenerowe lub bez interfejsu.

Podman

Rootless container: run setup-podman.sh once, then the launch script.

Nix

Deklaratywna instalacja przez Nix.

Ansible

Zautomatyzowane wdrażanie floty.

Bun

Użycie wyłącznie CLI przez środowisko uruchomieniowe Bun.

​
Po instalacji

Sprawdź, czy wszystko działa poprawnie: 
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
Jeśli potrzebujesz niestandardowych ścieżek środowiska uruchomieniowego, użyj:
  • OPENCLAW_HOME dla wewnętrznych ścieżek opartych na katalogu domowym
  • OPENCLAW_STATE_DIR dla lokalizacji zapisywalnego stanu
  • OPENCLAW_CONFIG_PATH dla lokalizacji pliku konfiguracyjnego
Zobacz Environment vars, aby poznać kolejność priorytetów i pełne szczegóły.

​
Rozwiązywanie problemów: nie znaleziono openclaw

Szybka diagnoza:
node -v
npm -v
npm prefix -g
echo "$PATH"
Jeśli $(npm prefix -g)/bin (macOS/Linux) lub $(npm prefix -g) (Windows) nie znajduje się w Twoim $PATH, Twoja powłoka nie może znaleźć globalnych binariów npm (w tym openclaw).Naprawa — dodaj to do pliku startowego powłoki (~/.zshrc lub ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
W systemie Windows dodaj wynik polecenia npm prefix -g do PATH.Następnie otwórz nowy terminal (lub rehash w zsh / hash -r w bash).

​
Aktualizacja / odinstalowanie

Updating

Utrzymuj OpenClaw na bieżąco.

Migrating

Przenieś się na nową maszynę.

Uninstall

Całkowicie usuń OpenClaw.