OpenClawDocs
Na tej stronie

Na tej stronie

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

Runtimes

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?