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.19+, Node 23.11+ lub Node 24+. Node 24 jest domyślnym i zalecanym środowiskiem uruchomieniowym dla instalacji, CI i procesów wydawniczych; Node 22 pozostaje obsługiwany w ramach aktywnej linii LTS. Skrypt instalacyjny automatycznie wykrywa i instaluje Node — skorzystaj z tej strony, jeśli chcesz samodzielnie skonfigurować Node (wersje, PATH, instalacje globalne).

Sprawdź swoją wersję

bash
node -v

Zalecanym domyślnym wyborem jest v24.x.x lub nowsza wersja. Obsługiwana ścieżka Node 22 LTS wymaga wersji v22.19.x lub nowszej (przejdź na Node 24, gdy będzie to dogodne). Wydania Node 23 starsze niż v23.11.0 nie są obsługiwane. Jeśli brakuje Node lub jego wersja nie mieści się w obsługiwanym zakresie, wybierz jedną z poniższych metod instalacji.

Zainstaluj Node

macOS

Homebrew (zalecane):

bash
brew install node

Możesz 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żesz 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żesz 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 się między wersjami Node. Popularne rozwiązania:

  • fnm — szybki i 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 plików binarnych npm nie znajduje się w PATH.

  • Znajdź globalny prefiks npm

    bash
    npm prefix -g

  • Sprawdź, czy znajduje się w PATH

    bash
    echo "$PATH"

    Poszukaj w danych wyjściowych wpisu <npm-prefix>/bin (macOS/Linux) lub <npm-prefix> (Windows).

  • Dodaj go do pliku startowego powłoki

    macOS / Linux

    Dodaj do pliku ~/.zshrc lub ~/.bashrc:

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

    Następnie otwórz nowy terminal (lub uruchom rehash w powłoce zsh albo hash -r w powłoce bash).

    Windows

    Dodaj 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 pojawiają się błędy EACCES, zmień 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"

    Dodaj wiersz export PATH=... do pliku ~/.bashrc lub ~/.zshrc, aby zmiana była trwała.

    Powiązane materiały

    Was this useful?
    On this page

    On this page