Przejdź do głównej treści

​
Wymagania systemowe

  • Node 24 (zalecane) lub Node 22.19+ - skrypt instalatora obsługuje to automatycznie
  • macOS, Linux lub Windows - użytkownicy Windows mogą zacząć od natywnej aplikacji Windows Hub, instalatora CLI dla PowerShell albo Gateway w WSL2. Zobacz Windows.
  • pnpm jest potrzebny tylko wtedy, gdy budujesz ze źródeł

​
Zalecane: skrypt instalatora

Najszybszy sposób instalacji. Wykrywa system operacyjny, instaluje Node w razie potrzeby, instaluje OpenClaw i uruchamia wprowadzenie.
Użytkownicy pulpitu Windows mogą też zainstalować natywną aplikację towarzyszącą Windows Hub, która obejmuje konfigurację, status w zasobniku, czat, tryb węzła i lokalny tryb MCP.
curl -fsSL https://openclaw.ai/install.sh | bash
Aby zainstalować bez uruchamiania wprowadzenia: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Wszystkie flagi i opcje CI/automatyzacji znajdziesz w sekcji Szczegóły instalatora.

​
Alternatywne metody instalacji

​
Instalator z lokalnym prefiksem (install-cli.sh)

Użyj tego, gdy chcesz przechowywać OpenClaw i Node pod lokalnym prefiksem, takim jak ~/.openclaw, bez zależności od systemowej instalacji Node: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Domyślnie obsługuje instalacje npm, a także instalacje z checkoutu git w tym samym przepływie prefiksu. Pełna dokumentacja: Szczegóły instalatora. Masz już instalację? Przełączaj się między instalacjami pakietowymi i git za pomocą openclaw update --channel dev oraz openclaw update --channel stable. Zobacz Aktualizowanie.

​
npm, pnpm lub bun

Jeśli samodzielnie zarządzasz już Node: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Hostowany instalator czyści filtry świeżości npm, takie jak min-release-age, dla instalacji pakietu OpenClaw. Jeśli instalujesz ręcznie przy użyciu npm, nadal obowiązuje Twoja własna polityka npm.

​
Ze źródeł

Dla kontrybutorów lub wszystkich, którzy chcą uruchamiać z lokalnego checkoutu: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Możesz też pominąć link i używać pnpm openclaw ... z wnętrza repozytorium. Pełne przepływy deweloperskie znajdziesz w sekcji Konfiguracja.

​
Instalacja z checkoutu GitHub main

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

​
Kontenery i menedżery pakietów

Docker

Wdrożenia kontenerowe lub bezgłowe.

Podman

Bezrootowa alternatywa kontenerowa dla Docker.

Nix

Deklaratywna instalacja przez Nix flake.

Ansible

Automatyczne provisionowanie floty.

Bun

Użycie wyłącznie CLI przez środowisko uruchomieniowe Bun.

​
Weryfikacja instalacji

openclaw --version      # potwierdź, że CLI jest dostępne
openclaw doctor         # sprawdź problemy z konfiguracją
openclaw gateway status # zweryfikuj, że Gateway działa
Jeśli po instalacji chcesz zarządzane uruchamianie:
  • macOS: LaunchAgent przez openclaw onboard --install-daemon lub openclaw gateway install
  • Linux/WSL2: usługa użytkownika systemd przez te same polecenia
  • Natywny Windows: najpierw zaplanowane zadanie, z awaryjnym elementem logowania w folderze Autostart dla użytkownika, jeśli utworzenie zadania zostanie odrzucone

​
Hosting i wdrażanie

Wdróż OpenClaw na serwerze w chmurze lub VPS:

VPS

Dowolny VPS z Linux.

Docker VM

Wspólne kroki Docker.

Kubernetes

Wdrożenie K8s.

Fly.io

Wdrożenie na Fly.io.

Hetzner

Wdrożenie Hetzner.

GCP

Wdrożenie Google Cloud.

Azure

Wdrożenie Azure.

Railway

Wdrożenie Railway.

Render

Wdrożenie Render.

Northflank

Wdrożenie Northflank.

​
Aktualizacja, migracja lub odinstalowanie

Updating

Dbaj o aktualność OpenClaw.

Migrating

Przenieś na nowy komputer.

Uninstall

Usuń OpenClaw całkowicie.

​
Rozwiązywanie problemów: nie znaleziono openclaw

Jeśli instalacja się powiodła, ale openclaw nie jest znajdowany w terminalu: 
node -v           # Node zainstalowany?
npm prefix -g     # Gdzie są pakiety globalne?
echo "$PATH"      # Czy globalny katalog bin jest w PATH?
Jeśli $(npm prefix -g)/bin nie znajduje się w Twoim $PATH, dodaj go do pliku startowego powłoki (~/.zshrc lub ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Następnie otwórz nowy terminal. Więcej szczegółów znajdziesz w sekcji Konfiguracja Node.