Przejdź do głównej treści

​
Node.js

OpenClaw wymaga Node 22.14 lub nowszego. Node 24 jest domyślnym i zalecanym środowiskiem runtime dla instalacji, CI i procesów wydawniczych. Node 22 pozostaje obsługiwany 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ę

node -v
Jeśli polecenie wypisze v24.x.x lub nowszą wersję, używasz zalecanej domyślnej wersji. Jeśli wypisze v22.14.x lub nowszą wersję, korzystasz z obsługiwanej ścieżki Node 22 LTS, ale nadal zalecamy aktualizację do 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

Homebrew (zalecane):
brew install node
Możesz też pobrać instalator macOS z nodejs.org.
Menedżery wersji pozwalają łatwo przełączać się między wersjami Node. Popularne opcje:
  • fnm — szybki, wieloplatformowy
  • nvm — szeroko używany na macOS/Linux
  • mise — wielojęzyczny (Node, Python, Ruby itd.)
Przykład z fnm:
fnm install 24
fnm use 24
Upewnij się, że menedżer wersji jest inicjalizowany w pliku startowym powłoki (~/.zshrc lub ~/.bashrc). W przeciwnym razie openclaw może nie być znajdowane w nowych sesjach terminala, ponieważ PATH nie będzie zawierać katalogu binarnego Node.

​
Rozwiązywanie problemów

​
openclaw: command not found

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

Znajdź globalny prefiks npm

npm prefix -g
2

Sprawdź, czy jest w PATH

echo "$PATH"
Poszukaj <npm-prefix>/bin (macOS/Linux) lub <npm-prefix> (Windows) w danych wyjściowych.
3

Dodaj go do pliku startowego powłoki

Dodaj do ~/.zshrc lub ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Następnie otwórz nowy terminal (lub uruchom rehash w zsh / hash -r w bash).

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

Jeśli widzisz błędy EACCES, przełącz 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 linię export PATH=... do ~/.bashrc lub ~/.zshrc, aby zmiana była trwała.

​
Powiązane