Wewnętrzne mechanizmy instalatora

OpenClaw dostarcza trzy skrypty instalacyjne, serwowane z openclaw.ai.

Skrypt	Platforma	Co robi
`install.sh`	macOS / Linux / WSL	Instaluje Node w razie potrzeby, instaluje OpenClaw przez npm (domyślnie) lub git i może uruchomić onboarding.
`install-cli.sh`	macOS / Linux / WSL	Instaluje Node + OpenClaw w lokalnym prefiksie (`~/.openclaw`) w trybach npm lub checkout git. Nie wymaga uprawnień root.
`install.ps1`	Windows (PowerShell)	Instaluje Node w razie potrzeby, instaluje OpenClaw przez npm (domyślnie) lub git i może uruchomić onboarding.

Szybkie polecenia

install.sh
install-cli.sh
install.ps1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

Jeśli instalacja się powiedzie, ale openclaw nie zostanie znalezione w nowym terminalu, zobacz rozwiązywanie problemów z Node.js.

install.sh

Zalecane dla większości interaktywnych instalacji w macOS/Linux/WSL.

Przepływ (install.sh)

Wykryj system operacyjny

Obsługuje macOS i Linux (w tym WSL).

Domyślnie zapewnij Node.js 24

Sprawdza wersję Node i instaluje Node 24 w razie potrzeby (Homebrew w macOS, skrypty konfiguracyjne NodeSource w Linux apt/dnf/yum). W macOS Homebrew jest instalowany tylko wtedy, gdy instalator potrzebuje go dla Node lub Git. OpenClaw nadal obsługuje Node 22 LTS, obecnie 22.19+, dla zgodności. W Alpine/musl Linux instalator używa pakietów apk zamiast NodeSource; skonfigurowane repozytoria Alpine muszą udostępniać Node 22.19+ (Alpine 3.21 lub nowszy w chwili pisania).

Zapewnij Git

Instaluje Git, jeśli go brakuje, używając wykrytego menedżera pakietów, w tym Homebrew w macOS i apk w Alpine.

Zainstaluj OpenClaw

metoda npm (domyślna): globalna instalacja npm
metoda git: klonuje/aktualizuje repozytorium, instaluje zależności przez pnpm, buduje, a następnie instaluje wrapper w ~/.local/bin/openclaw

Zadania po instalacji

Odświeża załadowaną usługę gateway w trybie best-effort (openclaw gateway install --force, potem restart)
Uruchamia openclaw doctor --non-interactive przy aktualizacjach i instalacjach git (best effort)
Próbuje uruchomić onboarding, gdy jest to odpowiednie (dostępny TTY, onboarding nie jest wyłączony, a kontrole bootstrap/config przechodzą)

Wykrywanie checkoutu źródłowego

Jeśli zostanie uruchomiony wewnątrz checkoutu OpenClaw (package.json + pnpm-workspace.yaml), skrypt oferuje:

użycie checkoutu (git) albo
użycie instalacji globalnej (npm)

Jeśli TTY nie jest dostępny i nie ustawiono metody instalacji, domyślnie używa npm i wyświetla ostrzeżenie. Skrypt kończy działanie kodem 2 przy nieprawidłowym wyborze metody lub nieprawidłowych wartościach --install-method.

Przykłady (install.sh)

Domyślnie
Pomiń onboarding
Instalacja git
Checkout main z GitHub
Przebieg próbny

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

Informacje o flagach

Flaga	Opis
`--install-method npm\|git`	Wybierz metodę instalacji (domyślnie: `npm`). Alias: `--method`
`--npm`	Skrót dla metody npm
`--git`	Skrót dla metody git. Alias: `--github`
`--version <version\|dist-tag\|spec>`	wersja npm, dist-tag lub specyfikacja pakietu (domyślnie: `latest`)
`--beta`	Użyj dist-tag beta, jeśli jest dostępny; w przeciwnym razie wróć do `latest`
`--git-dir <path>`	Katalog checkoutu (domyślnie: `~/openclaw`). Alias: `--dir`
`--no-git-update`	Pomiń `git pull` dla istniejącego checkoutu
`--no-prompt`	Wyłącz monity
`--no-onboard`	Pomiń onboarding
`--onboard`	Włącz onboarding
`--dry-run`	Wypisz działania bez stosowania zmian
`--verbose`	Włącz dane wyjściowe debugowania (`set -x`, logi npm na poziomie notice)
`--help`	Pokaż użycie (`-h`)

Informacje o zmiennych środowiskowych

Zmienna	Opis
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metoda instalacji
`OPENCLAW_VERSION=latest\|next\|<semver>\|<spec>`	wersja npm, dist-tag lub specyfikacja pakietu
`OPENCLAW_BETA=0\|1`	Użyj beta, jeśli jest dostępna
`OPENCLAW_HOME=<path>`	Katalog bazowy stanu OpenClaw oraz domyślnych ścieżek git/onboarding
`OPENCLAW_GIT_DIR=<path>`	Katalog checkoutu
`OPENCLAW_GIT_UPDATE=0\|1`	Przełącz aktualizacje git
`OPENCLAW_NO_PROMPT=1`	Wyłącz monity
`OPENCLAW_NO_ONBOARD=1`	Pomiń onboarding
`OPENCLAW_DRY_RUN=1`	Tryb przebiegu próbnego
`OPENCLAW_VERBOSE=1`	Tryb debugowania
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Poziom logowania npm

install-cli.sh

Zaprojektowany dla środowisk, w których chcesz mieć wszystko pod lokalnym prefiksem (domyślnie ~/.openclaw) i bez systemowej zależności Node. Domyślnie obsługuje instalacje npm, a także instalacje z checkoutu git w tym samym przepływie prefiksu.

Przepływ (install-cli.sh)

Zainstaluj lokalne środowisko uruchomieniowe Node

Pobiera przypięty obsługiwany archiwum tarball Node LTS (wersja jest osadzona w skrypcie i aktualizowana niezależnie) do <prefix>/tools/node-v<version> i weryfikuje SHA-256. W Alpine/musl Linux, gdzie Node nie publikuje zgodnych archiwów tarball dla przypiętego środowiska uruchomieniowego, instaluje nodejs i npm przez apk oraz linkuje to środowisko uruchomieniowe do ścieżki wrappera prefiksu. Repozytoria Alpine muszą udostępniać Node 22.19+; użyj Alpine 3.21 lub nowszego, jeśli starsze repozytoria udostępniają tylko Node 20 lub 21.

Zapewnij Git

Jeśli brakuje Git, próbuje zainstalować go przez apt/dnf/yum/apk w Linux lub Homebrew w macOS.

Zainstaluj OpenClaw pod prefiksem

metoda npm (domyślna): instaluje pod prefiksem przez npm, a następnie zapisuje wrapper do <prefix>/bin/openclaw
metoda git: klonuje/aktualizuje checkout (domyślnie ~/openclaw) i nadal zapisuje wrapper do <prefix>/bin/openclaw

Odśwież załadowaną usługę gateway

Jeśli usługa gateway jest już załadowana z tego samego prefiksu, skrypt uruchamia openclaw gateway install --force, następnie openclaw gateway restart, i sonduje kondycję gateway w trybie best-effort.

Przykłady (install-cli.sh)

Domyślnie
Niestandardowy prefiks + wersja
Instalacja git
Dane wyjściowe JSON dla automatyzacji
Uruchom onboarding

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Informacje o flagach

Flaga	Opis
`--prefix <path>`	Prefiks instalacji (domyślnie: `~/.openclaw`)
`--install-method npm\|git`	Wybierz metodę instalacji (domyślnie: `npm`). Alias: `--method`
`--npm`	Skrót dla metody npm
`--git`, `--github`	Skrót dla metody git
`--git-dir <path>`	Katalog checkoutu Git (domyślnie: `~/openclaw`). Alias: `--dir`
`--version <ver>`	Wersja OpenClaw lub dist-tag (domyślnie: `latest`)
`--node-version <ver>`	Wersja Node (domyślnie: `22.22.0`)
`--json`	Emituj zdarzenia NDJSON
`--onboard`	Uruchom `openclaw onboard` po instalacji
`--no-onboard`	Pomiń onboarding (domyślnie)
`--set-npm-prefix`	W systemie Linux wymuś prefiks npm `~/.npm-global`, jeśli bieżący prefiks nie jest zapisywalny
`--help`	Pokaż użycie (`-h`)

Odwołanie do zmiennych środowiskowych

Zmienna	Opis
`OPENCLAW_PREFIX=<path>`	Prefiks instalacji
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metoda instalacji
`OPENCLAW_VERSION=<ver>`	Wersja OpenClaw lub dist-tag
`OPENCLAW_NODE_VERSION=<ver>`	Wersja Node
`OPENCLAW_HOME=<path>`	Katalog bazowy stanu OpenClaw oraz domyślnych ścieżek git/onboardingu
`OPENCLAW_GIT_DIR=<path>`	Katalog checkoutu Git dla instalacji git
`OPENCLAW_GIT_UPDATE=0\|1`	Przełącz aktualizacje git dla istniejących checkoutów
`OPENCLAW_NO_ONBOARD=1`	Pomiń onboarding
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Poziom logowania npm

install.ps1

Przebieg (install.ps1)

Zapewnij środowisko PowerShell + Windows

Wymaga PowerShell 5+.

Domyślnie zapewnij Node.js 24

Jeśli brakuje, próbuje instalacji przez winget, następnie Chocolatey, a potem Scoop. Jeśli żaden menedżer pakietów nie jest dostępny, skrypt pobiera oficjalne archiwum zip Node.js dla Windows do %LOCALAPPDATA%\OpenClaw\deps\portable-node i dodaje je do PATH bieżącego procesu oraz użytkownika. Node 22 LTS, obecnie 22.19+, pozostaje obsługiwany dla zgodności.

Zainstaluj OpenClaw

Metoda npm (domyślna): globalna instalacja npm z użyciem wybranego -Tag, uruchamiana z zapisywalnego katalogu tymczasowego instalatora, aby powłoki otwarte w chronionych folderach, takich jak C:\, nadal działały
Metoda git: klonuje/aktualizuje repozytorium, instaluje/buduje za pomocą pnpm i instaluje wrapper w %USERPROFILE%\.local\bin\openclaw.cmd. Jeśli brakuje Git, skrypt inicjuje lokalny dla użytkownika MinGit w %LOCALAPPDATA%\OpenClaw\deps\portable-git i dodaje go do PATH bieżącego procesu oraz użytkownika.

Zadania po instalacji

Dodaje wymagany katalog bin do PATH użytkownika, gdy to możliwe
Odświeża załadowaną usługę Gateway w trybie best-effort (openclaw gateway install --force, następnie restart)
Uruchamia openclaw doctor --non-interactive przy aktualizacjach i instalacjach git (best effort)

Obsłuż awarie

Instalacje iwr ... | iex oraz scriptblock zgłaszają błąd kończący bez zamykania bieżącej sesji PowerShell. Bezpośrednie instalacje powershell -File / pwsh -File nadal kończą się kodem niezerowym na potrzeby automatyzacji.

Przykłady (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

# install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

Odwołanie do flag

Flaga	Opis
`-InstallMethod npm\|git`	Metoda instalacji (domyślnie: `npm`)
`-Tag <tag\|version\|spec>`	dist-tag npm, wersja lub specyfikacja pakietu (domyślnie: `latest`)
`-GitDir <path>`	Katalog checkoutu (domyślnie: `%USERPROFILE%\openclaw`)
`-NoOnboard`	Pomiń onboarding
`-NoGitUpdate`	Pomiń `git pull`
`-DryRun`	Tylko wypisz działania

Odwołanie do zmiennych środowiskowych

Zmienna	Opis
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metoda instalacji
`OPENCLAW_GIT_DIR=<path>`	Katalog checkoutu
`OPENCLAW_NO_ONBOARD=1`	Pomiń onboarding
`OPENCLAW_GIT_UPDATE=0`	Wyłącz git pull
`OPENCLAW_DRY_RUN=1`	Tryb przebiegu próbnego

Jeśli użyto -InstallMethod git i brakuje Git, skrypt próbuje zainicjować lokalny dla użytkownika MinGit przed wypisaniem linku do Git for Windows.

CI i automatyzacja

Używaj nieinteraktywnych flag/zmiennych środowiskowych, aby uzyskać przewidywalne uruchomienia.

install.sh (nieinteraktywne npm)
install.sh (nieinteraktywne git)
install-cli.sh (JSON)
install.ps1 (pomiń onboarding)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Rozwiązywanie problemów

Dlaczego Git jest wymagany?

Git jest wymagany dla metody instalacji git. W przypadku instalacji npm Git nadal jest sprawdzany/instalowany, aby uniknąć błędów spawn git ENOENT, gdy zależności używają URL-i git.

Dlaczego npm trafia na EACCES w systemie Linux?

Niektóre konfiguracje systemu Linux wskazują globalny prefiks npm na ścieżki należące do root. install.sh może przełączyć prefiks na ~/.npm-global i dopisać eksporty PATH do plików rc powłoki (gdy te pliki istnieją).

Windows: "npm error spawn git / ENOENT"

Uruchom instalator ponownie, aby mógł zainicjować lokalny dla użytkownika MinGit, albo zainstaluj Git for Windows i ponownie otwórz PowerShell.

Windows: "openclaw is not recognized"

Uruchom npm config get prefix i dodaj ten katalog do PATH użytkownika (w Windows nie jest potrzebny sufiks \bin), następnie ponownie otwórz PowerShell.

Windows: jak uzyskać szczegółowe dane wyjściowe instalatora

install.ps1 obecnie nie udostępnia przełącznika -Verbose. Użyj śledzenia PowerShell do diagnostyki na poziomie skryptu:

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

openclaw nie znaleziono po instalacji

Zwykle jest to problem z PATH. Zobacz Rozwiązywanie problemów z Node.js.

​Szybkie polecenia

​install.sh

​Przepływ (install.sh)

​Wykrywanie checkoutu źródłowego

​Przykłady (install.sh)

​install-cli.sh

​Przepływ (install-cli.sh)

​Przykłady (install-cli.sh)

​install.ps1

​Przebieg (install.ps1)

​Przykłady (install.ps1)

​CI i automatyzacja

​Rozwiązywanie problemów

​Powiązane

Szybkie polecenia

install.sh

Przepływ (install.sh)

Wykrywanie checkoutu źródłowego

Przykłady (install.sh)

install-cli.sh

Przepływ (install-cli.sh)

Przykłady (install-cli.sh)

install.ps1

Przebieg (install.ps1)

Przykłady (install.ps1)

CI i automatyzacja

Rozwiązywanie problemów

Powiązane