4 Platform
WhatsApp, Telegram, Discord, Slack
%100 Lokal
Tüm sohbet geçmişi ve dosyalar cihazında
0 Masraf
Ollama & Qwen ile bulut API zorunluluğu yok
01 // MİMARİ VE ÇALIŞMA MANTIĞI
Asistan Neden Bulutta Değil, Kendi Bilgisayarında Çalışmalı?
Geleneksel chatbot servislerinde yazdığınız her komut, paylaştığınız şirket içi belgeler ve API şifreleri üçüncü taraf sunucularda işlenir. Açık kaynaklı lokal asistan köprüsü ise makinenizi bir ajan düğümüne dönüştürür.
Telefonunuzdan WhatsApp veya Discord üzerinden attığınız mesaj, bilgisayarınızda arka planda çalışan daemon servisine düşer. Asistan, yerel dosya sisteminize erişebilir, Python scripti çalıştırabilir, kod yazabilir veya web scraping yapabilir. Yanıtı yine mesaj attığınız kanala geri iletir.
02 // SİSTEM GEREKSİNİMLERİ
Kuruluma Başlamadan Önce Hazırlanması Gerekenler
1
Node.js 20+ ve Python 3.11+
Asistanın iletişim köprüsü Node.js üzerinde, dosya analiz ve otomasyon scriptleri Python üzerinde çalışır.
2
Git & Terminal / Komut Satırı
macOS için Terminal/iTerm, Windows için WSL2 veya PowerShell yöneticisi gerekir.
3
Model Seçimi (Lokal veya API)
Tamamen ücretsiz çalıştırmak için Ollama (Qwen 2.5), en yüksek mantık yürütme için Claude 3.5 Sonnet API key.
03 // TEK SEFERLİK KURULUM
Terminal Komutları ile Hızlı Kurulum
Terminalinizi açın ve sırasıyla aşağıdaki komut bloklarını çalıştırın:
git clone https://github.com/openclaw/claw-assistant.git
cd claw-assistant
npm install
cp .env.example .env
# nano veya VS Code ile .env dosyasını açın:
# TELEGRAM_BOT_TOKEN=...
# WHATSAPP_SESSION=true
# LLM_PROVIDER=ollama (veya anthropic)
# OLLAMA_BASE_URL=http://localhost:11434
# ANTHROPIC_API_KEY=sk-ant-...
04 // KANAL YAPILANDIRMASI
WhatsApp & Telegram Köprüsünü Bağlama
WhatsApp Bağlantısı: Servisi npm run dev:whatsapp komutu ile başlattığınızda terminalde tek seferlik bir QR kod üretilir. WhatsApp uygulamasından "Bağlı Cihazlar > Cihaz Bağla" diyerek QR kodu okutun. Oturum anahtarı bilgisayarınızdaki güvenli yerel klasörde saklanır.
Telegram Bağlantısı: Telegram'da @BotFather hesabına gidin, /newbot komutuyla bir asistan botu açın ve verilen HTTP API token'ı .env dosyanıza yapıştırın. Sadece sizin ID'nizden gelen mesajları dinleyecek şekilde whitelist ekleyebilirsiniz.
05 // MODEL ENTEGRASYONU
Claude mu, Kendi Lokal Modeliniz mi?
İki yöntem arasında seçim yapabilirsiniz veya ikisini birden tanımlayıp dinamik yönlendirebilirsiniz:
A
Yerel Model (Ollama + Qwen 2.5 Coder)
Terminalde ollama run qwen2.5-coder:7b çalıştırın. Sıfır ücret, sınırsız token ve tam veri gizliliği sağlar.
B
Claude 3.5 Sonnet API
Karmaşık çok adımlı refactoring ve mimari kararlar için Anthropic API key'inizi girerek en üstün akıl yürütme gücünü elde edin.
06 // PRATİK GÖREVLER
WhatsApp'tan Verilebilecek Örnek Emirler
1. "Masaüstündeki 'raporlar' klasöründeki son 3 PDF dosyasını oku, özetini maddeler halinde bana WhatsApp'tan at."
2. "Projeler/web klasöründeki testleri çalıştır. Eğer patlayan test varsa hata çıktısını inceleyip kodu düzelt."
3. "Şu linkteki ürün fiyatlarını her sabah 09:00'da kontrol et ve bana Telegram'dan güncelleme geç."