Blog

Jak uruchomić bota AI na własnym serwerze? Instalacja Clawdbot

Tomasz Leszczyński 5 min read

Dlaczego warto uruchomić bota AI na własnym serwerze zamiast w chmurze?

Clawdbot to nowoczesny, open-source’owy asystent AI, który możesz uruchomić na własnym serwerze i kontrolować przez ulubione aplikacje komunikacyjne — takie jak WhatsApp, Telegram, Discord, Slack, Signal czy iMessage. W przeciwieństwie do rozwiązań chmurowych, Clawdbot działa na Twojej infrastrukturze, daje Ci pełną kontrolę nad danymi i integracjami, oraz umożliwia wykorzystanie go jako prawdziwego asystenta AI zdolnego do wykonywania zadań. Jak uruchomić bota AI na własnym serwerze? Dowiedz się już dziś.

Jeśli nie masz jeszcze środowiska, na którym chciałbyś hostować Clawdbot 24/7, rozważ VPS Basic (30 GB NVMe, 2 GB RAM, 1 vCPU) z oferty Sferahost.pl — to ekonomiczne i wydajne rozwiązanie do obsługi takich usług.

📌 Spis treści

  1. Wymagania wstępne
  2. Instalacja Clawdbot CLI
  3. Uruchomienie kreatora (wizard)
  4. Konfiguracja i uruchomienie gateway
  5. Weryfikacja instalacji
  6. Podłączenie pierwszego kanału
  7. Zasady bezpieczeństwa — DM pairing i polityki
  8. Wysyłanie pierwszych wiadomości
  9. Najważniejsze komendy
  10. Dalsze kroki i wskazówki

1. Wymagania wstępne

Zanim zaczniesz instalację, upewnij się, że Twoje środowisko spełnia minimalne wymagania:

  • Node.js w wersji 22 lub wyższej (to podstawa działania CLI);
  • System operacyjny macOS, Linux lub Windows (w przypadku Windows zalecany WSL2);
  • Co najmniej 2 GB pamięci RAM i ok. 500 MB przestrzeni dyskowej na same narzędzia;
  • Opcjonalnie: klucz API do Brave Search — przydaje się do integracji wyszukiwania webowego w Clawdbot.

Sprawdź wersję Node.js:

node --version
# powinna być 22.x.x lub wyższa

Jeśli Node.js nie jest zainstalowany, możesz to zrobić poprzez nvm lub menedżera pakietów systemowych.

2. Instalacja Clawdbot CLI – czyli najszybsza droga do bota AI

Clawdbot CLI to narzędzie, które przeprowadzi Cię przez większość konfiguracji.

🌀 Szybka instalacja (zalecana)

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

To najprostszy sposób — skrypt zadba o pobranie i instalację.

📦 Alternatywnie przez npm lub pnpm

npm install -g clawdbot@latest

lub

pnpm add -g clawdbot@latest

Po instalacji sprawdź wersję:

clawdbot --version

— jeśli CLI zwraca numer wersji, to instalacja przebiegła pomyślnie.

3. Uruchomienie kreatora konfiguracji

Najłatwiejszym sposobem konfiguracji Clawdbot jest wbudowany wizard:

clawdbot onboard --install-daemon

Wizard poprowadzi Cię krok po kroku przez:

  • wybór trybu bramki (local albo remote);
  • konfigurację uwierzytelniania (np. klucz API Anthropic);
  • wybór modelu AI (np. anthropic/claude-opus-4-5);
  • wskazanie kanałów komunikacyjnych, które chcesz aktywować;
  • dodanie Twojego numeru do allowlist (np. dla WhatsApp);
  • instalację jako usługę systemową, która uruchamia Clawdbot automatycznie przy starcie serwera.

4. Uruchomienie i kontrola gateway

Po konfiguracji gateway Clawdbot powinien być gotowy do pracy.

Sprawdź status:

clawdbot gateway status

Jeśli coś nie działa, możesz uruchomić gateway z logowaniem:

clawdbot gateway --port 18789 --verbose

Po uruchomieniu bramki możesz otworzyć panel kontrolny w przeglądarce i monitorować działanie systemu.

5. Weryfikacja instalacji

Po uruchomieniu gateway warto sprawdzić, czy wszystko działa prawidłowo:

clawdbot status

Oczekiwany wynik to informacje o:

  • stanie gateway i kanałów;
  • konfiguracji autoryzacji;
  • aktywnej pamięci i użyciu zasobów.

Dla bardziej szczegółowej diagnostyki możesz użyć:

clawdbot health

To polecenie pokaże szczegółowe wskaźniki zdrowia systemu.

6. Podłączenie pierwszego kanału

Clawdbot pozwala na komunikację przez różne kanały — najpopularniejszy to WhatsApp, ale możesz też podłączyć Telegram, Discord, Slack, Signal i inne.

🔗 WhatsApp

  1. Uruchom logowanie do kanału: clawdbot channels login
  2. Zeskanuj QR kod wyświetlony w terminalu w aplikacji WhatsApp na telefonie.

Po tym Clawdbot będzie gotowy do przyjmowania i wysyłania wiadomości.

7. Bezpieczeństwo — DM pairing i polityki

Clawdbot oferuje mechanizmy bezpieczeństwa:

  • pairing – domyślna polityka, w której nowy użytkownik musi potwierdzić kod przy pierwszym kontakcie;
  • allowlist – tylko zatwierdzone numery mogą pisać do bota;
  • open – bot odpowiada wszystkim;
  • disabled – wyłącza obsługę bezpośrednich wiadomości.

To ważna część konfiguracji, zwłaszcza jeśli Twój bot ma funkcje automatyczne lub dostęp do danych.

8. Wysyłanie pierwszych wiadomości

✉️ Z aplikacji

Po zatwierdzeniu numeru:

  • Wyślij do bota pierwszą wiadomość przez WhatsApp/Telegram — bot powinien odpowiedzieć.

💬 Z CLI

Możesz też wysyłać wiadomości bezpośrednio przez CLI:

clawdbot message send --target +48123123123 --message "Cześć Clawdbot!"

To szczególnie przydatne przy automatycznych testach lub skryptach.

9. Najważniejsze komendy

Oto skrócona lista przydatnych poleceń:

  • sprawdzenie statusu gateway
    clawdbot gateway status
  • restart gateway
    clawdbot gateway restart
  • zaawansowana diagnostyka
    clawdbot doctor
  • monitorowanie zdrowia systemu
    clawdbot health

To „must-know”, jeśli chcesz utrzymać stabilność bota.

10. Dalsze kroki i wskazówki

Po uruchomieniu warto:

  • dodać więcej kanałów (Telegram, Discord, Slack itd.);
  • zautomatyzować zadania (np. przypomnienia, wysyłanie alertów);
  • przetestować integracje z innymi narzędziami (Notion, Gmail, Spotify);
  • rozważyć proste GUI albo webhooki do własnych aplikacji.

📌 Podsumowanie

Clawdbot to potężne narzędzie, które daje Ci autonomicznego asystenta AI działającego na Twojej infrastrukturze — z wieloma kanałami komunikacji, pamięcią kontekstu i możliwością wykonywania rzeczywistych działań.

Jeśli chcesz korzystać z Clawdbot w trybie 24/7, warto postawić go na stabilnym VPS-ie, na przykład VPS Basic od Sferahost.pl — to świetna opcja do długotrwałego hostingu i niezawodnej pracy bota.

Tagi: