Przejdź do głównej treści
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ę

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

Homebrew (zalecane):
brew install node
Albo pobierz instalator dla macOS z nodejs.org.
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:
fnm install 24
fnm use 24
Upewnij się, że menedżer wersji jest inicjowany w pliku startowym powłoki (~/.zshrc albo ~/.bashrc). Jeśli nie jest, openclaw może nie zostać znaleziony w nowych sesjach terminala, ponieważ PATH nie będzie zawierać katalogu bin Node.

​
Rozwiązywanie problemów

​
openclaw: command not found

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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"
Poszukaj <npm-prefix>/bin (macOS/Linux) albo <npm-prefix> (Windows) w wyniku.
3

Add it to your shell startup file

Dodaj do ~/.zshrc albo ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Następnie otwórz nowy terminal (albo 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 prefix 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 wiersz export PATH=... do ~/.bashrc albo ~/.zshrc, aby utrwalić tę zmianę.

​
Powiązane