OpenClaw Rehberi: “Gerçekten İş Yapan” Yerel AI Asistanı Nasıl Kurulur?

Yapay zeka dünyasında sadece sohbet eden botlardan, aksiyon alan “ajanlara” (agents) doğru hızlı bir geçiş yaşıyoruz. Bu akımın en popüler ve açık kaynaklı temsilcisi ise OpenClaw. Peki, interneti kasıp kavuran bu araç nedir, nasıl kurulur ve Telegram üzerinden 7/24 çalışan bir asistana nasıl dönüştürülür? İşte adım adım rehberiniz.

OpenClaw Nedir?

OpenClaw (eski adıyla Clawdbot veya Moltbot), Claude, GPT-4 veya yerel LLM modellerini favori mesajlaşma uygulamalarınıza (WhatsApp, Telegram, Discord vb.) bağlayan açık kaynaklı bir yapay zeka çerçevesidir [1].

Klasik bir chatbot’un aksine, OpenClaw bir “Agentic AI” (Ajan Yapay Zeka) örneğidir. Yani sadece sorulan sorulara cevap vermekle kalmaz; dosya okuyup yazabilir, terminal komutları çalıştırabilir, takviminizi yönetebilir ve web tarayıcısı üzerinden işlemler yapabilir [2, 3]. Tamamen kendi bilgisayarınızda (veya bir VPS sunucuda) yerel olarak çalıştığı için verileriniz üzerinde tam kontrol sahibi olursunuz [1].

OpenClaw ile Neler Yapabilirsiniz?

OpenClaw’ın yetenekleri, ona verdiğiniz “Skill” (beceri) izinlerine göre şekillenir:

1. Otonom Görevler: “Gelen kutumu temizle”, “Şu uçuş için check-in yap” veya “Toplantı notlarını özetle” gibi komutları yerine getirebilir [4].
2. Web Otomasyonu (Unbrowse): Herhangi bir web sitesinin dahili API’sini tersine mühendislik yöntemiyle çözerek o site üzerinde işlem yapabilir [5].
3. Yazılım Geliştirme: Kod yazabilir, GitHub issue’larını sınıflandırabilir ve PR (Pull Request) hazırlayabilir [6].
4. Günlük Rutinler: Her sabah size hava durumunu, takviminizi ve önemli maillerinizi özetleyen bir rapor sunabilir [7].

Adım Adım Kurulum Rehberi

OpenClaw’ı kurmak için teknik olarak herhangi bir bilgisayar yeterlidir, ancak 7/24 aktif olması için bir VPS (Sanal Özel Sunucu) kullanılması önerilir [8]. Aşağıdaki adımlar hem yerel bilgisayar hem de VPS için geçerlidir.

Gereksinimler

• Node.js yüklü bir sistem (veya Docker).
• OpenAI veya Anthropic (Claude) API anahtarı [9].
• Bir Telegram hesabı.

1. Adım: OpenClaw’ı Yükleyin

Terminalinizi açın ve OpenClaw’ı global olarak yüklemek için şu komutu girin:

npm install -g openclaw@latest

Kurulum tamamlandıktan sonra kurulum sihirbazını başlatın:

openclaw onboard

Bu sihirbaz sizi temel ayarlar konusunda yönlendirecektir [4].

2. Adım: API Anahtarlarını Ayarlama

OpenClaw’ın “beyni” olarak çalışacak modeli seçmelisiniz. Kurulum sırasında veya ayar dosyasında, OpenAI veya Anthropic’ten aldığınız API anahtarlarını girmeniz gerekecektir.

• OpenAI Platform veya Anthropic Console üzerinden bir API anahtarı (sk-…) oluşturun [10].
• Bu anahtarları kurulum sihirbazına yapıştırın. İpucu: Hem OpenAI hem Anthropic anahtarı ekleyerek modeller arasında geçiş yapabilirsiniz [11].

3. Adım: Telegram ile Bağlantı (En Kritik Aşama)

OpenClaw’ı Telegram üzerinden yönetmek için bir Telegram Botu oluşturmanız gerekir. İşte adım adım yapılışı:

1. BotFather’ı Bulun: Telegram uygulamasında arama kısmına “BotFather” yazın ve onaylı (mavi tikli) botu açın [12].
2. Yeni Bot Oluşturun: /newbot komutunu gönderin.
3. İsimlendirin: Botunuza bir isim (Örn: BenimAsistanim) ve bir kullanıcı adı (sonu bot ile bitmeli, Örn: BenimAsistanim_bot) verin [12].
4. Token’ı Alın: BotFather size uzun bir API Token verecektir. Bu token’ı kopyalayın ve OpenClaw kurulum ekranındaki ilgili alana yapıştırın.
5. Chat ID’nizi Bulun: Güvenlik için botun sadece sizinle konuşmasını sağlamalısınız. Telegram’da “userinfobot” gibi bir bot kullanarak kendi User IDnizi öğrenin ve OpenClaw ayarlarındaki “Allowed Users” (İzin verilen kullanıcılar) kısmına ekleyin [13, 14].

4. Adım: Gateway’i Başlatın

Tüm ayarlar bittikten sonra servisi başlatmak için şu komutu kullanın:

openclaw gateway start

Artık Telegram uygulamasını açıp botunuza “Merhaba” yazabilirsiniz. Asistanınız emrinize amade! [5].

⚠️ Kritik Güvenlik Uyarısı

OpenClaw çok güçlü yetkilere (dosya erişimi, komut çalıştırma) sahip olduğu için güvenlik hayati önem taşır:

• İnternete Açmayın: OpenClaw yönetim panelini (Gateway) asla genel internete (public IP) açmayın. Sadece yerel ağda (localhost) veya bir VPN/WireGuard arkasında kullanın [15, 16].
• Şüpheli Eklentilerden (Skills) Kaçının: “ClawHub” gibi marketlerde yüzlerce zararlı eklenti tespit edilmiştir. Kaynağını bilmediğiniz, özellikle kripto veya şüpheli otomasyon vaat eden eklentileri yüklemeyin. Bu eklentiler şifrelerinizi ve API anahtarlarınızı çalabilir [17, 18].
• Telegram Güvenliği: Telegram hesabınız artık bilgisayarınızın “kök dizinine” erişebilen bir anahtar gibidir. Telegram’da Mutlaka 2FA (İki Aşamalı Doğrulama) kullanın [13].

---

Umarım bu yazı size yardımcı olabilir. Yeni bir blog da görüşmek dileğiyle.