// dokumentacja openclaw

Instalacja OpenClaw — przegląd metod

Przegląd instalacji OpenClaw

OpenClaw oferuje wiele ścieżek instalacji dopasowanych do różnych systemów operacyjnych i preferencji użytkowników. Niezależnie od tego, czy pracujesz na macOS, Linuksie, czy Windows — znajdziesz metodę, która pasuje do Twojego środowiska.

Zalecana metoda — skrypt instalacyjny

Najszybszym sposobem rozpoczęcia pracy z OpenClaw jest użycie oficjalnego skryptu instalacyjnego. Automatycznie wykrywa on system operacyjny, instaluje Node.js (jeśli nie jest obecny) i uruchamia kreator konfiguracji.

Na macOS, Linuksie i WSL2 uruchom w terminalu:

curl -fsSL https://openclaw.ai/install.sh | bash

Na Windows otwórz PowerShell i wykonaj:

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

Skrypt pobierze odpowiedni plik binarny, doda go do zmiennej PATH i przejdzie do konfiguracji pierwszego agenta.

Wymagania systemowe

Przed instalacją upewnij się, że Twój system spełnia poniższe wymagania:

  • Node.js 24 (zalecany) lub Node.js 22.14+ — sprawdź wersję poleceniem node --version.
  • System operacyjny — macOS, Linux (dowolna popularna dystrybucja) lub Windows 10+ (natywnie lub przez WSL2).
  • Minimum 2 GB RAM — przy intensywnym użyciu wielu agentów zalecane 4 GB.
  • Klucz API providera AI — np. OpenAI, Anthropic, Google Gemini lub inny z ponad 35 obsługiwanych dostawców.
  • Połączenie z internetem — wymagane do komunikacji z API providerów i kanałami komunikacji.

Alternatywne metody instalacji

Oprócz skryptu instalacyjnego dostępnych jest kilka innych ścieżek:

  • Menedżery pakietów — instalacja przez npm, pnpm lub bun jako globalny pakiet.
  • Docker — konteneryzacja z użyciem oficjalnego obrazu. Idealna dla izolowanych środowisk.
  • Podman — bezrootowa alternatywa dla Dockera z pełnym wsparciem OpenClaw.
  • Nix — deklaratywna instalacja przez Home Manager z modułem nix-openclaw.
  • Ze źródeł — klonowanie repozytorium i budowanie lokalne.
  • Ansible — automatyzacja instalacji na wielu maszynach jednocześnie.

Weryfikacja po instalacji

Po zakończeniu instalacji warto sprawdzić, czy wszystko działa poprawnie. Wykonaj trzy proste polecenia:

# Sprawdz dostepnosc CLI
openclaw --version

# Uruchom diagnostyke
openclaw doctor

# Zweryfikuj status Gateway
openclaw gateway status

Jeśli polecenie openclaw nie jest rozpoznawane, sprawdź, czy katalog globalnych pakietów npm znajduje się w zmiennej PATH.

Zarządzanie demonem

OpenClaw obsługuje automatyczne uruchamianie wraz z systemem operacyjnym:

  • macOS — LaunchAgent (launchctl)
  • Linux / WSL2 — systemd (systemctl --user)
  • Windows — Zaplanowane zadania (Task Scheduler)

Demon instalowany jest automatycznie, gdy podczas konfiguracji użyjesz flagi --install-daemon.

Opcje wdrożenia w chmurze

Jeśli potrzebujesz trwałego, całodobowego Gateway — OpenClaw posiada dedykowane poradniki dla wielu platform chmurowych: Google Cloud, Azure, DigitalOcean, Hetzner, Fly.io, Railway, Render i Kubernetes. Szczegóły znajdziesz w osobnych sekcjach dokumentacji.

Rozwiązywanie problemów

Najczęstsze problemy po instalacji:

  • Polecenie openclaw nie znalezione — upewnij się, że Node.js jest zainstalowany i że globalny katalog npm znajduje się w PATH.
  • Błąd uprawnień na Linuksie — zmień katalog globalnych pakietów npm na katalog użytkownika: npm config set prefix ~/.npm-global.
  • Gateway nie startuje — uruchom openclaw doctor, aby zdiagnozować problem, i sprawdź logi usługi.
Wróc do dokumentacji