Instalacja Node.js dla OpenClaw — wymagania i konfiguracja

Node.js dla OpenClaw

OpenClaw wymaga Node.js w wersji 22.14 lub nowszej, przy czym zalecana jest wersja Node 24. Ta strona wyjaśnia, jak zainstalować Node.js na każdym popularnym systemie operacyjnym i rozwiązać najczęstsze problemy.

Sprawdzenie zainstalowanej wersji

Zanim przejdziesz do instalacji, sprawdź, czy Node.js jest już dostępny w Twoim systemie:

node -v
# Oczekiwany wynik: v24.x.x lub v22.14+

Jeśli polecenie nie jest rozpoznawane lub zwraca wersję starszą niż 22.14, wykonaj instalację zgodnie z poniższymi instrukcjami.

Instalacja na macOS

Na macOS najprostszą metodą jest Homebrew:

brew install node

Alternatywnie możesz pobrać instalator bezpośrednio ze strony nodejs.org.

Instalacja na Linuksie

Metoda instalacji zależy od dystrybucji:

Ubuntu / Debian

# Dodaj repozytorium NodeSource
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# Zainstaluj Node.js
sudo apt-get install -y nodejs

Fedora / RHEL

sudo dnf install nodejs

Na starszych wersjach Fedory/RHEL może być konieczne dodanie repozytorium NodeSource, aby uzyskać Node 24.

Instalacja na Windows

Na Windows masz kilka opcji:

# Przez winget (zalecane)
winget install OpenJS.NodeJS.LTS

# Przez Chocolatey
choco install nodejs-lts

Możesz też pobrać instalator MSI ze strony nodejs.org.

Menedżery wersji Node.js

Jeśli pracujesz z wieloma projektami wymagającymi różnych wersji Node.js, skorzystaj z menedżera wersji:

• fnm — szybki menedżer wersji napisany w Rust.
• nvm — popularny menedżer dla macOS i Linuksa.
• mise — uniwersalny menedżer narzędzi deweloperskich.

Ważne: Upewnij się, że menedżer wersji jest inicjalizowany w pliku startowym powłoki (np. .bashrc, .zshrc). W przeciwnym razie OpenClaw może nie znaleźć poprawnej wersji Node.js, co prowadzi do problemów z PATH.

Weryfikacja po instalacji

Po zainstalowaniu Node.js zweryfikuj, że wszystko jest na miejscu:

# Sprawdz wersje Node.js
node -v

# Sprawdz wersje npm
npm -v

# Zainstaluj OpenClaw
npm install -g @openclaw/openclaw

# Zweryfikuj instalacje
openclaw --version

Rozwiązywanie problemów

Polecenie openclaw nie znalezione

To najczęstszy problem po instalacji. Oznacza, że katalog globalnych pakietów npm nie znajduje się w zmiennej PATH.

# Znajdz katalog globalny npm
npm config get prefix

# Sprawdz, czy jest w PATH
echo $PATH

Dodaj katalog bin z prefiksu npm do zmiennej PATH w pliku startowym powłoki.

Błąd uprawnień na Linuksie

Jeśli instalacja globalna zwraca błąd EACCES, zmień katalog globalnych pakietów:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Po tej zmianie ponów instalację OpenClaw.