Skip to main content

​
Wymagania systemowe

  • Node 22.22.3+, 24.15+ lub 25.9+ — Node 24 jest domyślną wersją docelową; skrypt instalacyjny obsługuje to automatycznie.
  • macOS, Linux lub Windows — użytkownicy systemu Windows mogą zacząć od natywnej aplikacji Windows Hub, instalatora CLI dla PowerShell lub Gateway w WSL2. Zobacz Windows.
  • pnpm jest wymagany tylko w przypadku kompilowania ze źródeł.

​
Zalecane: skrypt instalacyjny

Najszybszy sposób instalacji. Wykrywa system operacyjny, w razie potrzeby instaluje Node, instaluje OpenClaw i uruchamia konfigurację początkową.
Użytkownicy systemu Windows mogą również zainstalować natywną aplikację towarzyszącą Windows Hub, która obejmuje konfigurację, stan w zasobniku systemowym, czat, tryb Node i lokalny tryb MCP.
Aby zainstalować bez uruchamiania konfiguracji początkowej:
Opis wszystkich flag oraz opcji CI i automatyzacji znajduje się w sekcji Szczegóły działania instalatora.

​
Alternatywne metody instalacji

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

Tej metody należy użyć, aby przechowywać OpenClaw i Node pod lokalnym prefiksem, takim jak ~/.openclaw, bez zależności od ogólnosystemowej instalacji Node:
Domyślnie obsługuje instalacje npm, a także instalacje z kopii roboczej git w ramach tego samego przepływu z prefiksem. Pełna dokumentacja: Szczegóły działania instalatora. OpenClaw jest już zainstalowany? Między instalacjami z pakietu i z repozytorium git można przełączać się za pomocą openclaw update --channel dev i openclaw update --channel stable. Zobacz Aktualizowanie.

​
npm, pnpm lub bun

Jeśli środowisko Node jest już zarządzane samodzielnie:
Hostowany instalator usuwa filtry aktualności npm, takie jak min-release-age, na potrzeby instalacji pakietu OpenClaw. W przypadku ręcznej instalacji za pomocą npm nadal obowiązują własne zasady npm.

​
Ze źródeł

Dla współtwórców lub osób, które chcą uruchamiać OpenClaw z lokalnej kopii roboczej:
Można też pominąć tworzenie dowiązania i użyć pnpm openclaw ... wewnątrz repozytorium. Pełny opis przepływów programistycznych znajduje się w sekcji Konfiguracja.

​
Instalacja z głównej kopii roboczej repozytorium GitHub

​
Kontenery i menedżery pakietów

Docker

Wdrożenia kontenerowe lub bez interfejsu graficznego.

Podman

Bezrootowa alternatywa kontenerowa dla Docker.

Nix

Deklaratywna instalacja za pomocą flake Nix.

Ansible

Zautomatyzowane udostępnianie floty.

Bun

Opcjonalny instalator zależności i program uruchamiający skrypty pakietów.

​
Weryfikacja instalacji

Aby po instalacji skonfigurować zarządzane uruchamianie:
  • macOS: LaunchAgent za pomocą openclaw onboard --install-daemon lub openclaw gateway install
  • Linux/WSL2: usługa użytkownika systemd za pomocą tych samych poleceń
  • Natywny Windows: najpierw zadanie harmonogramu, a jeśli utworzenie zadania zostanie odrzucone — awaryjnie element logowania w folderze Autostart użytkownika

​
Hosting i wdrażanie

OpenClaw można wdrożyć na serwerze w chmurze lub VPS. Pełny wybór dostawców (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi i inni) znajduje się w sekcji Serwer Linux. Można też wdrożyć system deklaratywnie na Render.

VPS

Wybór dostawcy.

Maszyna wirtualna Docker

Wspólne kroki dla Docker.

Kubernetes

Wdrożenie K8s.

​
Aktualizowanie, migracja lub odinstalowywanie

Aktualizowanie

Utrzymywanie aktualnej wersji OpenClaw.

Migracja

Przenoszenie na nową maszynę.

Odinstalowywanie

Całkowite usuwanie OpenClaw.

​
Rozwiązywanie problemów: nie znaleziono openclaw

Prawie zawsze oznacza to problem ze zmienną PATH: globalny katalog plików binarnych npm nie znajduje się w zmiennej PATH powłoki. Pełne rozwiązanie, w tym ścieżkę dla systemu Windows, opisano w sekcji Rozwiązywanie problemów z Node.js.