Node.js

OpenClaw wymaga Node 22.22.3+, Node 24.15+ lub Node 25.9+. Node 24 jest domyślnym i zalecanym środowiskiem uruchomieniowym dla instalacji, CI i procesów wydawania; Node 22 pozostaje obsługiwany w ramach aktywnej linii LTS. Node 23 nie jest obsługiwany. Skrypt instalacyjny automatycznie wykrywa i instaluje Node — z tej strony należy skorzystać, aby samodzielnie skonfigurować Node (wersje, PATH, instalacje globalne).

Sprawdzanie wersji

node -v

v24.15.0 lub nowsza wersja 24.x jest zalecaną wersją domyślną. v22.22.3 lub nowsza wersja 22.x jest obsługiwaną ścieżką Node 22 LTS; Node v25.9.0+ jest również obsługiwany. Node 23 nie jest obsługiwany. Jeśli Node nie jest zainstalowany lub jego wersja jest poza obsługiwanym zakresem, należy wybrać jedną z poniższych metod instalacji.

Instalowanie Node

macOS
Linux
Windows

Homebrew (zalecane):

brew install node

Można też pobrać instalator dla systemu macOS ze strony nodejs.org.

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

Można też użyć menedżera wersji (patrz poniżej).

winget (zalecane):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Można też pobrać instalator dla systemu Windows ze strony nodejs.org.

Korzystanie z menedżera wersji (nvm, fnm, mise, asdf)

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

fnm - szybki, wieloplatformowy
nvm - powszechnie używany w systemach macOS/Linux
mise - obsługuje wiele języków (Node, Python, Ruby itp.)

Przykład z użyciem fnm:

fnm install 24
fnm use 24

Menedżer wersji należy zainicjować w pliku startowym powłoki (~/.zshrc lub ~/.bashrc). W przeciwnym razie polecenie 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`

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

Znajdowanie globalnego prefiksu npm

npm prefix -g

Sprawdzanie, czy znajduje się w PATH

echo "$PATH"

W danych wyjściowych należy odszukać <npm-prefix>/bin (macOS/Linux) lub <npm-prefix> (Windows).

Dodawanie do pliku startowego powłoki

macOS / Linux
Windows

Należy dodać do ~/.zshrc lub ~/.bashrc:

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

Następnie należy otworzyć nowy terminal (lub uruchomić rehash w zsh albo hash -r w bash).

Należy dodać wynik polecenia npm prefix -g do systemowej zmiennej PATH za pomocą opcji Settings → System → Environment Variables.

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

Jeśli występują błędy EACCES, należy zmienić globalny prefiks npm na katalog z prawem zapisu dla użytkownika:

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

Aby zachować tę zmianę na stałe, należy dodać wiersz export PATH=... do pliku ~/.bashrc lub ~/.zshrc.

Powiązane materiały

Omówienie instalacji - wszystkie metody instalacji
Aktualizowanie - utrzymywanie aktualnej wersji OpenClaw
Pierwsze kroki - pierwsze kroki po instalacji

Install overview

Maintenance

Containers

Hosting

Advanced setup

Sprawdzanie wersji

Instalowanie Node

Rozwiązywanie problemów

`openclaw: command not found`

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

Powiązane materiały

​Sprawdzanie wersji

​Instalowanie Node

​Rozwiązywanie problemów

​openclaw: command not found

​Błędy uprawnień podczas wykonywania npm install -g (Linux)

​Powiązane materiały

Sprawdzanie wersji

Instalowanie Node

Rozwiązywanie problemów

`openclaw: command not found`

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

Powiązane materiały