> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalacja

# Instalacja

Masz już za sobą [Pierwsze kroki](/start/getting-started)? Świetnie — ta strona dotyczy alternatywnych metod instalacji, instrukcji specyficznych dla platform oraz utrzymania.

## Wymagania systemowe

* **[Node 22+](/install/node)** ([skrypt instalatora](#install-methods) zainstaluje go, jeśli go brakuje)
* macOS, Linux lub Windows
* `pnpm` tylko jeśli budujesz ze źródeł

<Note>
  W systemie Windows zdecydowanie zalecamy uruchamianie OpenClaw w [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install).
</Note>

## Metody instalacji

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

<AccordionGroup>
  <Accordion title="Installer script" icon="rocket" defaultOpen>
    Pobiera CLI, instaluje je globalnie przez npm i uruchamia kreator onboardingu.

    <Tabs>
      <Tab title="macOS / Linux / WSL2">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        & ([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).
  </Accordion>

  <Accordion title="npm / pnpm" icon="package">
    Jeśli masz już Node 22+ i wolisz samodzielnie zarządzać instalacją:

    <Tabs>
      <Tab title="npm">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
          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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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>
  </Accordion>

  <Accordion title="From source" icon="github">
    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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        pnpm link --global
        ```

        Alternatywnie pomiń linkowanie i uruchamiaj polecenia przez `pnpm openclaw ...` z poziomu repozytorium.
      </Step>

      <Step title="Uruchom onboarding">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --install-daemon
        ```
      </Step>
    </Steps>

    Bardziej zaawansowane przepływy deweloperskie znajdziesz w [Konfiguracji](/start/setup).
  </Accordion>
</AccordionGroup>

## Inne metody instalacji

<CardGroup cols={2}>
  <Card title="Docker" href="/install/docker" icon="container">
    Wdrożenia kontenerowe lub bez interfejsu.
  </Card>

  <Card title="Podman" href="/install/podman" icon="container">
    Rootless container: run `setup-podman.sh` once, then the launch script.
  </Card>

  <Card title="Nix" href="/install/nix" icon="snowflake">
    Deklaratywna instalacja przez Nix.
  </Card>

  <Card title="Ansible" href="/install/ansible" icon="server">
    Zautomatyzowane wdrażanie floty.
  </Card>

  <Card title="Bun" href="/install/bun" icon="zap">
    Użycie wyłącznie CLI przez środowisko uruchomieniowe Bun.
  </Card>
</CardGroup>

## Po instalacji

Sprawdź, czy wszystko działa poprawnie:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/help/environment), aby poznać kolejność priorytetów i pełne szczegóły.

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

<Accordion title="PATH diagnosis and fix">
  Szybka diagnoza:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  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`):

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  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).
</Accordion>

## Aktualizacja / odinstalowanie

<CardGroup cols={3}>
  <Card title="Updating" href="/install/updating" icon="refresh-cw">
    Utrzymuj OpenClaw na bieżąco.
  </Card>

  <Card title="Migrating" href="/install/migrating" icon="arrow-right">
    Przenieś się na nową maszynę.
  </Card>

  <Card title="Uninstall" href="/install/uninstall" icon="trash-2">
    Całkowicie usuń OpenClaw.
  </Card>
</CardGroup>