# 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

### 1. 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.

### 2. Zainstaluj OpenClaw

Uruchom oficjalny instalator dla swojego systemu. Wykryje system operacyjny, doinstaluje Node, jeśli go brakuje, zainstaluje OpenClaw, a następnie uruchomi konfigurację.

```bash
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
```

### 3. 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.

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. 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.

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. 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.

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. 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.

```bash
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.