Jak zainstalować OpenClaw i połączyć go z Telegramem
Przygotuj się na około pół godziny pracy — od czystego komputera do agenta, który odpowiada Ci w Telegramie. Podane polecenia pochodzą z oficjalnej dokumentacji, dlatego porównaj je z dokumentacją wersji, którą instalujesz.
Czego potrzebujesz
- Komputer lub VPS z systemem macOS, Linux, WSL2 albo Windows
- Node 24.16+ lub Node 26 — instalator może zainstalować tę wersję za Ciebie
- Klucz API lub subskrypcja modelu albo model lokalny
- Konto Telegram
Krok po kroku
-
Wybierz maszynę i utwórz bota
Do testów wystarczy laptop, ale agent, który ma działać cały czas, powinien działać na niewielkim VPS-ie lub serwerze domowym. Portu gateway nie wolno wystawiać do internetu. W Telegramie napisz do @BotFather, dokładnie sprawdzając nazwę użytkownika, wpisz /newbot i skopiuj otrzymany token.
-
Zainstaluj OpenClaw
Uruchom oficjalny instalator dla swojego systemu. Wykryje system operacyjny, doinstaluje Node, jeśli go brakuje, zainstaluje OpenClaw, a następnie uruchomi konfigurację.
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
-
Skonfiguruj OpenClaw i zainstaluj usługę gateway
Wybierz Quick start, aby użyć wykrytego dostępu do AI, lub Custom setup, aby skonfigurować wszystkie opcje. Po zakończeniu konfiguracji zatrzymaj gateway działający na pierwszym planie i zainstaluj go jako usługę w tle, aby uruchamiał się ponownie po restarcie.
openclaw onboard # after the quick start, stop the foreground gateway (Ctrl+C), then: openclaw gateway install
-
Dodaj kanał Telegram
Dodaj Telegram jako kanał, używając tokenu bota. Następnie sprawdź stan kanału, aby potwierdzić, że połączenie działa.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
-
Zatwierdź parowanie
Wyślij dowolną wiadomość do swojego bota. Nieznani nadawcy otrzymują kod parowania zamiast odpowiedzi, więc wyświetl oczekujące prośby i zatwierdź swój kod w ciągu godziny.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
-
Przeprowadź audyt i aktualizację
Uruchom wbudowany audyt bezpieczeństwa i zaktualizuj OpenClaw do wersji ze stabilnego kanału. W starszych wersjach niż 2026.4.22 występują znane krytyczne luki, więc nie pozostawaj na takiej wersji.
openclaw security audit openclaw update --channel stable
Co zrobić po konfiguracji
- Pozostaw dmPolicy ustawione na pairing, aby osoby postronne, które znajdą twojego bota, nie mogły z niego korzystać.
- Ustaw zatwierdzanie exec tak, by zawsze wymagało potwierdzenia, dopóki nie zaufasz swojej konfiguracji.
- Regularnie ponawiaj audyt bezpieczeństwa i aktualizację.
Częste błędy
- Udostępnianie portu bramy zamiast pozostawienia gateway.bind na loopback i łączenia się przez SSH lub Tailscale.
- Instalowanie wielu umiejętności innych firm. Traktuj je jak rozszerzenia przeglądarki i dodawaj tylko kilka ze źródeł, którym ufasz.
- Zapominanie, że agent uwięziony w pętli nadal zużywa tokeny modelu.