OpenClaw na WhatsApp w 15 minut

OPUBLIKOWANO: 11 lutego 2026

Masz 15 minut? To wystarczy, żeby uruchomić własnego asystenta AI dostępnego przez WhatsApp – komunikator, którego i tak używa większość polskich firm. Klucz jest prosty: nie zaczynasz od superautomatyzacji, tylko od stabilnej konfiguracji kanału i krótkiego testu, czy Gateway odbiera i wysyła wiadomości.

W tym poradniku dostajesz instrukcję „kopiuj-wklej”: instalacja, onboarding, logowanie przez WhatsApp Web (QR), a na końcu szybka diagnostyka. Bez marketingu. Konkretne komendy i kilka zasad, które oszczędzają czas, gdy coś nie zadziała za pierwszym razem.

Jeśli chcesz zrozumieć, czym jest OpenClaw (i dlaczego self-hosted asystent bywa bardziej praktyczny niż kolejna aplikacja SaaS), zacznij od tego tekstu: /blog/czym-jest-openclaw-asystent-ai-dla-przedsiebiorcow. A teraz przechodzimy do wdrożenia.

1. Zanim zaczniesz: wymagania i 3 decyzje, które warto podjąć
2. Krok 1: instalacja OpenClaw
3. Krok 2: onboarding i uruchomienie Gateway
4. Krok 3: logowanie do WhatsApp (QR) i test
5. Rozwiązywanie problemów: 6 najczęstszych przypadków
6. Co dalej: jak rozwijać asystenta bez chaosu

Zanim zaczniesz: wymagania i 3 decyzje, które warto podjąć

Zanim wpiszesz pierwszą komendę, upewnij się, że masz dwie rzeczy: Node.js w wersji 22+ oraz klucz API do modelu (np. Anthropic/Claude). OpenClaw jest platformą, która spina kanały komunikacji i narzędzia, ale do „mózgu” potrzebuje dostępu do modelu. Bez klucza API instalacja przejdzie, ale asystent nie będzie odpowiadał.

Druga sprawa to WhatsApp. Technicznie działa to przez połączenie WhatsApp Web (kod QR), więc potrzebujesz telefonu z WhatsAppem oraz chwili spokoju na sparowanie urządzenia. W praktyce najczęstsze błędy wynikają nie z „AI”, tylko z tego, że konto WhatsApp nie jest poprawnie podłączone albo sesja wygasła.

Trzecia sprawa to decyzja organizacyjna: czy używasz dedykowanego numeru, czy swojego prywatnego. Dedykowany numer jest zwykle lepszy, bo oddziela testy i automatyzacje od prywatnych rozmów. Jeśli jednak chcesz tylko sprawdzić, czy to działa, możesz zacząć od numeru osobistego i pisać do siebie.

Krok 1: instalacja OpenClaw

Najprościej jest zainstalować OpenClaw przez oficjalny instalator. To podejście jest wygodne, bo składa się z jednego polecenia i automatycznie instaluje CLI (oraz Node, jeśli jest potrzebny). W praktyce to najszybsza droga, jeśli nie chcesz ręcznie konfigurować środowiska.

Na macOS/Linux/WSL możesz uruchomić instalator tak (z wymuszeniem HTTPS):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Po instalacji sprawdź wersję:

openclaw --version

Jeśli terminal nie rozpoznaje komendy openclaw, zamknij go i otwórz ponownie (to zwykle kwestia odświeżenia PATH). Jeśli nadal nie działa, przejdź do sekcji diagnostyki.

Krok 2: onboarding i uruchomienie Gateway

Kolejny krok to onboarding – czyli kreator, który przeprowadza przez konfigurację Gateway i podstawowe ustawienia. Onboarding jest ważny, bo to on zapisuje klucze, buduje katalog roboczy i uruchamia usługę Gateway w tle, jeśli poprosisz o instalację daemona.

Uruchom kreator:

openclaw onboard --install-daemon

W trakcie kreatora podasz klucz API do wybranego dostawcy oraz wybierzesz kanały. Jeśli robisz to pierwszy raz, nie komplikuj: ustaw minimum, a dopiero potem dokładaj kolejne kanały i integracje. W AI przewagę buduje konsekwencja, nie „idealna konfiguracja na dzień 1”.

Na koniec sprawdź, czy Gateway działa:

openclaw gateway status

Krok 3: logowanie do WhatsApp (QR) i test

Gdy Gateway działa, łączysz konto WhatsApp. Technicznie to logowanie WhatsApp Web: OpenClaw wyświetla kod QR, a Ty skanujesz go w aplikacji WhatsApp na telefonie. To etap, na którym najczęściej pojawia się błąd „not linked”, bo sesje WhatsApp potrafią wygasać.

Wyświetl QR (domyślny kanał to WhatsApp):

openclaw channels login --verbose

Na telefonie wejdź w WhatsApp → Ustawienia → Połączone urządzenia → Połącz urządzenie i zeskanuj kod. Po udanym połączeniu status powinien być stabilny, a wiadomości zaczną przechodzić.

Teraz wykonaj prosty test: wyślij do asystenta jedno zdanie, które pozwoli ocenić, czy odpowiedź wraca. Na przykład zapytaj: „Napisz mi 3 propozycje tytułów maila z podziękowaniem dla klienta”. Jeśli odpowiedź wraca, konfiguracja kanału działa. Dopiero wtedy warto przechodzić do „prawdziwych” automatyzacji.

Rozwiązywanie problemów: 6 najczęstszych przypadków

Jeśli coś nie działa, zacznij od najprostszej zasady: oddziel problem kanału od problemu modelu. Kanał to WhatsApp i połączenie. Model to klucz API i wybór dostawcy. Diagnostyka jest szybka, jeśli wiesz, czego szukasz.

Jeżeli nie dostajesz odpowiedzi, najpierw sprawdź status Gateway. Jeśli usługa nie działa, uruchom ją i sprawdź logi. Jeśli działa, a WhatsApp nie jest połączony, wróć do logowania QR.

Jeżeli instalacja nie dodała komendy openclaw do PATH, nie walcz z tym godzinami. W wielu przypadkach wystarczy nowa sesja terminala lub ponowne uruchomienie instalatora. A jeśli utknąłeś, wbudowane narzędzie doctor często wskaże problem szybciej niż ręczne zgadywanie.

Co dalej: jak rozwijać asystenta bez chaosu

Gdy masz działający kanał WhatsApp, naturalna pokusa brzmi: „to teraz dodajmy wszystko”. Nie rób tego. Najlepsze wdrożenia idą od jednego procesu do kolejnego: najpierw kalendarz albo e-mail, potem proste raportowanie, a dopiero później automatyzacje, które zapisują dane w systemach.

W praktyce najbezpieczniejszy start to human-in-the-loop. AI przygotowuje draft, streszczenie albo propozycję akcji, a człowiek zatwierdza. Dostajesz sporą oszczędność czasu, a jednocześnie nie ryzykujesz, że automatyzacja zrobi coś w Twoich systemach bez kontroli.

Jeśli chcesz przyspieszyć wdrożenie, zacznij od dwóch rzeczy: jednego przypadku użycia o jasnym wyniku (np. triaż maili) i prostego mierzenia (np. oszczędzony czas tygodniowo). To wystarczy, żeby odróżnić „fajne” od opłacalnego.

Chcesz uruchomić asystenta AI na WhatsApp?