Jak zainstalować Clawdbot na VPS

Clawdbot to open-source’owy, samodzielnie hostowany osobisty asystent AI, który łączy się z Twoimi ulubionymi platformami komunikacyjnymi. W przeciwieństwie do asystentów AI działających w chmurze, takich jak ChatGPT, Clawdbot działa całkowicie na Twojej infrastrukturze, dając Ci pełną kontrolę nad danymi i prywatnością. W tym artykule przeprowadzimy Cię przez proces instalacji Clawdbot na VPS z użyciem Node.js. Zalecamy korzystanie z LightNode jako dostawcy VPS.

Czym jest Clawdbot?

Clawdbot to potężny osobisty asystent AI, który działa w Twoich ulubionych aplikacjach i platformach komunikacyjnych. Łączy się z WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat i wieloma innymi, przekształcając duże modele językowe w naprawdę osobistego, zawsze dostępnego towarzysza. Kluczowe cechy to:

• Wsparcie wieloplatformowe: działa na ponad 10 platformach komunikacyjnych
• Pamięć trwała: zapamiętuje Twoje preferencje i wcześniejsze rozmowy
• Proaktywne działania: może podejmować akcje, ustawiać przypomnienia i wysyłać powiadomienia
• Samodzielny hosting: pełna własność danych i kontrola prywatności
• Możliwość dostosowania: rozszerzalny o umiejętności i narzędzia
• Zawsze aktywny: działa 24/7 na Twoim VPS lub lokalnej maszynie

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz:

1. Serwer VPS: Możesz wybrać spośród różnych dostawców chmurowych. Polecamy LightNode ze względu na doskonałą wydajność i globalny zasięg.
2. Podstawowa znajomość linii poleceń: Znajomość poleceń terminala będzie pomocna.
3. Zainstalowany Node.js: Upewnij się, że na serwerze jest zainstalowany Node.js w wersji 22 lub wyższej.
4. Minimalne wymagania systemowe: 2GB RAM, 1 vCPU, 10GB przestrzeni dyskowej (zalecane 4GB RAM do użytku produkcyjnego).

Dlaczego polecamy LightNode VPS

LightNode to doskonały wybór do hostingu Clawdbot z kilku powodów:

Kluczowe zalety LightNode

• Przystępne ceny: Plany zaczynają się od 7,71 USD/miesiąc z rozliczeniem godzinowym, co pozwala testować bez długoterminowych zobowiązań.
• Ponad 40 lokalizacji na świecie: Centra danych na 6 kontynentach, w tym USA, Europie, Azji, na Bliskim Wschodzie i w Afryce, zapewniają niskie opóźnienia dla użytkowników na całym świecie.
• Wysoka wydajność: Dyski NVMe SSD i procesory o wysokiej częstotliwości zapewniają doskonałą wydajność dla obciążeń AI.
• Gwarancja dostępności 99,95%: Niezawodna infrastruktura z lokalnym dostępem BGP gwarantuje, że Twój asystent jest zawsze dostępny.
• Elastyczne rozliczenia: Płać tylko za to, co wykorzystujesz, dzięki rozliczeniu godzinowemu – idealne do testów i skalowania.
• Przyjazny dla deweloperów: Pełny dostęp root, natychmiastowe wdrożenie oraz wsparcie dla Linux i Windows.
• Bezpłatne snapshoty: Jeden darmowy snapshot na VPS do łatwych kopii zapasowych i odzyskiwania.
• Bonus dla nowych użytkowników: Otrzymaj do 15 USD darmowych kredytów przy pierwszym doładowaniu.

Zalecana konfiguracja LightNode dla Clawdbot

Ta konfiguracja zapewnia wystarczające zasoby do działania Clawdbot i pozwala na rozwój wraz ze wzrostem użytkowania.

Rozpocznij z LightNode

Krok 1: Konfiguracja VPS

1. Uruchom instancję: Zaloguj się do LightNode i utwórz nową instancję VPS. Zalecamy wybór lokalizacji bliskiej Twoim głównym użytkownikom dla optymalnego opóźnienia. Dla globalnego dostępu Singapur lub Hongkong to świetny wybór dla użytkowników azjatyckich, a Silicon Valley dla użytkowników z Ameryki Północnej.

2. Wybierz system operacyjny: Wybierz Ubuntu 22.04 LTS (zalecane) lub Ubuntu 24.04. Te wersje mają doskonałe wsparcie dla Node.js i są szeroko testowane.

3. Dostęp SSH: Użyj klienta SSH, aby uzyskać dostęp do serwera:

   ssh username@your_server_ip
   

Krok 2: Instalacja Node.js

Clawdbot wymaga Node.js w wersji 22 lub wyższej. Oto jak go zainstalować na Ubuntu:

# Aktualizacja list pakietów
sudo apt update

# Instalacja Node.js 22 z repozytorium NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Weryfikacja instalacji
node --version
# Powinno wyświetlić: v22.x.x

Alternatywnie możesz użyć NVM (Node Version Manager) dla większej elastyczności:

# Instalacja NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Instalacja Node.js 22
nvm install 22
nvm use 22

# Weryfikacja instalacji
node --version

Krok 3: Instalacja Clawdbot

Dostępne są różne metody instalacji. Wybierz tę, która najlepiej odpowiada Twoim potrzebom.

Metoda 1: Oficjalny skrypt instalacyjny (zalecany dla początkujących)

Skrypt instalacyjny to najprostsza metoda, automatycznie obsługująca zależności:

# Pobierz i uruchom instalator
curl -fsSL https://clawd.bot/install.sh | bash

Polecenie to:

• Wykryje Twój system operacyjny
• Sprawdzi, czy Node.js 22+ jest zainstalowany
• Zainstaluje Clawdbot globalnie przez npm
• Skonfiguruje niezbędne ścieżki
• Uruchomi polecenie doctor w celu weryfikacji instalacji

Metoda 2: Instalacja globalna przez npm

Dla użytkowników zaznajomionych z npm:

# Instalacja Clawdbot globalnie
npm install -g clawdbot@latest

# Lub używając pnpm (szybsze)
pnpm add -g clawdbot@latest

# Weryfikacja instalacji
clawdbot --version

Metoda 3: Instalacja ze źródła (dla deweloperów)

# Sklonuj repozytorium
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Zainstaluj zależności
pnpm install

# Zbuduj UI
pnpm ui:build

# Zbuduj projekt
pnpm build

# Uruchom kreatora konfiguracji
./dist/entry.js onboard --install-daemon

Metoda 4: Instalacja przez Docker (opcjonalnie)

Dla wdrożeń kontenerowych:

# Sklonuj repozytorium
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Uruchom skrypt konfiguracji Dockera
./docker-setup.sh

Krok 4: Uruchomienie kreatora konfiguracji

Po instalacji uruchom kreatora konfiguracji, aby skonfigurować Clawdbot:

# Uruchom interaktywny kreator konfiguracji
clawdbot onboard --install-daemon

Kreator poprowadzi Cię przez:

1. Konfigurację Gateway: Wybierz tryb lokalny lub zdalny oraz ustaw port gateway (domyślnie: 18789).
2. Ustawienia uwierzytelniania: Skonfiguruj dostawcę modelu AI.
   • Anthropic (Claude): klucz API lub OAuth (zalecane)
   • OpenAI (ChatGPT/Codex): klucz API
   • Inni dostawcy: niestandardowe endpointy i klucze API
3. Konfigurację kanałów: Skonfiguruj platformy komunikacyjne:
   • WhatsApp: logowanie przez kod QR
   • Telegram: token bota od @BotFather
   • Discord: token bota z Discord Developer Portal
   • Slack: OAuth lub token bota
4. Instalację usługi: Zainstaluj Gateway jako usługę działającą w tle (systemd na Linux).
5. Tożsamość agenta: Ustaw osobowość asystenta i domyślne zachowanie.

Krok 5: Uruchomienie Gateway

Po zakończeniu kreatora Gateway powinien uruchomić się automatycznie. Możesz sprawdzić jego status poleceniem:

# Sprawdź status gateway
clawdbot gateway status

# Wyświetl logi
clawdbot logs --follow

# Sprawdź stan zdrowia
clawdbot health

Ręczne uruchomienie (jeśli usługa nie działa)

# Uruchom gateway na pierwszym planie
clawdbot gateway --port 18789 --verbose

Zarządzanie usługą

# Uruchom usługę
systemctl --user start clawdbot-gateway.service

# Zatrzymaj usługę
systemctl --user stop clawdbot-gateway.service

# Zrestartuj usługę
systemctl --user restart clawdbot-gateway.service

# Włącz automatyczne uruchamianie przy starcie systemu
systemctl --user enable clawdbot-gateway.service

# Wyświetl logi usługi
journalctl --user -u clawdbot-gateway -f

Krok 6: Dostęp do panelu sterowania

Interfejs Clawdbot Control UI jest dostępny przez przeglądarkę internetową:

http://your_server_ip:18789/

Jeśli podczas kreatora konfiguracji ustawiłeś uwierzytelnianie, będziesz musiał podać token gateway, aby uzyskać dostęp do panelu.

Zdalny dostęp przez tunel SSH

Dla bezpiecznego zdalnego dostępu:

# Utwórz tunel SSH z lokalnej maszyny
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Następnie uzyskaj dostęp lokalnie
http://localhost:18789/

Krok 7: Podłączenie pierwszego kanału

WhatsApp

Aby podłączyć WhatsApp:

# Wygeneruj i wyświetl kod QR
clawdbot channels login

# Zeskanuj w WhatsApp:
# Ustawienia → Połączone urządzenia → Połącz urządzenie

Po zeskanowaniu WhatsApp połączy się z Clawdbot.

Telegram

1. Utwórz bota, pisząc do @BotFather na Telegramie
2. Postępuj zgodnie z instrukcjami, aby utworzyć nowego bota
3. Skopiuj podany token bota
4. Dodaj bota do Clawdbot:

clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

1. Wejdź na Discord Developer Portal
2. Utwórz nową aplikację
3. Włącz bota w zakładce „Bot”
4. Skopiuj token bota
5. Zaproś bota na swój serwer Discord z odpowiednimi uprawnieniami
6. Dodaj do Clawdbot:

clawdbot channels add --channel discord --token "your_discord_bot_token"

Krok 8: Konfiguracja bezpieczeństwa DM

Domyślnie Clawdbot używa trybu parowania dla wiadomości prywatnych, co oznacza, że nieznani nadawcy otrzymują kod parowania, a ich wiadomości nie są przetwarzane do momentu zatwierdzenia.

# Wyświetl oczekujące żądania parowania
clawdbot pairing list whatsapp

# Zatwierdź żądanie parowania
clawdbot pairing approve whatsapp <pairing_code>

# Wyświetl zatwierdzone parowania
clawdbot pairing list whatsapp --approved

To zachowanie możesz zmienić w pliku konfiguracyjnym ~/.clawdbot/clawdbot.json.

Krok 9: Testowanie konfiguracji

Wyślij wiadomość testową, aby sprawdzić, czy wszystko działa:

# Wyślij wiadomość testową
clawdbot message send --to +15555550123 --message "Hello from Clawdbot!"

# Lub test przez Telegram
clawdbot message send --to @your_telegram_username --message "Hello!"

Alternatywnie wyślij wiadomość bezpośrednio na podłączony WhatsApp/Telegram/Discord, a Twój asystent Clawdbot powinien odpowiedzieć.

Krok 10: Konfiguracja Nginx (opcjonalnie)

Do użytku produkcyjnego zalecamy skonfigurowanie reverse proxy z Nginx, aby zwiększyć bezpieczeństwo i zarządzać certyfikatami SSL.

Instalacja Nginx

sudo apt install -y nginx

Konfiguracja Nginx

Edytuj plik konfiguracyjny Nginx:

sudo nano /etc/nginx/sites-available/clawdbot

Dodaj następującą konfigurację:

server {
    listen 80;
    server_name your-domain.com;  # Zamień na swoją domenę

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Włączenie konfiguracji

# Utwórz dowiązanie symboliczne
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Sprawdź konfigurację Nginx
sudo nginx -t

# Zrestartuj Nginx
sudo systemctl restart nginx

Dodanie SSL za pomocą Certbot (zalecane)

# Instalacja Certbot
sudo apt install -y certbot python3-certbot-nginx

# Uzyskanie certyfikatu SSL
sudo certbot --nginx -d your-domain.com

# Certbot automatycznie skonfiguruje Nginx z SSL

Po tym Twoje Clawdbot będzie dostępne pod adresem:

https://your-domain.com/

Rozwiązywanie typowych problemów

Gateway nie chce się uruchomić

Jeśli gateway nie startuje:

# Sprawdź błędy konfiguracji
clawdbot doctor

# Zobacz szczegółowe logi
journalctl --user -u clawdbot-gateway -n 50

Błędy braku pamięci

Na VPS z 2GB RAM możesz napotkać błędy braku pamięci podczas aktualizacji. Dodaj plik wymiany (swap):

# Utwórz plik swap o rozmiarze 2GB
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Ustaw swap na stałe
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Port jest już zajęty

Jeśli port 18789 jest zajęty:

# Sprawdź, co używa portu
sudo lsof -i :18789

# Lub użyj innego portu
clawdbot gateway --port 18889

Bot nie odpowiada

Jeśli bot nie odpowiada:

1. Sprawdź status Gateway: clawdbot gateway status
2. Zweryfikuj konfigurację kanałów: upewnij się, że tokeny są poprawne i kanały aktywne
3. Sprawdź uwierzytelnianie: czy klucze API są ważne
4. Przejrzyj logi: clawdbot logs --follow w poszukiwaniu błędów

Aktualizacja Clawdbot

Aby zaktualizować do najnowszej wersji:

# Ponownie uruchom instalator
curl -fsSL https://clawd.bot/install.sh | bash

# Lub aktualizuj przez npm
npm update -g clawdbot@latest

# Zrestartuj gateway
clawdbot gateway restart

# Sprawdź stan zdrowia
clawdbot health

Podsumowanie

Instalacja Clawdbot na VPS to prosty proces, który daje Ci potężnego, samodzielnie hostowanego asystenta AI dostępnego na wielu platformach komunikacyjnych. Dzięki przystępnym cenom LightNode, globalnemu zasięgowi i wydajnej infrastrukturze możesz z powodzeniem wdrożyć swojego osobistego asystenta AI.

Postępując zgodnie z tym przewodnikiem, powinieneś mieć Clawdbot działającego na VPS w około 20-30 minut, zapewniając sobie zawsze dostępną AI, która szanuje Twoją prywatność i daje pełną kontrolę nad danymi.

Dla dalszej personalizacji i zaawansowanych funkcji odsyłamy do oficjalnej dokumentacji na Clawdbot GitHub oraz do dyskusji społecznościowych, gdzie znajdziesz dodatkowe wskazówki i porady.

Dodatkowe zasoby

• Oficjalna dokumentacja Clawdbot
• Repozytorium Clawdbot na GitHub
• LightNode VPS - polecany dostawca VPS
• Społeczność Clawdbot na Discord
• Skills Marketplace - rozszerzaj swojego asystenta o dodatkowe umiejętności