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

macOS
Linux
Windows

Homebrew (zalecane):

````
```bash
brew install node
```

Lub pobierz instalator macOS z [nodejs.org](https://nodejs.org/).
````

Ubuntu / Debian:

````
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Lub użyj menedżera wersji (zobacz poniżej).
````

winget (zalecane):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Lub pobierz instalator Windows z [nodejs.org](https://nodejs.org/).
````

Using a version manager (nvm, fnm, mise, asdf)

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.

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

```
Poszukaj `<npm-prefix>/bin` (macOS/Linux) lub `<npm-prefix>` (Windows) w wyjściu.
```

Add it to your shell startup file

macOS / Linux
Windows

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).

Dodaj wynik npm prefix -g do systemowego PATH przez Ustawienia → System → Zmienne środowiskowe.

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.

Pomoc

Społeczność

Środowisko i debugowanie

Node runtime

Wewnętrzne mechanizmy kompakcji

Konfiguracja deweloperska

Meta dokumentacji

Node.js

Node.js

Sprawdź wersję

Instalacja Node

Rozwiązywanie problemów

`openclaw: command not found`

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

​Node.js

​Sprawdź wersję

​Instalacja Node

​Rozwiązywanie problemów

​openclaw: command not found

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

Node.js

Sprawdź wersję

Instalacja Node

Rozwiązywanie problemów

`openclaw: command not found`

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