OpenClaw: co to jest, jak go zainstalować i połączyć z Telegramem

OpenClaw pojawił się w moim kanale zeszłej zimy, gdy projekt dwukrotnie zmienił nazwę w ciągu tygodnia i zdobył setki tysięcy gwiazdek na GitHubie. Od tamtej pory coraz więcej osób szuka informacji o „instalacji OpenClaw” i „OpenClaw Telegram”.

Poniżej omawiam oficjalną dokumentację: czym jest to narzędzie, czym różni się od Claude Code, jak zainstalować je w Windows, macOS lub Linux, jak wybrać model i jak połączyć bota z Telegramem. Osobno poruszam też kwestię bezpieczeństwa, ponieważ OpenClaw był uwikłany w kilka głośnych incydentów.

Dowiedz się, jak korzystać z usługi w dokumentacji Ailoot.

Czym jest OpenClaw w prostych słowach?#

OpenClaw łączy model AI z Twoim botem Telegrama. Po skonfigurowaniu odpowiednich narzędzi i uprawnień może podsumowywać wiadomości lub planować przypomnienia. Proces bramy i jego lokalna konfiguracja działają na Twoim komputerze lub serwerze. Nie oznacza to, że każda rozmowa jest lokalna: przy modelu chmurowym żądanie i istotny kontekst rozmowy trafiają do jego dostawcy. Gdy łączysz się przez Ailoot, żądanie przechodzi przez Ailoot do dostawcy wybranego modelu. Lokalne wnioskowanie wymaga lokalnego modelu bez awaryjnego przełączenia do chmury; wiadomości Telegrama nadal przechodzą przez Telegram, a włączone narzędzia mogą kontaktować się z innymi usługami.

Projekt rozwija społeczność open source OpenClaw. Repozytorium na GitHubie powstało 24 listopada 2025 roku, a na 22 sierpnia 2026 roku ma 387 tysięcy gwiazdek i 81 tysięcy forków — to jeden z najszybciej rozwijających się otwartych projektów roku. Językiem programowania jest TypeScript.

Projekt ma zabawną historię nazw, którą warto znać, żeby nie pogubić się w starszych artykułach. Początkowo nazywał się Warelay i był bramą dla WhatsAppa. Potem stał się Clawdbotem. W styczniu 2026 roku Anthropic poprosił o zmianę nazwy z powodu znaku towarowego, więc przez kilka dni projekt nosił nazwę Moltbot. 30 stycznia 2026 roku otrzymał ostateczną nazwę: OpenClaw. Jeśli więc trafisz na instrukcje dotyczące „Clawdbota” lub „Moltbota”, chodzi o ten sam projekt; artykuły powstały po prostu przed zmianą nazwy.

Maskotką projektu jest homar Molty, a „linienie” (zmiana skorupy) stało się oficjalną metaforą kolejnych zmian nazwy.

Czym OpenClaw różni się od Claude Code i Hermes Agent?#

Często słyszę pytania o tę różnicę, bo z zewnątrz wszystkie te narzędzia wyglądają jak „agenci AI”. Oto tabela porównawcza:

Jak czytać tę tabelę? Używam Claude Code do programowania: najlepiej sprawdza się, gdy potrzebujesz mocnego modelu i pracujesz z kodem. OpenClaw i Hermes służą do czegoś innego: do agenta, który działa bez przerwy, jest dostępny w Telegramie, pamięta wczorajszą rozmowę i wykonuje zadania według harmonogramu. Wybór między OpenClaw a Hermesem jest mniej oczywisty; dostępny jest już przewodnik po Hermesie z instalacją i konfiguracją.

Jeśli dopiero wybierasz narzędzie, zacznij od przeglądu: czego ludzie używają do programowania w 2026 roku i które zadania warto zlecać agentowi AI. Mam też osobny artykuł o instalacji Claude Code.

Czego potrzebujesz przed instalacją OpenClaw?#

Sprawdź wcześniej wersję Node — to jedyny ścisły wymóg:

node --version

Obsługiwane są wersje 22.22.3+, 24.15+ i 25.9+; zalecana jest wersja Node 26. Jeśli polecenie zwróci „command not found” albo masz starą wersję, nie martw się: oficjalny instalator pobierze nowszą wersję Node, więc nie musisz niczego instalować ręcznie.

Pozostaje wybór modelu. OpenClaw sam nie myśli — wywołuje wybrany przez Ciebie model. Dostępne są dwie opcje kosztowe: klucz Anthropic, OpenAI lub Google — płacisz dostawcy za faktyczne użycie; albo model lokalny przez Ollama — bez opłat, ale wymagający sprzętowo. Obie opcje omawiam niżej w osobnych sekcjach.

Jak zainstalować OpenClaw w macOS i Linuxie?#

Zalecana metoda to oficjalny instalator:

1. Uruchom instalator

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

   Skrypt wykrywa system operacyjny, sprawdza Node (i w razie potrzeby go instaluje), instaluje OpenClaw, a następnie otwiera kreator konfiguracji. Jeśli chcesz najpierw rozejrzeć się po programie, zanim uruchomisz kreator, dodaj flagę: bash -s -- --no-onboard.

2. Sprawdź, czy instalacja się powiodła

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Pierwsze polecenie wyświetla wersję, drugie sprawdza konfigurację, a trzecie potwierdza, że brama działa i nasłuchuje na porcie 18789.

Jeśli korzystasz z npm i chcesz samodzielnie zarządzać instalacją:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Warto zwrócić uwagę na niedawną pułapkę, opisaną w osobnym rozdziale dokumentacji. npm 12 domyślnie blokuje skrypty instalacyjne pakietów. Bez flagi --allow-scripts=openclaw instalacja zatrzyma się z komunikatem allowScripts. W npm 11.15 i wcześniejszych wersjach flaga nie jest potrzebna — to ograniczenie jeszcze nie obowiązuje. Sprawdź wersję poleceniem: npm --version.

Flaga --install-daemon w drugim poleceniu konfiguruje autostart: w macOS jest to LaunchAgent, a w Linuxie usługa systemd. Uruchamia bramę po restarcie lub logowaniu zgodnie z warunkami menedżera usług. Nie zapobiega uśpieniu ani nie działa przy wyłączonym komputerze. Odpowiedzi Telegrama wymagają aktywnego hosta z siecią; do odpowiedzi przy uśpionym lub wyłączonym laptopie użyj stale działającego serwera.

Jak zainstalować OpenClaw w Windows?#

Pierwsza opcja jest przeznaczona dla osób, które wolą okna od terminala. Windows Hub to natywna aplikacja OpenClaw dla Windows 10 (20H2+) i Windows 11, obecnie w wersji beta. Przejdź na stronę wydań Windows Hub i pobierz instalator dla swojego procesora: OpenClawCompanion-Setup-x64.exe dla zwykłych komputerów lub arm64 dla ARM. Po instalacji OpenClaw Companion pojawi się w menu Start, wraz z ikoną w zasobniku systemowym, oknem czatu i ustawieniami.

Przy pierwszym uruchomieniu aplikacja zaproponuje „Set up locally” — zaakceptuj tę opcję. Utworzy ona dedykowane środowisko WSL o nazwie OpenClawGateway, zainstaluje w nim bramę i połączy się z nią. Nie zmieni istniejącej instalacji Ubuntu, jeśli ją masz.

Druga opcja to PowerShell:

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

Pierwsza linia instaluje OpenClaw, a druga rejestruje autostart w Harmonogramie zadań Windows. Jeśli zasady komputera blokują tworzenie zadań, OpenClaw sam przełączy się na rozwiązanie awaryjne: skrót w folderze Autostart, który uruchomi bramę po zalogowaniu.

Trzecia opcja to WSL2, które dokumentacja określa jako najbardziej zgodne środowisko uruchomieniowe w Windows. Zainstaluj Ubuntu, włącz systemd, a następnie wykonaj instrukcje dla Linuxa z poprzedniej sekcji:

wsl --install -d Ubuntu-24.04

W WSL włącz systemd w /etc/wsl.conf (sekcja [boot], wiersz systemd=true), uruchom ponownie WSL poleceniem wsl --shutdown w PowerShell, a następnie zainstaluj OpenClaw poleceniem dla Linuxa. Jeśli „dystrybucja” i „systemd” nic Ci nie mówią, użyj Windows Hub; wykona te kroki za Ciebie.

Jak wybrać model i dokończyć początkową konfigurację?#

Model jest silnikiem asystenta. Kreator konfiguracji wyświetli listę dostawców. Oto trzy praktyczne opcje:

Anthropic ma przydatną funkcję: jeśli Claude Code jest już zainstalowany na Twoim urządzeniu i jesteś w nim zalogowany, OpenClaw może skorzystać z tego logowania. Najpierw uruchom na urządzeniu claude auth login, a następnie wskaż OpenClaw, aby z niego korzystał:

openclaw models auth login --provider anthropic --method cli --set-default

Jeśli brama działa jako usługa w tle (tak jest w przypadku użycia --install-daemon), klucz musi być dostępny dla tej usługi. W tym celu umieść go w ~/.openclaw/.env — kreator robi to za Ciebie, więc nie musisz ręcznie edytować pliku. Po każdej zmianie uruchom ponownie i sprawdź:

openclaw gateway restart
openclaw models status

Jeśli opłacenie dostępu jest problemem, wybierz model lokalny z sekcji o Ollama.

Jak połączyć OpenClaw z Telegramem?#

Telegram to najszybszy kanał do połączenia: potrzebujesz tylko tokena bota, bez weryfikacji konta firmowego. Dokumentacja nazywa to najłatwiejszym sposobem na rozpoczęcie rozmowy z asystentem w telefonie. Oto pełna procedura:

1. Utwórz bota przez BotFather

   Otwórz czat z @BotFather w Telegramie (upewnij się, że to dokładnie ta nazwa użytkownika — istnieje wiele fałszywych kont), wyślij /newbot, a następnie wybierz nazwę i nazwę użytkownika kończącą się na bot. W odpowiedzi otrzymasz token podobny do 123456789:ABCdef... — to klucz do Twojego bota, więc chroń go jak hasło.

2. Wpisz token w OpenClaw

   Najłatwiej zrobić to przez kreator: uruchom openclaw configure i wybierz kanał Telegram. Alternatywnie możesz użyć ustawienia channels.telegram.botToken lub zmiennej środowiskowej TELEGRAM_BOT_TOKEN. Dokumentacja wyraźnie zaznacza, że polecenie openclaw channels login telegram nie istnieje; Telegram łączy się wyłącznie za pomocą tokena.

3. Uruchom bramę i napisz do bota

   openclaw gateway
   

   Otwórz swojego bota w Telegramie i wyślij mu wiadomość. Odpowie ośmioznakowym kodem parowania. To zabezpieczenie: wiadomości nie będą przetwarzane, dopóki nie zatwierdzisz nadawcy.

4. Zatwierdź siebie

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Kod jest ważny przez godzinę, więc nie zwlekaj. Pierwszy zatwierdzony nadawca automatycznie staje się właścicielem uprawnień do poleceń uprzywilejowanych.

Są tu dwa podchwytliwe zagadnienia, na które ludzie często natrafiają.

Pierwsze to grupy. OpenClaw domyślnie blokuje wszystkie grupy: musisz jawnie zezwolić botowi w ustawieniach channels.telegram.groups i pozostawić w grupie włączony tryb requireMention: true. Wtedy będzie odpowiadać tylko po wywołaniu jego nazwy użytkownika i nie włączy się do zwykłej rozmowy. Telegram ma też własny tryb prywatności botów: w grupie bot domyślnie widzi tylko polecenia. Wyłącz go przez /setprivacy u @BotFather. Po zmianie ustawienia musisz usunąć bota z grupy i dodać go ponownie, inaczej Telegram go nie zastosuje.

Drugie zagadnienie to nieotwieranie dostępu dla wszystkich. Ustawienia mają tryb dmPolicy: "open" z gwiazdką na liście dostępu: każdy, kto znajdzie bota po nazwie użytkownika, może mu wydawać polecenia. W przypadku osobistego asystenta to prosta droga do oddania komuś innemu kontroli nad Twoim komputerem. Pozostaw włączone parowanie kodem albo wpisz swój identyfikator numeryczny w allowFrom.

Jak uruchomić OpenClaw z modelem lokalnym przez Ollama?#

Ta opcja utrzymuje wnioskowanie modelu na Twoim sprzęcie, jeśli wybierzesz ścieżkę wyłącznie lokalną bez awaryjnego przełączenia do chmury; nie wymaga płatnego endpointu modelu. Nie oznacza to lokalności całego przepływu Telegrama: wiadomości nadal przechodzą przez Telegram, a włączone narzędzia online mogą wysyłać dane do innych usług.

1. Zainstaluj Ollama

   Pobierz instalator ze strony ollama.com/download — dostępne są wersje dla macOS, Windows i Linuxa.

2. Pobierz model

   ollama pull gemma4
   

3. Połącz Ollama z OpenClaw

   openclaw onboard
   

   Wybierz dostawcę Ollama i tryb: Local only (wyłącznie własne modele), Cloud only (modele z ollama.com) albo Cloud + Local. Kreator znajdzie lokalny serwer i wyświetli zainstalowane modele.

4. Sprawdź

   openclaw models list --provider ollama
   

Oto uczciwe zastrzeżenie, bez którego ta sekcja brzmiałaby jak reklama. Dokumentacja OpenClaw mówi wprost, że komfortowa praca agenta z modelem lokalnym wymaga sprzętu na poziomie dwóch w pełni wyposażonych komputerów Mac Studio, a karta graficzna z 24 GB pamięci obsłuży tylko lekkie żądania i to z opóźnieniami. Małe, mocno skompresowane modele obcinają kontekst i są mniej odporne na złośliwe instrukcje ukryte w cudzym tekście. Mówiąc prościej: model lokalny na dobrym laptopie wystarczy, by „wypróbować i zrozumieć, o co w tym chodzi”, ale model chmurowy nadal jest znacznie bardziej niezawodny w codziennej pracy z asystentem korzystającym z narzędzi.

Dokumentacja zawiera jeszcze jedno ostrzeżenie dla osób konfigurujących WSL2 + Ollama + NVIDIA GPU: oficjalny instalator Ollama dla Linuxa włącza autostart z zasadą ponownego uruchamiania ustawioną na „always”. W WSL2 z GPU może to wpędzić komputer w pętlę restartów. Rozwiązaniem jest wyłączenie autostartu usługi. Jeśli napotkasz ten problem, zajrzyj do sekcji rozwiązywania problemów na stronie Ollama w dokumentacji.

Czy korzystanie z OpenClaw jest bezpieczne?#

Zacznę od najważniejszej kwestii, której nie wszyscy są świadomi. OpenClaw ma dostęp do Twojego komputera: plików, poleceń i przeglądarki. Dokumentacja mówi jasno: projekt jest przeznaczony dla jednego zaufanego użytkownika, więc nie należy udostępniać swojego bota osobom z zewnątrz. Jeśli ktoś może pisać do Twojego agenta, może użyć go do wykonywania działań na Twoim komputerze.

Podstawowe minimum:

1. Pozostaw włączone parowanie kodem albo użyj listy dostępu — opisuję konfigurację w sekcji o Telegramie.
2. Nie wystawiaj bramy na zewnątrz, jeśli nie musisz. Domyślnie nasłuchuje tylko na Twoim komputerze; pozostaw ją tak skonfigurowaną.
3. Po każdej zmianie konfiguracji uruchom wbudowane sprawdzenie:

openclaw security audit

Sprawdza ono otwarty dostęp, zbyt szerokie uprawnienia narzędzi, słabe tokeny i wystawione porty. Flaga --fix pozwala automatycznie naprawić niektóre wykryte problemy.

Osobna uwaga o oszustwach — to nie jest hipotetyczne zagrożenie. Gdy projekt pospiesznie zmienił nazwę w styczniu 2026 roku, w ciągu sekund przejęto stare adresy i natychmiast opublikowano adres portfela kryptowalutowego; fałszywi „programiści OpenClaw” zaczęli promować oszustwo tokenowe. Wynikają z tego dwie żelazne zasady. Pobieraj OpenClaw wyłącznie ze stron openclaw.ai lub github.com/openclaw/openclaw. Projekt nie ma własnej kryptowaluty: każdy „token OpenClaw” to oszustwo. Pod żadnym pozorem nie wysyłaj na niego pieniędzy.

Co OpenClaw potrafi po instalacji?#

Oto, co wypróbowałbym po kolei:

1. Brama i model. Uruchom openclaw gateway status, a potem otwórz openclaw dashboard. Załadowany panel potwierdza dostępność Control UI. W jego czacie wyślij „Odpowiedz: test połączenia modelu” i sprawdź, czy otrzymasz odpowiedź AI; samo otwarcie strony nie testuje modelu.
2. Telegram i docelowe zadanie. Po skonfigurowaniu bota i zatwierdzeniu własnego parowania wyślij nową wiadomość do tego bota w Telegramie i sprawdź, czy odpowiedź dotrze tam. Potem wykonaj jedno ograniczone zadanie z widocznym wynikiem, np. podsumowanie nieszkodliwego folderu testowego, na którego odczyt zezwoliłeś. Przy przypomnieniu sprawdź osobno zapisany harmonogram i dostarczenie przypomnienia. Odpowiedź w panelu nie potwierdza dostarczenia do Telegrama ani wykonania zaplanowanego zadania.
3. Zaplanowane zadania. Asystent może wykonywać zadania zgodnie z harmonogramem — na przykład wysyłać poranne podsumowanie w Telegramie lub regularnie sprawdzać pocztę. Dlatego warto utrzymywać bramę włączoną przez całą dobę.
4. Pamięć. OpenClaw przechowuje długoterminową pamięć w zwykłych plikach Markdown w folderze roboczym: kim jesteś, jak ma Ci odpowiadać i co zapamiętał z wcześniejszych rozmów. Możesz samodzielnie otworzyć i przeczytać te pliki — nie ma tu czarnej skrzynki.
5. Umiejętności. Projekt ma katalog gotowych umiejętności i wtyczek z wbudowanymi kontrolami bezpieczeństwa. Umiejętność kogoś innego to kod tej osoby na Twoim komputerze, dlatego katalog je sprawdza.

Jest tu jedna zasada: nie włączaj wszystkiego naraz. Zacznij od jednej stabilnej rozmowy, potem dodaj Telegram, a na końcu harmonogramy. Dzięki temu każdy problem ujawni się na osobnym etapie, zamiast zamienić się w „wszystko się zepsuło i nie wiem gdzie”.

Co zrobić, jeśli instalacja nie działa?#

Omówmy trzy częste sytuacje.

„openclaw: command not found” zaraz po instalacji. Prawie zawsze chodzi o problem ze ścieżką: folder globalnych pakietów npm nie znajduje się w PATH terminala. Dokumentacja zaleca następujące polecenia diagnostyczne:

node -v
npm prefix -g
echo "$PATH"

Ścieżka zwrócona przez drugie polecenie powinna być widoczna w wyniku trzeciego. Jeśli jej tam nie ma, dodaj ją do ustawień powłoki albo po prostu zamknij i ponownie otwórz terminal: czasami ścieżka Node pojawia się dopiero w nowej sesji po instalacji.

Brama działa, ale asystent milczy. Objaw opisany w FAQ dokumentacji: brak odpowiedzi na pierwszą wiadomość i licznik tokenów wskazujący zero. Oznacza to, że agent nawet nie wystartował — najczęściej przyczyną jest brak konfiguracji modelu. Sprawdź kolejno:

openclaw gateway restart
openclaw status
openclaw models status

Jeśli model jest skonfigurowany, a odpowiedzi nadal nie ma, polecenie openclaw logs --follow wyświetli bieżący dziennik i pokaże, na czym proces się zatrzymuje.

Bot Telegram nie odpowiada. Sprawdź kolejno: czy token należy do bota, do którego piszesz; czy brama działa (openclaw gateway status); i czy zatwierdzono Twoje parowanie (openclaw pairing list telegram). Kod parowania jest ważny przez godzinę — jeśli pisałeś do bota wczoraj, po prostu napisz ponownie i zatwierdź nowy kod.

Gdy zupełnie utkniesz, dokumentacja sugeruje coś nieoczekiwanego, ale rozsądnego: przekaż diagnostykę lokalnemu agentowi AI, który widzi Twój komputer. Claude Code lub Codex, otrzymując wyniki openclaw status --all i openclaw doctor, mogą szybciej zrozumieć konfigurację niż czat pomocy technicznej. I koło się zamyka — AI naprawia AI.

O co jeszcze ludzie pytają w związku z OpenClaw?#

Poznaj Ailoot.