Strona główna / Artykuły / ClawdBot

Jak zainstalować ClawdBot

27 stycznia 2026 12 min czytania

ClawdBot to Twój osobisty asystent AI, który działa non-stop na tanim serwerze. Wyślij wiadomość przez Telegram lub WhatsApp, a Claude odpowie - ze pełną wiedzą o Tobie i Twoich projektach. Ten poradnik przeprowadzi Cię przez cały proces instalacji, od utworzenia serwera po nauczenie bota informacji o sobie.

Czego będziesz potrzebować

  • Konto home.pl — około 30-40 zł miesięcznie za serwer VPS
  • Subskrypcja Claude (Pro/Max) lub klucz API Anthropic
  • Konto Telegram — do komunikacji z botem
  • Terminal — Mac: Terminal wbudowany / Windows: PowerShell (pokażę jak skonfigurować SSH)
Dla początkujących: Nie martw się, jeśli nie znasz tych narzędzi. Przewodnik poprowadzi Cię krok po kroku, wszystko wytłumaczę prostym językiem.

Część 1: Utworzenie serwera

1.1 Zakładanie serwera na home.pl

Serwer VPS to komputer działający w internecie 24/7, na którym będzie pracował Twój bot.

  1. Wejdź na home.pl/vps
  2. Załóż konto lub zaloguj się
  3. Wybierz plan VPS (zalecany: VPS Start lub VPS Optimal - od 30 zł/miesiąc)
  4. Wybierz system operacyjny: Ubuntu 24.04 lub Ubuntu 22.04
  5. Podczas zamówienia możesz dodać klucz SSH (zobacz sekcję poniżej) lub ustawić hasło root
  6. Dokończ zamówienie i poczekaj na e-mail z danymi do logowania
  7. W e-mailu znajdziesz adres IP serwera - zapisz go, będzie potrzebny
Wskazówka: Jeśli nie dodałeś klucza SSH podczas zamówienia, możesz użyć hasła które otrzymałeś w e-mailu. Klucz SSH jest bezpieczniejszy, ale hasło też zadziała.

1.2 Jak ustawić SSH na Windows (PowerShell)

Windows 10/11 ma wbudowany klient SSH w PowerShell. Nie musisz nic instalować!

Sprawdź czy SSH jest dostępny:

powershell 
ssh -V

Jeśli zobaczysz wersję SSH - jesteś gotowy! Jeśli nie, włącz OpenSSH Client:

  1. Otwórz PowerShell jako Administrator (PPM na Start → Windows PowerShell (Admin))
  2. Wykonaj komendę:
powershell 
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

1.3 Generowanie klucza SSH (Windows PowerShell)

Klucz SSH to bezpieczny sposób logowania się do serwera bez hasła.

Sprawdź czy masz już klucz:

powershell 
cat ~/.ssh/id_rsa.pub

Jeśli zobaczysz błąd "nie można znaleźć ścieżki", stwórz nowy klucz:

powershell 
ssh-keygen -t ed25519 -C "twoj-email@example.com"

Wciśnij Enter 3 razy (domyślna lokalizacja, bez hasła). Następnie wyświetl swój klucz publiczny:

powershell 
cat ~/.ssh/id_ed25519.pub

1.4 Jak ustawić SSH na Mac/Linux

Na Mac i Linux SSH jest już wbudowany w Terminal.

Sprawdź czy masz klucz SSH:

bash 
cat ~/.ssh/id_rsa.pub

Jeśli nie masz klucza, stwórz go:

bash 
ssh-keygen -t ed25519 -C "twoj-email@example.com"
cat ~/.ssh/id_ed25519.pub

1.5 Dodanie klucza SSH do serwera home.pl

Jeśli zamówiłeś serwer bez klucza SSH, możesz go dodać później przez panel home.pl:

  1. Zaloguj się do panel.home.pl
  2. Przejdź do swojego serwera VPS
  3. Znajdź sekcję "Klucze SSH" lub "SSH Keys"
  4. Wklej skopiowany klucz publiczny (cały tekst zaczynający się od "ssh-ed25519" lub "ssh-rsa")
  5. Zapisz zmiany
Ważne: Klucz publiczny (z końcówką .pub lub wyświetlony po komendzie cat) można bezpiecznie udostępniać. Klucz prywatny (bez .pub) to jak hasło - nigdy go nie udostępniaj!

Część 2: Połączenie i zabezpieczenie serwera

2.1 Połącz się z serwerem przez SSH

Otwórz Terminal (Mac/Linux) lub PowerShell (Windows) i wpisz (zamień YOUR-SERVER-IP na adres IP serwera z home.pl):

bash 
ssh root@YOUR-SERVER-IP
Dla użytkowników Windows: Użyj PowerShell (nie CMD). Komenda SSH działa tak samo jak na Mac/Linux. Jeśli to pierwsze połączenie, pojawi się pytanie "Are you sure you want to continue connecting?" - wpisz "yes" i wciśnij Enter.

Jeśli nie skonfigurowałeś klucza SSH, zostaniesz poproszony o hasło (otrzymałeś je w e-mailu od home.pl).

2.2 Zaktualizuj system

To jak aktualizacja Windows - instaluje najnowsze poprawki bezpieczeństwa:

bash 
apt update && apt upgrade -y

2.3 Stwórz bezpiecznego użytkownika

Konto "root" ma pełną kontrolę - to niebezpieczne. Stwórzmy zwykłe konto:

bash 
adduser YOUR-USERNAME

Ustaw hasło i wciśnij Enter przez wszystkie pytania. Następnie daj temu użytkownikowi uprawnienia administratora:

bash 
usermod -aG sudo YOUR-USERNAME

2.4 Włącz logowanie SSH dla nowego użytkownika

Skopiuj klucz SSH do nowego konta:

bash 
mkdir -p /home/YOUR-USERNAME/.ssh
cp ~/.ssh/authorized_keys /home/YOUR-USERNAME/.ssh/
chown -R YOUR-USERNAME:YOUR-USERNAME /home/YOUR-USERNAME/.ssh
chmod 700 /home/YOUR-USERNAME/.ssh
chmod 600 /home/YOUR-USERNAME/.ssh/authorized_keys

2.5 Przełącz się na nowego użytkownika

bash 
su - YOUR-USERNAME

Część 3: Instalacja wymaganych programów

3.1 Zainstaluj Node.js 22+

Node.js to środowisko, które pozwala uruchamiać programy JavaScript (w tym ClawdBot).

bash 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Zamknij i otwórz ponownie Terminal, albo uruchom:

bash 
source ~/.bashrc

Teraz zainstaluj Node.js:

bash 
nvm install 22
node --version

3.2 Włącz pnpm

pnpm to menedżer paczek - program do instalowania innych programów:

bash 
corepack enable pnpm

Część 4: Instalacja ClawdBot

Opcja A: Szybka instalacja (Zalecana)

To automatyczny skrypt, który zrobi wszystko za Ciebie:

bash 
curl -fsSL https://clawd.bot/install.sh | bash

Opcja B: Instalacja ręczna

bash 
npm install -g clawdbot@latest

Sprawdź czy instalacja się udała

bash 
clawdbot --version
Sukces! Jeśli widzisz numer wersji, ClawdBot został zainstalowany poprawnie.

Część 5: Konfiguracja początkowa

Teraz uruchomimy kreator, który zada Ci kilka pytań i skonfiguruje bota:

bash 
clawdbot onboard --install-daemon

Jak odpowiadać na pytania kreatora:

  • Gateway: Wybierz "Local"
  • Runtime: Wybierz "Node" (wymagane dla WhatsApp/Telegram)
  • Auth: Wybierz swoją metodę (zobacz Część 6)
  • Messaging: Wybierz "Telegram" (najłatwiejsze dla początkujących)
  • Install daemon: Wybierz "Yes"

Część 6: Ustawienie dostępu do Claude

6.1 Na swoim komputerze (NIE na serwerze VPS)

Otwórz nowy Terminal na swoim komputerze i zainstaluj Claude CLI:

bash 
npm install -g @anthropic-ai/claude-code

Wygeneruj token dostępu:

bash 
claude setup-token

Jeśli jesteś już zalogowany:

bash 
claude setup-token --force
Ważne: Skopiuj wyświetlony token - zaraz go użyjesz!

6.2 Wróć na serwer VPS

W Terminalu podłączonym do serwera wykonaj:

bash 
clawdbot models auth add

Wybierz:

  • Provider: anthropic
  • Method: paste token
  • Wklej skopiowany wcześniej token

6.3 Zrestartuj bota

bash 
clawdbot daemon restart

Część 7: Połączenie z Telegramem

7.1 Stwórz bota przez BotFather

BotFather to oficjalny bot Telegrama do tworzenia innych botów.

  1. Otwórz Telegram
  2. Wyszukaj @BotFather
  3. Wyślij wiadomość /newbot
  4. Podaj nazwę dla swojego bota (np. "Mój Asystent AI")
  5. Podaj nazwę użytkownika (musi kończyć się na "bot", np. "mojasystent_bot")
  6. Skopiuj otrzymany token (długi ciąg znaków)

7.2 Dodaj token do ClawdBot

Wróć do Terminala z serwerem i uruchom:

bash 
clawdbot configure --section telegram

Wklej token z BotFather, a następnie zrestartuj bota:

bash 
clawdbot daemon restart

Część 8: Zatwierdzenie połączenia (Parowanie)

8.1 Napisz do swojego bota

Otwórz Telegram, znajdź swojego bota i wyślij "Cześć!"

Uwaga: Bot jeszcze nie odpowie - to funkcja bezpieczeństwa. Musisz najpierw zatwierdzić połączenie.

8.2 Zatwierdź parowanie

Na serwerze uruchom:

bash 
clawdbot pairing list telegram

Skopiuj pokazany kod, a następnie wykonaj:

bash 
clawdbot pairing approve telegram KOD

8.3 Przetestuj!

Wyślij kolejną wiadomość do bota - tym razem powinien odpowiedzieć!

Gratulacje! Twój bot działa! Możesz teraz rozmawiać z Claude przez Telegram.

Część 9: Dostęp do panelu administracyjnego

9.1 Uruchom tunel SSH

Tunel SSH pozwala bezpiecznie przeglądać panel bota w przeglądarce.

Na Mac/Linux (Terminal):

bash 
ssh -N -L 18789:127.0.0.1:18789 YOUR-USERNAME@YOUR-SERVER-IP

Na Windows (PowerShell):

powershell 
ssh -N -L 18789:127.0.0.1:18789 YOUR-USERNAME@YOUR-SERVER-IP
Wskazówka: Zostaw to okno Terminala/PowerShell otwarte - wygląda jakby się zawiesił, ale to normalne. Tak powinno być. Dopóki to okno jest otwarte, tunel działa.

9.2 Otwórz panel w przeglądarce

Otwórz nową kartę w przeglądarce (najlepiej w trybie incognito) i wejdź na:

url 
http://localhost:18789/?token=TWOJ-TOKEN

Token został pokazany podczas konfiguracji. Jeśli go zgubiłeś, na serwerze uruchom:

bash 
cat ~/.clawdbot/clawdbot.json | grep token

Część 10: Naucz bota o sobie

To najważniejsza część! Im więcej bot będzie o Tobie wiedział, tym lepiej Ci pomoże.

Napisz do swojego bota na Telegramie:

"Chcę, żebyś przeprowadził ze mną wywiad, aby być bardziej przydatnym. Zadawaj mi pytania o moją pracę, życie, preferencje, rutynę, cele - wszystko, co musisz wiedzieć, aby być świetnym asystentem. Zadawaj po jednym pytaniu na raz."

Po zakończeniu wywiadu:

"Teraz zapisz wszystko, czego się o mnie dowiedziałeś, do pliku USER.md"

Sprawdź co bot wie o Tobie:

"Co aktualnie o mnie wiesz?"

Część 11: Dodatkowe funkcje (opcjonalnie)

Włącz wyszukiwanie w internecie

Zdobądź darmowy klucz API ze strony brave.com/search/api, a następnie:

bash 
clawdbot configure --section web

Lub po prostu powiedz botowi:

"Skonfiguruj wyszukiwanie Brave Search z tym kluczem API: TWOJ-KLUCZ"

Ustaw poranne podsumowania

Zapytaj swojego bota:

"Ustaw codzienny cron job o 7:00 rano, który wysyła mi poranne podsumowanie z pogodą w Krakowie, moimi priorytetami na dziś i najnowszymi wiadomościami AI."

Dodaj WhatsApp

bash 
clawdbot channels login

Zeskanuj kod QR w WhatsApp → Ustawienia → Połączone urządzenia.

Rozwiązywanie problemów

Błąd: "Address already in use" (tunel SSH)

Na Mac/Linux:

Zabij proces używający portu:

bash 
lsof -ti:18789 | xargs kill -9

Jeśli problem się powtarza:

bash 
launchctl unload ~/Library/LaunchAgents/com.clawdbot.gateway.plist

Na Windows (PowerShell jako Administrator):

Znajdź i zabij proces używający portu:

powershell 
netstat -ano | findstr :18789
taskkill /PID [NUMER_PID] /F

Zamień [NUMER_PID] na numer z ostatniej kolumny pierwszej komendy.

Błąd: "unauthorized" w panelu

Użyj pełnego URL z tokenem lub spróbuj w trybie incognito.

Błąd: "No API key found"

Uruchom ponownie konfigurację dostępu:

bash 
clawdbot models auth add

Bot nie odpowiada na Telegramie

Sprawdź kolejno:

  1. Czy bot działa: clawdbot daemon status
  2. Czy wszystko OK: clawdbot health
  3. Czy zatwierdziłeś parowanie (zobacz Część 8)
  4. Sprawdź logi: clawdbot logs --tail 50

Jak sprawdzić na jakim użytkowniku jestem zalogowany?

bash 
whoami

Jak sprawdzić czy jestem na serwerze (a nie lokalnie)?

bash 
hostname

Przydatne komendy

bash 
clawdbot health          # Sprawdź czy wszystko działa
clawdbot status          # Szybki przegląd statusu
clawdbot daemon status   # Sprawdź czy daemon działa
clawdbot daemon restart  # Zrestartuj bota
clawdbot daemon stop     # Zatrzymaj bota
clawdbot logs --follow   # Oglądaj logi na żywo
clawdbot pairing list telegram  # Zobacz oczekujące zatwierdzenia
clawdbot channels login  # Podłącz WhatsApp (skanowanie QR)
clawdbot doctor          # Diagnozuj problemy
clawdbot configure --section web  # Ustaw wyszukiwanie w internecie
clawdbot models auth add # Dodaj/zmień autoryzację AI

Profesjonalne wskazówki

  • Poproś bota, żeby wykonywał komendy za Ciebie - nie musisz logować się przez SSH
  • Przekazuj klucze API bezpośrednio botowi - sam się skonfiguruje
  • Używaj wiadomości głosowych - świetne do szybkiego notowania pomysłów
  • Zapytaj o sugestie: "Jakie automatyzacje byś zasugerował na podstawie tego, co o mnie wiesz?"

Przydatne linki