English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

OpenClaw wymaga Node 22.14 lub nowszego. Node 24 jest domyślnym i zalecanym środowiskiem uruchomieniowym dla instalacji, CI i przepływów wydań. Node 22 pozostaje obsługiwany przez aktywną linię LTS. Skrypt instalacyjny automatycznie wykryje i zainstaluje Node - ta strona jest przeznaczona na sytuacje, gdy chcesz samodzielnie skonfigurować Node i upewnić się, że wszystko jest poprawnie połączone (wersje, PATH, instalacje globalne).

Sprawdź swoją wersję

node -v

Jeśli polecenie wypisze v24.x.x lub wyższą wersję, używasz zalecanej domyślnej wersji. Jeśli wypisze v22.14.x lub wyższą wersję, używasz obsługiwanej ścieżki Node 22 LTS, ale nadal zalecamy przejście na Node 24, gdy będzie to wygodne. Jeśli Node nie jest zainstalowany albo wersja jest zbyt stara, wybierz jedną z metod instalacji poniżej.

Zainstaluj Node

macOS

Homebrew (zalecane):

brew install node

Albo pobierz instalator dla macOS z nodejs.org.

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

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

Windows

winget (zalecane):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Albo pobierz instalator dla Windows z nodejs.org.

Używanie menedżera wersji (nvm, fnm, mise, asdf)

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

  • fnm - szybki, wieloplatformowy
  • nvm - powszechnie używany w macOS/Linux
  • mise - wielojęzyczny (Node, Python, Ruby itd.)

Przykład z fnm:

fnm install 24
fnm use 24

Rozwiązywanie problemów

openclaw: command not found

To niemal zawsze oznacza, że globalny katalog bin npm nie znajduje się w PATH.

  • Znajdź globalny prefiks npm

    npm prefix -g

  • Sprawdź, czy znajduje się w PATH

    echo "$PATH"

    Poszukaj <npm-prefix>/bin (macOS/Linux) albo <npm-prefix> (Windows) w wyniku polecenia.

  • Dodaj go do pliku startowego powłoki

    macOS / Linux

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

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

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

    Windows

    Dodaj wynik npm prefix -g do systemowej zmiennej PATH przez Ustawienia → System → Zmienne środowiskowe.

    • 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 wiersz export PATH=... do ~/.bashrc lub ~/.zshrc, aby zmiana była trwała.

    Powiązane