Przejdź do głównej treści

​
Instalacja

​
Zalecane: skrypt instalacyjny

Najszybszy sposób instalacji. Wykrywa Twój system operacyjny, instaluje Node w razie potrzeby, instaluje OpenClaw i uruchamia onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Aby zainstalować bez uruchamiania onboardingu: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Wszystkie flagi oraz opcje CI/automatyzacji znajdziesz w Wewnętrzne działanie instalatora.

​
Wymagania systemowe

  • Node 24 (zalecany) lub Node 22.14+ — skrypt instalacyjny obsługuje to automatycznie
  • macOS, Linux lub Windows — obsługiwane są zarówno natywny Windows, jak i WSL2; WSL2 jest stabilniejszy. Zobacz Windows.
  • pnpm jest potrzebny tylko wtedy, gdy kompilujesz ze źródeł

​
Alternatywne metody instalacji

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

Użyj tej opcji, jeśli chcesz, aby OpenClaw i Node były przechowywane pod lokalnym prefiksem, takim jak ~/.openclaw, bez zależności od instalacji Node w całym systemie: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Domyślnie obsługuje instalacje npm, a także instalacje z checkoutu git w ramach tego samego przepływu z prefiksem. Pełna dokumentacja: Wewnętrzne działanie instalatora.

​
npm, pnpm lub bun

Jeśli samodzielnie zarządzasz Node: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Jeśli sharp kończy się niepowodzeniem z powodu globalnie zainstalowanego libvips:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Ze źródeł

Dla współtwórców lub osób, które 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ąć linkowanie i używać pnpm openclaw ... wewnątrz repozytorium. Pełne przepływy pracy deweloperskiej znajdziesz w Konfiguracja.

​
Instalacja z GitHub main

npm install -g github:openclaw/openclaw#main

​
Kontenery i menedżery pakietów

Docker

Wdrożenia kontenerowe lub bezgłowe.

Podman

Alternatywa kontenerowa bez roota dla Docker.

Nix

Deklaratywna instalacja przez Nix flake.

Ansible

Zautomatyzowane provisioning 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 # sprawdź, czy Gateway działa
Jeśli po instalacji chcesz mieć 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 Scheduled Task, z zapasowym elementem logowania w folderze Startup dla użytkownika, jeśli utworzenie zadania zostanie odrzucone

​
Hosting i wdrożenie

Wdróż OpenClaw na serwerze chmurowym lub VPS:

VPS

Dowolny Linux VPS

Docker VM

Wspólne kroki dla Docker

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Aktualizacja, migracja lub odinstalowanie

Aktualizacja

Utrzymuj OpenClaw w aktualnej wersji.

Migracja

Przenieś się na nową maszynę.

Odinstalowanie

Całkowicie usuń OpenClaw.

​
Rozwiązywanie problemów: nie znaleziono openclaw

Jeśli instalacja zakończyła się powodzeniem, ale openclaw nie jest znajdowany w terminalu: 
node -v           # Node zainstalowany?
npm prefix -g     # Gdzie są globalne pakiety?
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 Konfiguracja Node.