Node.js¶

OpenClaw wymaga Node 22 lub nowszego. Skrypt instalatora wykryje i zainstaluje Node automatycznie — ta strona jest przeznaczona dla przypadków, gdy chcesz skonfigurować Node samodzielnie i upewnić się, że wszystko jest poprawnie połączone (wersje, PATH, instalacje globalne).

Sprawdź wersję¶

node -v

Jeśli to polecenie wypisze v22.x.x lub wyższą wersję, wszystko jest w porządku. Jeśli Node nie jest zainstalowany lub wersja jest zbyt stara, wybierz jedną z metod instalacji poniżej.

Instalacja Node¶

Homebrew (zalecane):

````
```bash
brew install node
```

Lub pobierz instalator macOS z [nodejs.org](https://nodejs.org/).
````

Ubuntu / Debian:

````
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Lub użyj menedżera wersji (zobacz poniżej).
````

winget (zalecane):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Lub pobierz instalator Windows z [nodejs.org](https://nodejs.org/).
````

Menedżery wersji umożliwiają łatwe przełączanie się między wersjami Node. Popularne opcje:

• fnm — szybki, wieloplatformowy
• nvm — szeroko używany na macOS/Linux
• mise — poliglot (Node, Python, Ruby itd.)

Przykład z fnm:

fnm install 22
fnm use 22

Upewnij się, że menedżer wersji jest inicjalizowany w pliku startowym powłoki (~/.zshrc lub ~/.bashrc). Jeśli nie, openclaw może nie zostać znalezione w nowych sesjach terminala, ponieważ PATH nie będzie zawierać katalogu bin Node.

Rozwiązywanie problemów¶

openclaw: command not found¶

Zazwyczaj oznacza to, że globalny katalog bin npm nie znajduje się w PATH.

bash npm prefix -g bash echo "$PATH"

```
Poszukaj `<npm-prefix>/bin` (macOS/Linux) lub `<npm-prefix>` (Windows) w wyjściu.
```

Dodaj do ~/.zshrc lub ~/.bashrc:

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

        Następnie otwórz nowy terminal (lub uruchom `rehash` w zsh / `hash -r` w bash).
      </Tab>
      <Tab title="Windows">
        Dodaj wynik `npm prefix -g` do systemowego PATH przez Ustawienia → System → Zmienne środowiskowe.
      </Tab>
    </Tabs>
    ```

Błędy uprawnień przy npm install -g (Linux)¶

Jeśli widzisz błędy EACCES, zmień globalny prefiks npm na katalog zapisywalny przez użytkownika:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Dodaj linię export PATH=... do ~/.bashrc lub ~/.zshrc, aby zmiana była trwała.