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.16 lub nowszego. Node 24 jest domyślnym i zalecanym środowiskiem uruchomieniowym dla instalacji, CI i przepływów wydań. Node 22 pozostaje wspierany w ramach aktywnej linii LTS. Skrypt instalacyjny 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 polecenie wypisze v24.x.x lub nowszą wersję, używasz zalecanej wartości domyślnej. Jeśli wypisze v22.16.x lub nowszą 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):

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 na macOS/Linux
  • mise - wielojęzykowy (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) lub <npm-prefix> (Windows) w wyniku.

  • Add it to your shell startup file

    macOS / Linux

    Dodaj do ~/.zshrc lub ~/.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, zmień globalny prefiks 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 lub ~/.zshrc, aby zmiana była trwała.

    Powiązane

    Was this useful?