Ana içeriğe atla

VPS Üzerine Clawdbot Nasıl Kurulur

BloglarClawdbotAI AssistantVPS HostingKurulum RehberiLightNodeYaklaşık 6 dakika

VPS Üzerine Clawdbot Nasıl Kurulur

Clawdbot, favori mesajlaşma platformlarınıza bağlanan açık kaynaklı, kendi kendine barındırılan kişisel bir AI asistanıdır. ChatGPT gibi bulut tabanlı AI asistanlarının aksine, Clawdbot tamamen kendi altyapınızda çalışır ve böylece verileriniz ve gizliliğiniz üzerinde tam kontrol sağlar. Bu makalede, Node.js kullanarak bir VPS üzerinde Clawdbot kurulum sürecini adım adım anlatacağız. VPS sağlayıcınız olarak LightNode kullanmanızı öneriyoruz.

Clawdbot Nedir?

Clawdbot, favori uygulamalarınız ve mesajlaşma platformlarınız içinde yaşayan güçlü bir kişisel AI asistanıdır. WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat ve daha fazlasına bağlanarak Büyük Dil Modellerini gerçekten kişisel, her zaman erişilebilir bir yardımcıya dönüştürür. Temel özellikleri şunlardır:

  • Çoklu Platform Desteği: 10'dan fazla mesajlaşma platformunda çalışır
  • Kalıcı Hafıza: Tercihlerinizi ve geçmiş konuşmalarınızı zaman içinde hatırlar
  • Proaktif İşlemler: İşlem yapabilir, hatırlatıcılar kurabilir ve bildirimler gönderebilir
  • Kendi Kendine Barındırılan: Tam veri sahipliği ve gizlilik kontrolü
  • Özelleştirilebilir: Yetenekler ve araçlarla genişletilebilir
  • Her Zaman Açık: VPS veya yerel makinenizde 7/24 çalışır

Ön Koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  1. Bir VPS Sunucusu: Çeşitli bulut hizmet sağlayıcılarından seçim yapabilirsiniz. Mükemmel performansı ve global kapsama alanı nedeniyle LightNode öneriyoruz.
  2. Temel Komut Satırı Bilgisi: Terminal komutlarına aşina olmak faydalı olacaktır.
  3. Node.js Kurulu: Sunucunuzda Node.js 22 veya üzeri yüklü olmalıdır.
  4. Minimum Sistem Gereksinimleri: 2GB RAM, 1 vCPU, 10GB disk alanı (üretim kullanımı için 4GB RAM önerilir).

Neden LightNode VPS Öneriyoruz

LightNode, Clawdbot barındırmak için birkaç nedenle mükemmel bir seçimdir:

LightNode'un Temel Avantajları

  • Uygun Fiyatlandırma: Planlar saatlik faturalandırma ile aylık 7,71$'dan başlar, uzun vadeli taahhüt olmadan deneme imkanı sunar.
  • 40+ Küresel Lokasyon: ABD, Avrupa, Asya, Orta Doğu ve Afrika dahil 6 kıtada veri merkezleri, dünya çapında düşük gecikme sağlar.
  • Yüksek Performans: NVMe SSD depolama ve yüksek frekanslı CPU'lar AI iş yükleri için mükemmel performans sunar.
  • %99,95 Çalışma Süresi Garantisi: Yerel BGP erişimi ile güvenilir altyapı, asistanınızın her zaman erişilebilir olmasını sağlar.
  • Esnek Faturalandırma: Yalnızca kullandığınız kadar ödeyin, test ve ölçeklendirme için idealdir.
  • Geliştirici Dostu: Tam root erişimi, anında dağıtım ve hem Linux hem Windows desteği.
  • Ücretsiz Anlık Görüntüler: Her VPS için kolay yedekleme ve kurtarma için bir ücretsiz snapshot.
  • Yeni Kullanıcı Bonusu: İlk bakiye yüklemenizde 15$'a kadar ücretsiz kredi.

Clawdbot için Önerilen LightNode Konfigürasyonu

BileşenÖzellikAylık Maliyet
PlanAgency14,70$/ay
CPU2 vCPU-
RAM4GB DDR4-
Depolama50GB NVMe SSD-
Bant Genişliği2TB-
LokasyonSingapur, Hong Kong veya Silicon Valley-

Bu konfigürasyon, Clawdbot'un çalışması için yeterli kaynak sağlar ve kullanımınız arttıkça büyüme alanı sunar.

LightNode ile Başlayın

Adım 1: VPS'inizi Kurma

  1. Sunucu Başlatma: LightNode hesabınıza giriş yapın ve yeni bir VPS örneği oluşturun. En iyi gecikme için ana kullanıcılarınıza yakın bir lokasyon seçin. Küresel erişim için Asya kullanıcıları Singapur veya Hong Kong'u, Kuzey Amerika kullanıcıları ise Silicon Valley'i tercih edebilir.

  2. İşletim Sistemi Seçimi: Ubuntu 22.04 LTS (önerilen) veya Ubuntu 24.04'ü seçin. Bu sürümler Node.js desteği açısından mükemmeldir ve yaygın olarak test edilmiştir.

  3. SSH Erişimi: Sunucunuza SSH istemcisi ile bağlanın:

    ssh username@your_server_ip

Adım 2: Node.js Kurulumu

Clawdbot, Node.js 22 veya üzerini gerektirir. Ubuntu üzerinde kurulumu şöyle yapabilirsiniz:

# Paket listelerini güncelle
sudo apt update

# NodeSource deposundan Node.js 22'yi yükle
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Kurulumu doğrula
node --version
# Çıktı: v22.x.x olmalı

Alternatif olarak, daha esnek kullanım için NVM (Node Version Manager) kullanabilirsiniz:

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

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

# Kurulumu doğrula
node --version

Adım 3: Clawdbot Kurulumu

Birden fazla kurulum yöntemi mevcuttur. İhtiyacınıza en uygun olanı seçin.

Yöntem 1: Resmi Kurulum Scripti (Yeni Başlayanlar için Önerilir)

Kurulum scripti en kolay yöntemdir ve bağımlılıkları otomatik olarak yönetir:

# Kurulum scriptini indir ve çalıştır
curl -fsSL https://clawd.bot/install.sh | bash

Bu komut:

  • İşletim sisteminizi tespit eder
  • Node.js 22+ kurulu olduğundan emin olur
  • Clawdbot'u npm ile global olarak kurar
  • Gerekli yolları ayarlar
  • Kurulumu doğrulamak için doctor komutunu çalıştırır

Yöntem 2: npm Global Kurulum

npm ile rahat olan kullanıcılar için:

# Clawdbot'u global olarak yükle
npm install -g clawdbot@latest

# Veya pnpm kullanarak (daha hızlı)
pnpm add -g clawdbot@latest

# Kurulumu doğrula
clawdbot --version

Yöntem 3: Kaynaktan Kurulum (Geliştiriciler için)

# Depoyu klonla
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Bağımlılıkları yükle
pnpm install

# UI'yi derle
pnpm ui:build

# Projeyi derle
pnpm build

# Onboarding sihirbazını çalıştır
./dist/entry.js onboard --install-daemon

Yöntem 4: Docker ile Kurulum (İsteğe Bağlı)

Konteyner tabanlı dağıtım için:

# Depoyu klonla
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Docker kurulum scriptini çalıştır
./docker-setup.sh

Adım 4: Onboarding Sihirbazını Çalıştırma

Kurulumdan sonra Clawdbot'u yapılandırmak için onboarding sihirbazını başlatın:

# Etkileşimli onboarding sihirbazını başlat
clawdbot onboard --install-daemon

Sihirbaz sizi şu adımlarda yönlendirecek:

  1. Gateway Yapılandırması: Yerel veya uzak gateway modu seçin ve gateway portunu ayarlayın (varsayılan: 18789).
  2. Kimlik Doğrulama Ayarları: AI model sağlayıcınızı yapılandırın.
    • Anthropic (Claude): API anahtarı veya OAuth (önerilen)
    • OpenAI (ChatGPT/Codex): API anahtarı
    • Diğer Sağlayıcılar: Özel uç noktalar ve API anahtarları
  3. Kanal Yapılandırması: Mesajlaşma platformlarını ayarlayın:
    • WhatsApp: QR kod ile giriş
    • Telegram: @BotFather'dan bot token
    • Discord: Discord Developer Portal'dan bot token
    • Slack: OAuth veya bot token
  4. Servis Kurulumu: Gateway'i arka planda çalışan bir servis olarak kurun (Linux için systemd).
  5. Agent Kimliği: Asistanınızın kişiliğini ve varsayılan davranışını ayarlayın.

Adım 5: Gateway'i Başlatma

Onboarding sihirbazını tamamladıktan sonra Gateway otomatik olarak başlamalıdır. Durumunu kontrol etmek için:

# Gateway durumunu kontrol et
clawdbot gateway status

# Logları görüntüle
clawdbot logs --follow

# Sağlık durumunu kontrol et
clawdbot health

Servis Çalışmıyorsa Manuel Başlatma

# Gateway'i ön planda başlat
clawdbot gateway --port 18789 --verbose

Servis Yönetimi

# Servisi başlat
systemctl --user start clawdbot-gateway.service

# Servisi durdur
systemctl --user stop clawdbot-gateway.service

# Servisi yeniden başlat
systemctl --user restart clawdbot-gateway.service

# Servisin açılışta başlamasını sağla
systemctl --user enable clawdbot-gateway.service

# Servis loglarını görüntüle
journalctl --user -u clawdbot-gateway -f

Adım 6: Kontrol Paneline Erişim

Clawdbot Kontrol UI, web tarayıcınız üzerinden erişilebilir:

http://your_server_ip:18789/

Onboarding sırasında kimlik doğrulama ayarladıysanız, panele erişmek için gateway token'ını sağlamanız gerekir.

SSH Tüneli ile Uzaktan Erişim

Güvenli uzaktan erişim için:

# Yerel makinenizden SSH tüneli kurun
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Ardından yerelden erişin
http://localhost:18789/

Adım 7: İlk Kanalınızı Bağlama

WhatsApp

WhatsApp bağlamak için:

# QR kodu oluştur ve göster
clawdbot channels login

# WhatsApp ile tara:
# Ayarlar → Bağlı Cihazlar → Cihaz Bağla

QR kodu taradıktan sonra WhatsApp, Clawdbot'a bağlanacaktır.

Telegram

  1. Telegram'da @BotFather ile bot oluşturun
  2. Yeni bot oluşturma talimatlarını takip edin
  3. Sağlanan bot token'ını kopyalayın
  4. Clawdbot'a ekleyin:
clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

  1. Discord Developer Portal'a gidin
  2. Yeni bir uygulama oluşturun
  3. "Bot" sekmesinden botu etkinleştirin
  4. Bot token'ını kopyalayın
  5. Botu uygun izinlerle Discord sunucunuza davet edin
  6. Clawdbot'a ekleyin:
clawdbot channels add --channel discord --token "your_discord_bot_token"

Adım 8: DM Güvenliğini Yapılandırma

Varsayılan olarak, Clawdbot doğrudan mesajlar için eşleştirme modu kullanır; bilinmeyen göndericiler bir eşleştirme kodu alır ve mesajları onaylanana kadar işlenmez.

# Bekleyen eşleştirme isteklerini listele
clawdbot pairing list whatsapp

# Bir eşleştirme isteğini onayla
clawdbot pairing approve whatsapp <pairing_code>

# Onaylanmış eşleştirmeleri görüntüle
clawdbot pairing list whatsapp --approved

Bu davranışı ~/.clawdbot/clawdbot.json yapılandırma dosyasında değiştirebilirsiniz.

Adım 9: Kurulumunuzu Test Etme

Her şeyin çalıştığını doğrulamak için test mesajı gönderin:

# Test mesajı gönder
clawdbot message send --to +15555550123 --message "Clawdbot'tan Merhaba!"

# Veya Telegram üzerinden test et
clawdbot message send --to @your_telegram_username --message "Merhaba!"

Alternatif olarak, bağlı WhatsApp/Telegram/Discord hesabınıza doğrudan mesaj gönderin; Clawdbot asistanınız yanıt verecektir.

Adım 10: Nginx Yapılandırması (İsteğe Bağlı)

Üretim kullanımı için, güvenliği artırmak ve SSL sertifikalarını yönetmek amacıyla Nginx ile ters proxy kurmanızı öneririz.

Nginx Kurulumu

sudo apt install -y nginx

Nginx Yapılandırması

Nginx yapılandırma dosyasını düzenleyin:

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

Aşağıdaki yapılandırmayı ekleyin:

server {
    listen 80;
    server_name your-domain.com;  # Alan adınızı buraya yazın

    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;
    }
}

Yapılandırmayı Etkinleştirme

# Sembolik bağlantı oluştur
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Nginx yapılandırmasını test et
sudo nginx -t

# Nginx'i yeniden başlat
sudo systemctl restart nginx

Certbot ile SSL Ekleme (Önerilir)

# Certbot'u yükle
sudo apt install -y certbot python3-certbot-nginx

# SSL sertifikası al
sudo certbot --nginx -d your-domain.com

# Certbot Nginx'i otomatik olarak SSL ile yapılandırır

Bundan sonra Clawdbot şu adreste erişilebilir olacaktır:

https://your-domain.com/

Yaygın Sorun Giderme

Gateway Başlamıyor

Gateway başlamazsa:

# Yapılandırma hatalarını kontrol et
clawdbot doctor

# Detaylı logları görüntüle
journalctl --user -u clawdbot-gateway -n 50

Bellek Yetersizliği Hataları

2GB RAM'li VPS'lerde güncellemeler sırasında bellek yetersizliği yaşanabilir. Swap dosyası ekleyin:

# 2GB swap dosyası oluştur
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Swap kalıcı olsun
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Port Zaten Kullanımda

Port 18789 kullanımda ise:

# Portu kullanan süreci bul
sudo lsof -i :18789

# Veya farklı bir port kullan
clawdbot gateway --port 18889

Bot Yanıt Vermiyor

Bot yanıt vermiyorsa:

  1. Gateway Durumunu Kontrol Et: clawdbot gateway status
  2. Kanal Yapılandırmasını Doğrula: Tokenların doğru ve kanalların etkin olduğundan emin olun
  3. Kimlik Doğrulamayı Kontrol Et: API anahtarlarının geçerli olduğundan emin olun
  4. Logları İncele: clawdbot logs --follow ile hata mesajlarını kontrol edin

Clawdbot Güncelleme

En son sürüme güncellemek için:

# Kurulum scriptini tekrar çalıştır
curl -fsSL https://clawd.bot/install.sh | bash

# Veya npm ile güncelle
npm update -g clawdbot@latest

# Gateway'i yeniden başlat
clawdbot gateway restart

# Sağlık durumunu kontrol et
clawdbot health

Sonuç

VPS üzerine Clawdbot kurulumu, çoklu mesajlaşma platformlarında erişilebilen güçlü, kendi kendine barındırılan bir AI asistanı elde etmenin kolay bir yoludur. LightNode'un uygun fiyatları, global kapsama alanı ve yüksek performanslı altyapısı sayesinde kişisel AI asistanınızı güvenle dağıtabilirsiniz.

Bu rehberi takip ederek, yaklaşık 20-30 dakika içinde VPS'inizde Clawdbot'u çalışır hale getirebilir, gizliliğinize saygı duyan ve verileriniz üzerinde tam kontrol sağlayan her zaman erişilebilir bir AI dostuna sahip olabilirsiniz.

Daha fazla özelleştirme ve gelişmiş özellikler için resmi dokümantasyona Clawdbot GitHub sayfasından ulaşabilir ve topluluk tartışmalarını inceleyerek ek bilgiler ve ipuçları edinebilirsiniz.

Ek Kaynaklar

Ucuz VPS Hosting ile Büyük Tasarruf