Jak zainstalowac OpenClaw — poradnik krok po kroku

1. Wymagania systemowe

Zanim zaczniesz instalacje, upewnij się, ze Twój system spelnia ponizsze wymagania. OpenClaw dziala na wszystkich popularnych systemach operacyjnych, ale wymaga stosunkowo nowej wersji Node.js.

node --version

2. Metoda 1: Instalator (najlatwiejsza)

Oficjalny instalator to najszybsza i najprostsza metoda uruchomienia OpenClaw. Skrypt automatycznie wykrywa Twój system operacyjny, instaluje Node.js (jezeli go nie masz) oraz wszystkie wymagane zaleznosci. Caly proces trwa okolo 2-3 minuty.

macOS i Linux

Otworz terminal i wklej ponizsze polecenie:

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

Skrypt pobierze najnowsza wersje OpenClaw, zainstaluje ja globalnie i uruchomi kreator konfiguracji (onboarding). Jezeli chcesz widziec szczegolowy przebieg instalacji, dodaj flage --verbose:

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

Windows (PowerShell)

Otworz PowerShell jako administrator i uruchom:

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

Co robi instalator?

1. 1 Sprawdza, czy Node.js 22+ jest zainstalowany — jezeli nie, instaluje go automatycznie
2. 2 Pobiera i instaluje najnowsza wersje pakietu openclaw globalnie
3. 3 Tworzy katalog konfiguracyjny ~/.openclaw/
4. 4 Uruchamia kreator konfiguracji (onboarding wizard)
5. 5 Instaluje demona Gateway jako usługę systemowa (launchd na macOS, systemd na Linux)

Instalacja przez Git (alternatywa)

Jezeli wolisz miec pelny dostep do kodu zrodlowego (przydatne na Raspberry Pi i do diagnostyki), możesz zainstalowac OpenClaw z repozytorium Git:

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

3. Metoda 2: npm / pnpm

Jezeli masz już zainstalowany Node.js i wolisz kontrolowac proces instalacji recznie, możesz uzyc npm lub pnpm. Ta metoda jest szczególnie przydatna dla programistow, ktorzy chca zintegrowac OpenClaw z istniejacym srodowiskiem.

Instalacja globalna (zalecana)

Instalacja globalna pozwala uruchamiac OpenClaw z dowolnego katalogu:

# Przez npm
npm install -g openclaw@latest

# Lub przez pnpm (szybsza alternatywa)
pnpm add -g openclaw@latest

Po instalacji uruchom kreator konfiguracji, który zainstaluje również demona Gateway jako usługę systemowa:

openclaw onboard --install-daemon

Instalacja lokalna (dla projektow)

Jezeli chcesz uzyc OpenClaw jako zaleznosci w konkretnym projekcie:

# W katalogu projektu
npm install openclaw@latest

# Uruchamianie z npx
npx openclaw onboard --install-daemon

Aktualizacja

Aby zaktualizowac OpenClaw do najnowszej wersji:

# Przez npm
npm update -g openclaw

# Lub przez wbudowana komende
openclaw update --channel stable

OpenClaw oferuje trzy kanaly aktualizacji: stable (stabilna, zalecana), beta (testowa) i dev (deweloperska). Dla wiekszosci uzytkownikow zalecamy kanal stable.

4. Metoda 3: Docker

Docker to idealne rozwiązanie, jezeli chcesz uruchomic OpenClaw w izolowanym kontenerze bez instalowania Node.js na swoim systemie. Jest to również najlepsza metoda do wdrożenia na serwerze (VPS).

Wymagania dla Docker

• + Docker Engine 20+ (lub Docker Desktop)
• + Docker Compose v2

Szybka instalacja (skrypt setup)

Najszybsza metoda — uzyj gotowego skryptu konfiguracyjnego:

# Klonuj repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Uruchom skrypt konfiguracyjny
./scripts/docker/setup.sh

Skrypt automatycznie zbuduje obraz Docker, uruchomi kreator konfiguracji (onboarding), zapyta o klucze API dostawcow, wygeneruje token Gateway i zapisze go w pliku .env, a następnie uruchomi Gateway przez Docker Compose.

Uzycie gotowego obrazu

Jezeli nie chcesz budowac obrazu lokalnie, uzyj oficjalnego obrazu z GitHub Container Registry:

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

Reczna konfiguracja Docker

Dla pelnej kontroli nad procesem możesz zbudowac i uruchomic OpenClaw recznie:

# 1. Zbuduj obraz
docker build -t openclaw:local -f Dockerfile .

# 2. Uruchom kreator konfiguracji
docker compose run --rm openclaw-cli onboard

# 3. Uruchom Gateway w tle
docker compose up -d openclaw-gateway

Woluminy i porty

Docker montuje dwa kluczowe katalogi jako woluminy, dzieki czemu Twoje dane sa zachowane między restartami kontenera:

Zmienne srodowiskowe Docker

Dostepne zmienne srodowiskowe do konfiguracji kontenera:

Sprawdzanie stanu kontenera

OpenClaw udostepnia endpointy health check:

# Sprawdz, czy Gateway zyje (liveness)
curl -fsS http://127.0.0.1:18789/healthz

# Sprawdz, czy Gateway jest gotowy do obsługi (readiness)
curl -fsS http://127.0.0.1:18789/readyz

5. Metoda 4: Budowanie ze źródła

Budowanie ze źródła daje Ci pelna kontrole nad kodem i pozwala na modyfikacje OpenClaw. Ta metoda jest zalecana dla deweloperow, ktorzy chca kontrybuowac do projektu lub dostosowac go do wlasnych potrzeb.

Krok po kroku

# 1. Sklonuj repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. Zainstaluj zaleznosci (projekt uzywa pnpm)
pnpm install

# 3. Zbuduj interfejs uzytkownika
pnpm ui:build

# 4. Zbuduj caly projekt
pnpm build

# 5. Uruchom kreator konfiguracji
pnpm openclaw onboard --install-daemon

Tryb deweloperski

Podczas pracy nad kodem OpenClaw możesz uzyc trybu deweloperskiego z automatycznym przeladowaniem:

# Uruchom Gateway w trybie deweloperskim
pnpm gateway:watch

W trybie gateway:watch serwer automatycznie restartuje się po kazdej zmianie w kodzie zrodlowym, co znacznie przyspiesza cykl rozwoju.

6. Konfiguracja po instalacji

Niezaleznie od wybranej metody instalacji, nastepnym krokiem jest konfiguracja OpenClaw przez kreator onboardingu. Kreator przeprowadzi Cie przez caly proces w okolo 2 minuty.

6.1 Kreator konfiguracji (Onboarding Wizard)

Jezeli kreator nie uruchomil się automatycznie, wystartuj go recznie:

openclaw onboard --install-daemon

Kreator zada Ci kilku pytan. Możesz wybrac tryb QuickStart (domyslne ustawienia — zalecany dla początkujących) lub Advanced (pelna kontrola nad kazda opcja).

Kreator skonfiguruje:

• + Lokalizacje katalogu roboczego (workspace)
• + Port Gateway (domyslnie 18789)
• + Token autoryzacyjny Gateway
• + Dostawce modelu AI i klucz API
• + Kanaly komunikacji (Telegram, WhatsApp itd.)
• + Demona systemowego (usługę dzialajaca w tle)

6.2 Konfiguracja klucza API

OpenClaw jest bramka (gateway) — sam nie zawiera modelu AI, lecz łączy się z zewnetrznymi dostawcami. Potrzebujesz klucza API od co najmniej jednego dostawcy:

Klucze API możesz również dodac recznie po instalacji:

# Dodaj klucz Anthropic
openclaw models auth paste-token --provider anthropic

# Lub zapisz klucze w pliku .env
echo "ANTHROPIC_API_KEY=sk-ant-twój-klucz" >> ~/.openclaw/.env
echo "OPENAI_API_KEY=sk-twój-klucz" >> ~/.openclaw/.env

6.3 Wybor kanalow komunikacji

OpenClaw obsluguje ponad 20 kanalow komunikacji. Oto najszybsze do skonfigurowania:

Pelna lista obslugiwanych kanalow: WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage (przez BlueBubbles), IRC, Microsoft Teams, Matrix, LINE, Mattermost, Twitch i wiele innych.

6.4 Weryfikacja instalacji

Po zakonczeniu konfiguracji sprawdz, czy wszystko dziala poprawnie:

# Sprawdz status Gateway
openclaw gateway status

# Sprawdz status wszystkich komponentow
openclaw status --all

# Otworz panel kontrolny w przegladarce
openclaw dashboard

# Wyslij testowa wiadomosc
openclaw message send --to +48123456789 --message "Hej, OpenClaw dziala!"

# Uruchom agenta z bezposrednia wiadomoscia
openclaw agent --message "Powiedz mi cos o sobie" --thinking high

Jezeli komenda openclaw gateway status zwraca status "running", a panel kontrolny otwiera się w przegladarce — gratulacje! OpenClaw jest zainstalowany i gotowy do pracy.

7. Rozwiązywanie problemow

Wiekszosci problemow z instalacja można rozwiazac za pomoca wbudowanego narzędzia diagnostycznego. Uruchom je jako pierwszy krok:

# Automatyczna diagnostyka i naprawa
openclaw doctor --fix

# Sprawdz logi w czasie rzeczywistym
openclaw logs --follow

# Pelna diagnostyka z logami
openclaw status --all

7.1 Błąd wersji Node.js

# Sprawdz aktualna wersje
node --version

# Zainstaluj Node 24 przez nvm
nvm install 24
nvm use 24

# Lub pobierz ze strony nodejs.org
# https://nodejs.org/en/download

7.2 Konflikt portow

# Znajdz proces uzywajacy portu
# macOS / Linux:
lsof -i :18789

# Windows:
netstat -ano | findstr 18789

# Zabij proces (zamien PID na faktyczny numer)
kill -9 PID

# Lub zmien port Gateway
openclaw config set gateway.port 18790

7.3 Problemy z kluczem API

# Sprawdz status modeli i kluczy
openclaw models status

# Ponownie skonfiguruj klucz API
openclaw models auth paste-token --provider anthropic

# Lub dodaj klucz do pliku .env
echo "ANTHROPIC_API_KEY=sk-ant-twój-nowy-klucz" >> ~/.openclaw/.env

# Zrestartuj Gateway
openclaw gateway restart

7.4 Gateway nie uruchamia się jako usługa

# Upewnij się, ze klucze sa w pliku .env (a nie tylko w sesji powloki)
cat ~/.openclaw/.env

# Jezeli plik jest pusty, dodaj klucze:
echo "ANTHROPIC_API_KEY=sk-ant-twój-klucz" >> ~/.openclaw/.env

# Ponownie zainstaluj demona
openclaw onboard --install-daemon

# Sprawdz status usługi
openclaw gateway status

7.5 Błąd "Gateway is not reachable"

# Sprawdz, czy Gateway dziala
openclaw gateway status
openclaw status --deep

# Pobierz token autoryzacyjny
openclaw config get gateway.auth.token

# Wklej token w ustawieniach panelu kontrolnego

# Zrestartuj Gateway
openclaw gateway restart

7.6 Błąd "rate_limit_error" lub "429 Too Many Requests"

# Sprawdz listę dostepnych modeli
openclaw models list

# Skonfiguruj model zapasowy (fallback)
openclaw config set agents.defaults.models.fallback "gpt-4o"

# Lub poczekaj na reset limitu (zwykle 1 minuta)

Szybka tabela diagnostyczna

8. Następne kroki

Gratulacje — OpenClaw jest zainstalowany i gotowy do pracy! Oto co możesz zrobić dalej, aby w pelni wykorzystać możliwości swojego osobistego asystenta AI:

Przydatne komendy na co dzień

# Sprawdz status calego systemu
openclaw status

# Otworz panel kontrolny
openclaw dashboard

# Wyslij szybka wiadomosc do agenta
openclaw agent --message "Twoja wiadomosc"

# Sprawdz logi
openclaw logs --follow

# Zaktualizuj do najnowszej wersji
openclaw update --channel stable

# Uruchom diagnostyke
openclaw doctor

Często zadawane pytania