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.

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

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

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

Aby pominąć onboarding i tylko zainstalować binarkę:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

Wszystkie flagi, zmienne środowiskowe oraz opcje CI/automatyzacji znajdziesz w [Wnętrzu instalatora](/install/installer).
```

Jeśli masz już Node 22+ i wolisz samodzielnie zarządzać instalacją:

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="błędy budowania sharp?">
      Jeśli masz globalnie zainstalowane libvips (częste na macOS przez Homebrew) i `sharp` kończy się niepowodzeniem, wymuś prekompilowane binaria:

      ```bash
      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.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm wymaga jawnej zgody dla pakietów ze skryptami budowania. Po pierwszej instalacji, gdy pojawi się ostrzeżenie „Ignored build scripts”, uruchom `pnpm approve-builds -g` i wybierz wymienione pakiety.
    </Note>
  </Tab>
</Tabs>
```

Dla współtwórców lub każdego, kto chce uruchamiać z lokalnego checkoutu.

```
<Steps>
  <Step title="Klonowanie i budowanie">
    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
    ```
  </Step>
  <Step title="Podlinkowanie CLI">
    Udostępnij polecenie `openclaw` globalnie:

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

    Alternatywnie pomiń linkowanie i uruchamiaj polecenia przez `pnpm openclaw ...` z poziomu repozytorium.
  </Step>
  <Step title="Uruchom onboarding">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

Bardziej zaawansowane przepływy deweloperskie znajdziesz w [Konfiguracji](/start/setup).
```

Inne metody instalacji¶

Wdrożenia kontenerowe lub bez interfejsu. Deklaratywna instalacja przez Nix. Zautomatyzowane wdrażanie floty. 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

If you need custom runtime paths, use:

• OPENCLAW_HOME for home-directory based internal paths
• OPENCLAW_STATE_DIR for mutable state location
• OPENCLAW_CONFIG_PATH for config file location

See Environment vars for precedence and full details.

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¶

Utrzymuj OpenClaw na bieżąco. Przenieś się na nową maszynę. Całkowicie usuń OpenClaw.