English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Install overview

Node.js

OpenClaw wymaga Node 22.19+, Node 23.11+ albo Node 24+. 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 instalatora automatycznie wykryje i zainstaluje Node - ta strona jest przeznaczona dla sytuacji, gdy chcesz samodzielnie skonfigurować Node i upewnić się, że wszystko jest poprawnie połączone (wersje, PATH, instalacje globalne).

Sprawdź swoją wersję

bash
node -v

Jeśli to polecenie wypisze v24.x.x lub nowszą wersję, używasz zalecanej domyślnej wersji. Jeśli wypisze v22.19.x lub nowszą, używasz obsługiwanej ścieżki Node 22 LTS, ale nadal zalecamy przejście na Node 24, gdy będzie to wygodne. Wersje Node 23 wcześniejsze niż v23.11.0 nie są obsługiwane. Jeśli Node nie jest zainstalowany albo wersja jest poza obsługiwanym zakresem, wybierz jedną z poniższych metod instalacji.

Zainstaluj Node

macOS

Homebrew (zalecane):

bash
brew install node

Albo pobierz instalator dla macOS z 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

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

Windows

winget (zalecane):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Albo pobierz instalator dla Windows z nodejs.org.

Using a version manager (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:

bash
fnm install 24fnm use 24

Rozwiązywanie problemów

openclaw: command not found

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

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

    bash
    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, przełącz globalny prefix npm na katalog zapisywalny przez użytkownika:

    bash
    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 albo ~/.zshrc, aby utrwalić tę zmianę.

    Powiązane

    Was this useful?
    On this page

    On this page