Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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ę

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

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 na macOS/Linux
  • mise - wielojęzykowy (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). Jeśli nie jest, openclaw może nie być znajdowany 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) lub <npm-prefix> (Windows) w wyniku.
3

Add it to your shell startup file

Dodaj do ~/.zshrc lub ~/.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, zmień 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 wiersz export PATH=... do ~/.bashrc lub ~/.zshrc, aby zmiana była trwała.

​
Powiązane