LemonClaw: Kendi AI Asistanınızı Herhangi Bir Server Üzerinde Çalıştırın

Bulut tabanlı yapay zeka asistanları, sorun çıkarana kadar oldukça kullanışlıdır. Yoğun saatlerdeki rate limit sınırlamaları. Ağınızın dışına çıkan veriler. Biriken aylık abonelik ücretleri. Sağlayıcının izin verdiğinin ötesinde davranışı özelleştirme imkanının olmaması.

LemonClaw, kendi donanımınızda çalışan, self-hosted bir yapay zeka asistanıdır. Telegram, Discord veya herhangi bir sohbet platformuna bağlanır, birleşik bir API aracılığıyla herhangi bir yapay zeka modelini kullanır ve tüm konuşma verilerini makinenizde tutar.

Eğer self-host yapıp yapmama konusunda kararsızsanız, bu yazıyı Mac Studio yerel yapay zeka rehberi ve Çinli geliştirici rehberi ile birlikte okuyun. İlki donanım sorusunu yanıtlar. İkincisi ise ödeme ve sağlayıcı sorusunu yanıtlar.

LemonClaw Ne Yapar?

Temelde LemonClaw, sohbet platformları ile yapay zeka modelleri arasında bir geçit (gateway) görevi görür. Telegram üzerinden bir mesaj gönderirsiniz, LemonClaw bunu seçtiğiniz yapay zeka modeline yönlendirir ve yanıtı geri gönderir.

Ancak basit bir aktarıcıdan çok daha fazlasını sunar:

• Çoklu model desteği: Konuşma sırasında GPT-4.1, Claude, DeepSeek ve yerel modeller arasında geçiş yapın
• Kalıcı bellek: Yapılandırılabilir context window ile konuşmalar yeniden başlatmalarda bile korunur
• MCP sunucu desteği: Model Context Protocol aracılığıyla harici araçlara (veritabanları, API'ler, dosya sistemleri) bağlanın
• Eklenti sistemi: Özel komutlar, zamanlanmış görevler ve entegrasyonlar ekleyin
• Çoklu kullanıcı: Her kullanıcı kendi konuşma geçmişine ve model tercihlerine sahip olur
• Görsel anlama: Fotoğraf gönderin ve yapay zeka analizi alın (vision yeteneğine sahip modelleri kullanarak)
• Sesli mesajlar: Sesli girişler için speech-to-text işleme

Mimari

Telegram/Discord ←→ LemonClaw Gateway ←→ AI API (LemonData/OpenAI/Local)
                         │
                    ┌────┴────┐
                    │  Eklentiler │
                    │  MCP     │
                    │  Bellek  │
                    └─────────┘

LemonClaw tek bir Node.js süreci olarak çalışır. Temel kullanım için veritabanı gerekmez (konuşmalar JSON dosyaları olarak saklanır). Prodüksiyon kurulumları için Kubernetes üzerinde kalıcı birimleri (persistent volumes) destekler.

Hızlı Başlangıç (5 Dakika)

Seçenek 1: Tek Satırlık Self-Hosted Kurulum (Önerilen)

curl -fsSL https://raw.githubusercontent.com/hedging8563/lemonclaw/main/deploy/self-hosted/install.sh | bash

Mevcut yükleyici, varsa uv tool install komutunu tercih eder, aksi takdirde izole bir venv kurulumuna döner ve sonunda lemonclaw init komutunu çalıştırır.

Seçenek 2: Manuel Kurulum

uv tool install --upgrade lemonclaw
lemonclaw init

Seçenek 3: LemonData Hosted

Altyapıyı yönetmek istemiyorsanız, LemonData barındırılan LemonClaw örnekleri sunar. Her örnek, kalıcı depolamaya sahip izole bir Kubernetes pod'u içinde çalışır.

lemondata.cc adresinden kaydolun, panelinizdeki Claw bölümüne gidin ve bir örnek başlatın. Web terminal erişimi ile birlikte size özel bir alt alan adına (claw-isminiz.lemondata.cc) sahip olursunuz.

Mevcut Self-Hosted Akışı

Mevcut yerel akış şöyledir:

lemonclaw init
lemonclaw gateway
lemonclaw status

Runtime verileri şurada bulunur:

• ~/.lemonclaw/config.json
• ~/.lemonclaw/workspace/
• ~/.lemonclaw/workspace/sessions/
• ~/.lemonclaw/lemonclaw.log

Bu operasyonel olarak önemlidir. Ekipler self-hosted bir asistanın "sadece bir bot" olduğunu söylediklerinde, genellikle oturum durumunun, logların ve kimlik bilgilerinin gerçekte nerede tutulduğunu düşünmemişlerdir.

Yapılandırma

Yapılandırma dosyası (~/.lemonclaw/config.json) her şeyi kontrol eder:

{
  "api": {
    "key": "sk-lemon-xxx",
    "baseUrl": "https://api.lemondata.cc/v1"
  },
  "telegram": {
    "token": "BOTFATHER_DAN_ALINAN_BOT_TOKEN"
  },
  "discord": {
    "token": "DISCORD_BOT_TOKEN"
  },
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-6",
      "compaction": { "mode": "default" }
    }
  }
}

Şu an bilinmesi gereken yaygın komutlar:

• lemonclaw init
• lemonclaw gateway
• lemonclaw status
• lemonclaw doctor
• lemonclaw channels login
• lemonclaw channels status

Model Seçimi

Konuşma başına model değiştirin veya varsayılanları ayarlayın:

/model claude-sonnet-4-6    # Claude'a geçiş yap
/model gpt-4.1-mini         # GPT-4.1 Mini'ye geçiş yap (daha ucuz)
/model deepseek-chat         # DeepSeek'e geçiş yap (ekonomik)

MCP Sunucuları

MCP (Model Context Protocol) aracılığıyla harici araçları bağlayın:

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-filesystem", "/izin/verilen/dizin/yolu"]
      },
      "postgres": {
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-postgres", "postgresql://..."]
      }
    }
  }
}

MCP sunucuları yapılandırıldığında, yapay zeka asistanınız dosyaları okuyabilir, veritabanlarını sorgulayabilir ve doğrudan sohbet arayüzünden harici servislerle etkileşime girebilir.

Hosted vs Self-Hosted: Hangisi Uygun?

Şu durumlarda self-hosted kullanın:

• Veri yerelliği önemliyse
• Runtime ve depolama üzerinde doğrudan kontrol istiyorsanız
• Özel MCP sunucularına veya yerel araçlara ihtiyacınız varsa
• Küçük bir servisi yönetme konusunda rahatsanız

Şu durumlarda hosted kullanın:

• Bir runtime yönetmeden Claw deneyimini istiyorsanız
• Ekibiniz hıza kontrolden daha fazla önem veriyorsa
• İzole örneklere ihtiyacınız varsa ancak düşük seviyeli runtime sahipliğine ihtiyacınız yoksa

Birçok ekip için en iyi ilk adım hosted Claw kullanmaktır; iş akışı merkezi bir hale gelirse daha sonra self-hosted modeline geçilebilir.

Kullanım Durumları

Kişisel Bilgi Asistanı

LemonClaw'ı MCP dosya sistemi sunucusu aracılığıyla notlar dizininize bağlayın. Kendi belgeleriniz hakkında sorular sorun, özetler alın, notlar arasındaki bağlantıları bulun.

Ekip DevOps Botu

Ekibinizin Slack veya Discord kanalına konuşlandırın. Kubernetes kümenize, izleme panellerinize ve CI/CD hatlarınıza bağlayın. Ekip üyeleri doğal dil aracılığıyla dağıtım durumunu kontrol edebilir, logları görüntüleyebilir ve geri yüklemeleri (rollback) tetikleyebilir.

Müşteri Destek Otomasyonu

Ürün veritabanınıza ve bilgi tabanınıza bağlayın. LemonClaw birinci basamak destek sorularını yanıtlar ve güven düzeyi düşük olduğunda konuyu insanlara aktarır.

Kod İnceleme Asistanı

Git deponuza bağlayın. Sohbet uygulamanızdan ayrılmadan inceleme için diff'leri gönderin, güvenlik analizi, stil önerileri ve hata tespiti alın.

Maliyet Karşılaştırması

Kurulum	Aylık Maliyet	Modeller	Veri Gizliliği
ChatGPT Plus	Kullanıcı başı $20	GPT-4o, sınırlı	Veriler OpenAI sunucularında
Claude Pro	Kullanıcı başı $20	Sadece Claude	Veriler Anthropic sunucularında
LemonClaw (self-hosted)	Sadece API kullanımı	Herhangi bir model	Veriler sizin sunucunuzda
LemonClaw (LemonData hosted)	Örnek başı $20 + API	Herhangi bir model	İzole K8s pod'u

5 kişilik bir ekip için ChatGPT Plus, sınırlı model erişimiyle aylık 100 dolar tutar. Paylaşılan API kredileriyle LemonClaw, her modele erişim ve tam veri kontrolü ile toplamda aylık 30-50 dolar civarında maliyet çıkarabilir.

Donanım Gereksinimleri

• Minimum: Node.js 18+ ve 512MB RAM'e sahip herhangi bir makine
• Önerilen: 1 CPU çekirdeği, 1GB RAM, 10GB depolama
• Yerel modeller için (Ollama): Model başına GPU/Apple Silicon gereksinimlerini ekleyin

LemonClaw'ın kendisi hafiftir. Yapay zeka çıkarımı (inference), API sağlayıcısının sunucularında (veya yerel Ollama örneğinizde) gerçekleşir.

Bu ayrım önemlidir. LemonClaw'ı self-host etmek için bir GPU'ya ihtiyacınız yoktur. Sadece modelleri de self-host etmek istiyorsanız bir GPU'ya ihtiyacınız olur.

---

LemonClaw'ı deneyin: Herhangi bir yapay zeka API'si ile self-host yapın veya LemonData üzerinden barındırılan bir örnek başlatın. Seçim yapmadan önce maliyet tarafını karşılaştırmak isterseniz, bir sonraki okunacak sayfa fiyatlandırma karşılaştırmasıdır.