Przejdź do głównej treści

​
Node.js

OpenClaw wymaga Node 22 lub nowszego. Skrypt instalatora wykryje i zainstaluje Node automatycznie — ta strona jest przeznaczona dla przypadków, gdy chcesz skonfigurować Node samodzielnie i upewnić się, że wszystko jest poprawnie połączone (wersje, PATH, instalacje globalne).

​
Sprawdź wersję

node -v
Jeśli to polecenie wypisze v22.x.x lub wyższą wersję, wszystko jest w porządku. Jeśli Node nie jest zainstalowany lub wersja jest zbyt stara, wybierz jedną z metod instalacji poniżej.

​
Instalacja Node

Homebrew (zalecane):
````
```bash
brew install node
```

Lub pobierz instalator macOS z [nodejs.org](https://nodejs.org/).
````
Menedżery wersji umożliwiają łatwe przełączanie się między wersjami Node. Popularne opcje:
  • fnm — szybki, wieloplatformowy
  • nvm — szeroko używany na macOS/Linux
  • mise — poliglot (Node, Python, Ruby itd.)
Przykład z fnm:
fnm install 22
fnm use 22
Upewnij się, że menedżer wersji jest inicjalizowany w pliku startowym powłoki (~/.zshrc lub ~/.bashrc). Jeśli nie, 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

Zazwyczaj oznacza to, ż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 wyjściu.
```
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 (lub 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 linię export PATH=... do ~/.bashrc lub ~/.zshrc, aby zmiana była trwała.