OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

OpenClaw wymaga Node 22.22.3+, Node 24.15+ lub Node 25.9+. Node 24 jest domyślnym i zalecanym środowiskiem uruchomieniowym dla instalacji, CI i procesów wydawania; Node 22 pozostaje obsługiwany w ramach aktywnej linii LTS. Node 23 nie jest obsługiwany. Skrypt instalacyjny automatycznie wykrywa i instaluje Node — z tej strony należy skorzystać, aby samodzielnie skonfigurować Node (wersje, PATH, instalacje globalne).

Sprawdzanie wersji

bash
node -v

v24.15.0 lub nowsza wersja 24.x jest zalecaną wersją domyślną. v22.22.3 lub nowsza wersja 22.x jest obsługiwaną ścieżką Node 22 LTS; Node v25.9.0+ jest również obsługiwany. Node 23 nie jest obsługiwany. Jeśli Node nie jest zainstalowany lub jego wersja jest poza obsługiwanym zakresem, należy wybrać jedną z poniższych metod instalacji.

Instalowanie Node

macOS

Homebrew (zalecane):

bash
brew install node

Można też pobrać instalator dla systemu macOS ze strony nodejs.org.

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

bash
sudo dnf install nodejs

Można też użyć menedżera wersji (patrz poniżej).

Windows

winget (zalecane):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Można też pobrać instalator dla systemu Windows ze strony nodejs.org.

Korzystanie z menedżera wersji (nvm, fnm, mise, asdf)

Menedżery wersji umożliwiają łatwe przełączanie między wersjami Node. Popularne opcje:

  • fnm - szybki, wieloplatformowy
  • nvm - powszechnie używany w systemach macOS/Linux
  • mise - obsługuje wiele języków (Node, Python, Ruby itp.)

Przykład z użyciem fnm:

bash
fnm install 24fnm use 24

Rozwiązywanie problemów

openclaw: command not found

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

  • Znajdowanie globalnego prefiksu npm

    bash
    npm prefix -g

  • Sprawdzanie, czy znajduje się w PATH

    bash
    echo "$PATH"

    W danych wyjściowych należy odszukać <npm-prefix>/bin (macOS/Linux) lub <npm-prefix> (Windows).

  • Dodawanie do pliku startowego powłoki

    macOS / Linux

    Należy dodać do ~/.zshrc lub ~/.bashrc:

    bash
    export PATH="$(npm prefix -g)/bin:$PATH"

    Następnie należy otworzyć nowy terminal (lub uruchomić rehash w zsh albo hash -r w bash).

    Windows

    Należy dodać wynik polecenia npm prefix -g do systemowej zmiennej PATH za pomocą opcji Settings → System → Environment Variables.

    • Błędy uprawnień podczas wykonywania npm install -g (Linux)

    Jeśli występują błędy EACCES, należy zmienić globalny prefiks npm na katalog z prawem zapisu dla użytkownika:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Aby zachować tę zmianę na stałe, należy dodać wiersz export PATH=... do pliku ~/.bashrc lub ~/.zshrc.

    Powiązane materiały

    Was this useful?
    On this page

    On this page