Instalacja

Wykonałeś już kroki z Pierwsze kroki? Wszystko gotowe — ta strona opisuje alternatywne metody instalacji, instrukcje dla konkretnych platform i konserwację.

Wymagania systemowe

Node 24 (zalecany) (Node 22 LTS, aktualnie 22.16+, jest nadal wspierany ze względu na kompatybilność; skrypt instalacyjny zainstaluje Node 24, jeśli go brakuje)
macOS, Linux lub Windows
pnpm tylko przy budowaniu ze źródeł

Uwaga: Na Windowsie zdecydowanie zalecamy uruchamianie OpenClaw pod WSL2.

Metody instalacji

Wskazówka: Skrypt instalacyjny to zalecany sposób instalacji OpenClaw. Wykrywa Node, instaluje go i przeprowadza onboarding w jednym kroku.

Ostrzeżenie: W przypadku hostów VPS/cloud unikaj obrazów z marketplace typu „1-click” od innych dostawców. Wybierz czysty obraz bazowy systemu (np. Ubuntu LTS), a następnie zainstaluj OpenClaw samodzielnie za pomocą skryptu instalacyjnego.

Skrypt instalacyjny

Pobiera CLI, instaluje je globalnie przez npm i uruchamia kreator onboardingu.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



To wszystko — skrypt zajmuje się wykrywaniem Node, instalacją i onboardingiem.

Aby pominąć onboarding i zainstalować sam plik binarny:


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

  #### Windows (PowerShell)
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```



Wszystkie flagi, zmienne środowiskowe i opcje CI/automatyzacji znajdziesz w [Szczegóły instalatora](/docs/install/installer).

npm / pnpm

Jeśli sam zarządzasz Node, zalecamy Node 24. OpenClaw nadal wspiera Node 22 LTS, aktualnie `22.16+`, ze względu na kompatybilność:


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

Błędy budowania sharp?

      Jeśli masz globalnie zainstalowane libvips (częste na macOS przez Homebrew) i `sharp` nie działa, wymuś prekompilowane pliki binarne:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Jeśli widzisz `sharp: Please add node-gyp to your dependencies`, zainstaluj narzędzia do budowania (macOS: Xcode CLT + `npm install -g node-gyp`) lub użyj powyższej zmiennej środowiskowej.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # zatwierdź openclaw, node-llama-cpp, sharp itd.
    openclaw onboard --install-daemon
    ```

    > **Uwaga:** pnpm wymaga jawnego zatwierdzenia pakietów ze skryptami budowania. Po pierwszej instalacji, gdy zobaczysz ostrzeżenie „Ignored build scripts", uruchom `pnpm approve-builds -g` i wybierz wymienione pakiety.

Ze źródeł

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


  ### Krok 1: Sklonuj i zbuduj
    Sklonuj [repozytorium OpenClaw](https://github.com/openclaw/openclaw) i zbuduj:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Krok 2: Podlinkuj CLI
    Udostępnij komendę `openclaw` globalnie:

    ```bash
    pnpm link --global
    ```

    Alternatywnie pomiń linkowanie i uruchamiaj komendy przez `pnpm openclaw ...` z katalogu repozytorium.

  ### Krok 3: Uruchom onboarding
    ```bash
    openclaw onboard --install-daemon
    ```



Więcej o przepływach pracy deweloperskiej znajdziesz w [Konfiguracja](/docs/start/setup).

Inne metody instalacji

Docker — Kontenerowe lub bezobsługowe wdrożenia.
Podman — Kontener rootless: uruchom raz setup-podman.sh, a potem skrypt startowy.
Nix — Deklaratywna instalacja przez Nix.
Ansible — Zautomatyzowane wdrażanie na wiele maszyn.
Bun — Użycie CLI przez runtime Bun.

Po instalacji

Sprawdź, czy wszystko działa:

openclaw doctor         # sprawdź problemy z konfiguracją
openclaw status         # status bramy
openclaw dashboard      # otwórz interfejs w przeglądarce

Jeśli potrzebujesz niestandardowych ścieżek runtime, użyj:

OPENCLAW_HOME dla ścieżek wewnętrznych opartych o katalog domowy
OPENCLAW_STATE_DIR dla lokalizacji zmiennego stanu
OPENCLAW_CONFIG_PATH dla lokalizacji pliku konfiguracyjnego

Szczegóły i kolejność priorytetów znajdziesz w Zmienne środowiskowe.

Rozwiązywanie problemów: nie znaleziono `openclaw`

Diagnostyka PATH i naprawa

Szybka diagnostyka:

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 plików binarnych npm (w tym openclaw).

Naprawa — dodaj do pliku startowego powłoki (~/.zshrc lub ~/.bashrc):

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

Na Windowsie dodaj wynik npm prefix -g do zmiennej PATH.

Następnie otwórz nowy terminal (lub rehash w zsh / hash -r w bash).

Aktualizacja / odinstalowanie

Aktualizacja — Utrzymuj OpenClaw w aktualnej wersji.
Migracja — Przenieś na nową maszynę.
Odinstalowanie — Całkowicie usuń OpenClaw.