Przejdź do głównej treści

​
Instalacja

​
Zalecane: skrypt instalacyjny

Najszybszy sposób instalacji. Wykrywa system operacyjny, instaluje Node, jeśli to potrzebne, 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 opisano w Installer internals.

​
Wymagania systemowe

  • Node 24 (zalecane) 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 stabilniejsze. Zobacz Windows.
  • pnpm jest potrzebne tylko wtedy, gdy budujesz ze źródeł

​
Alternatywne metody instalacji

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

Użyj tej opcji, jeśli 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 checkoutów git w tym samym przepływie opartym na prefiksie. Pełne informacje referencyjne: Installer internals.

​
npm, pnpm lub bun

Jeśli już samodzielnie zarządzasz Node: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Jeśli sharp kończy się błędem 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 ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Albo pomiń linkowanie i używaj pnpm openclaw ... z wnętrza repozytorium. Pełne przepływy deweloperskie znajdziesz w Setup.

​
Instalacja z GitHub main

npm install -g github:openclaw/openclaw#main

​
Kontenery i menedżery pakietów

Docker

Wdrożenia kontenerowe lub headless.

Podman

Rootless alternatywa kontenerowa dla Docker.

Nix

Deklaratywna instalacja przez Nix flake.

Ansible

Zautomatyzowany provisioning flot.

Bun

Użycie tylko CLI przez runtime Bun.

​
Zweryfikuj instalację

openclaw --version      # potwierdź, że CLI jest dostępne
openclaw doctor         # sprawdź problemy z config
openclaw gateway status # potwierdź, że Gateway działa
Jeśli po instalacji chcesz mieć zarządzany start:
  • 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, a jeśli utworzenie zadania zostanie odrzucone — zapasowy element logowania w folderze Startup per użytkownik

​
Hosting i wdrożenie

Wdróż OpenClaw na serwerze chmurowym lub VPS:

VPS

Dowolny Linux VPS

Docker VM

Wspólne kroki Docker

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Aktualizacja, migracja lub odinstalowanie

Updating

Utrzymuj OpenClaw na bieżąco.

Migrating

Przenieś na nową maszynę.

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ą 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 informacji znajdziesz w Node setup.