Node.js

OpenClaw wymaga Node 22.16 lub nowszego. Node 24 jest domyślnym i zalecanym runtime do instalacji, CI i procesów wydawniczych. Node 22 pozostaje wspierany przez aktywną linię LTS. Skrypt instalacyjny automatycznie wykryje i zainstaluje Node — ta strona jest na wypadek, gdy chcesz samodzielnie skonfigurować Node i upewnić się, że wszystko jest poprawnie połączone (wersje, PATH, globalne instalacje).

Sprawdź swoją wersję

node -v

Jeśli wyświetli v24.x.x lub wyżej, masz zalecaną domyślną wersję. Jeśli wyświetli v22.16.x lub wyżej, jesteś na wspieranej ścieżce Node 22 LTS, ale nadal zalecamy aktualizację do Node 24 przy okazji. Jeśli Node nie jest zainstalowany lub wersja jest za stara, wybierz jedną z poniższych metod instalacji.

Instalacja Node

macOS

**Homebrew** (zalecany):

```bash
brew install node
```

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

Linux

**Ubuntu / Debian:**

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Lub użyj menedżera wersji (patrz niżej).

Windows

**winget** (zalecany):

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

**Chocolatey:**

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

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

Menedżer wersji (nvm, fnm, mise, asdf)

Menedżery wersji pozwalają łatwo przełączać się między wersjami Node. Popularne opcje:

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

Przykład z fnm:

fnm install 24
fnm use 24

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

Rozwiązywanie problemów

`openclaw: command not found`

To prawie zawsze oznacza, że globalny katalog bin npm nie jest w twoim PATH.

Krok 1: Znajdź swój globalny prefix npm

```bash
npm prefix -g
```

Krok 2: Sprawdź, czy jest w twoim PATH

```bash
echo "$PATH"
```

Szukaj `<npm-prefix>/bin` (macOS/Linux) lub `<npm-prefix>` (Windows) w wyniku.

Krok 3: Dodaj do pliku startowego powłoki

  #### macOS / Linux
    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).

  #### Windows
    Dodaj wynik `npm prefix -g` do systemowego PATH przez Ustawienia → System → Zmienne środowiskowe.

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

Jeśli widzisz błędy EACCES, zmień globalny prefix npm na katalog z prawami zapisu:

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.