Günlük iş akışınız zaten WhatsApp, Slack, Telegram ve Discord pencereleri arasında akarken, her otomasyon veya araştırma görevi için ayrı bir tarayıcı sekmesine dönüp bağlamı baştan anlatmak mühendislik zamanını sessizce eritir. Daha da zorlayıcı olan tarafı, bulut tabanlı sohbet uygulamalarının kişisel notlarınızı, yerel komut geçmişinizi ve hassas erişim anahtarlarınızı üçüncü taraf sunucularda tutmasıdır. İşte bu sürtünme, açık kaynak topluluğunda hızla büyüyen yerel öncelikli ajan mimarilerinin önünü açtı.
OpenClaw, kendi donanımınızda çalışan ve yapay zekâ asistanınızı WhatsApp, Telegram, Slack, Discord ve iMessage gibi mesajlaşma uygulamalarına tek bir yerel geçit üzerinden bağlayan MIT lisanslı açık kaynaklı bir platformdur. Kimlik bilgileriniz, kalıcı hafızanız ve yapılandırma dosyalarınız yerel makinenizde kalırken, kullandığınız dil modellerini istediğiniz an değiştirebilirsiniz. Kurumsal mimari tasarımında bu yaklaşımı değerlendiren ekipler için Kling Digital Kurumsal Yapay Zekâ Çözümleri kapsamında ele aldığımız yerel veri egemenliği ilkeleriyle doğrudan örtüşür.
Önemli
- Tek Kapı, Çoklu Kanal: WhatsApp, Telegram, Slack, Discord, iMessage, Signal, Matrix ve Microsoft Teams mesajları ortak bir Gateway sürecinde normalize edilerek tek bir kalıcı hafızaya bağlanır.
- Yerel Veri Egemenliği ve Model Bağımsızlığı: Anahtarlar, oturum kayıtları ve
MEMORY.mddosyaları kendi cihazınızda durur; Anthropic, OpenAI, Gemini veya yerel Ollama modelleri arasında kesintisiz geçiş yapılır. - Deterministik Lobster Kalkanı: Yüksek riskli dosya ve terminal işlemleri kontrolsüz LLM döngülerine bırakılmaz; tip güvenli
.lobsteriş akışları ve insan onayı kapılarıyla sınırlandırılır.
OpenClaw Nedir ve Topluluk Neden "Istakoz Beslemek" Diyor?
Projenin geçmişi, açık kaynak yazılım ekosistemindeki evrim hızını somut biçimde gösterir. İlk olarak 2025 sonlarında Clawdbot adıyla ortaya çıkan proje, kısa bir Moltbot döneminin ardından bağımsız ve kâr amacı gütmeyen OpenClaw Foundation (501(c)(3)) çatısı altında OpenClaw adıyla kalıcı kimliğine kavuştu. Kasım 2026 itibarıyla GitHub üzerindeki openclaw/openclaw deposunun yaklaşık 395 bin yıldıza ulaşması, geliştiricilerin yalnızca bir sohbet arayüzü değil, yerel donanıma hükmeden kalıcı bir ajan çalışma zamanı aradığını kanıtlıyor. Bu yönelim, Kasım 2026 açık kaynak yapay zekâ ajan ekosistemi analizimizde incelediğimiz altyapı odaklı dönüşümün en görünür örneklerinden biridir.
Topluluk içinde sıkça duyulan "ıstakoz beslemek" (İngilizce topluluklarda feeding the lobster veya raising a lobster) ifadesi, projenin Clawd / Molty adlı uzay ıstakozu maskotundan ve sürekli ayakta kalan yerel çalışma biçiminden gelir. Kabuğunu değiştirerek büyüyen bir ıstakoz metaforunu benimseyen geliştiriciler; kendi bilgisayarında, ev sunucusunda veya özel sanal sunucusunda bir OpenClaw Gateway örneği çalıştırmayı, ona düzenli olarak bağlam dosyaları (MEMORY.md, SOUL.md, USER.md), özel yetenekler (Skills) ve model erişimi sağlamayı mizahi bir dille "ıstakoz beslemek" şeklinde adlandırır. OpenClaw Kontrol Arayüzünde bağlantı durumuna tepki veren küçük animasyonlu ıstakoz öğesi de bu kültürü teknik izleme pratiğinin parçası hâline getirir.
Hub-and-Spoke Mimari: Gateway, Kanallar ve Yerel Hafıza
OpenClaw, modüler bir TypeScript monorepo olarak tasarlanmıştır ve Güvenilen Geçit / Güvenilmeyen Yürütme (Trusted Gateway / Untrusted Execution) prensibini temel alan merkez-kol (hub-and-spoke) bir mimari uygular. Bulut tabanlı bir aracı servis olmadan, doğrudan kendi makinenizdeki arka plan servisi (daemon) üzerinden çalışır.
1. Gateway: Merkezi Arka Plan Motoru
Mimari kalbi oluşturan Gateway, yerel cihazınızda varsayılan olarak 127.0.0.1:18789 (loopback) adresinde dinleyen kalıcı bir arka plan sürecidir. Oturum yaşam döngülerini, zamanlanmış görevleri (cron), yetki sınırlarını, bellek okuma-yazma akışlarını ve model yönlendirmelerini tek noktadan yürütür. İsteğe bağlı sürüm kontrolü dışında dışarıya otomatik veri göndermez; istemler yalnızca sizin açıkça yapılandırdığınız model sağlayıcılarına ve mesajlaşma köprülerine iletilir.
2. Channels (src/channels): Birleşik Mesajlaşma Katmanı
Her sohbet platformunun kimlik doğrulama ve olay iletim mekanizması farklıdır:
- Telegram:
@BotFatherüzerinden alınan bot belirteciyle en hızlı kurulan ve zengin komut desteği sunan kanaldır. - WhatsApp: Metin, medya ve grup sohbetlerini yöneten yerel köprü adaptörleriyle çalışır; grup içinde yalnızca etiketlendiğinde yanıt verme (
requireMention: true) kuralıyla gürültüyü önler. - Slack: Kurumsal çalışma alanlarında Socket Mode ve Event Subscriptions üzerinden uygulama etiketlerini, kanal iletilerini ve doğrudan mesajları yakalar.
- Discord: Uygulama bot belirteciyle sunucu kanalları ve özel mesajlar arasında köprü kurar.
- iMessage: Apple ekosisteminde yerel macOS entegrasyonları veya BlueBubbles benzeri köprülerle çalışır.
Kanallar katmanı tüm bu dağınık protokolleri standart bir iç mesaj şemasına dönüştürür. Sabah ofiste Slack üzerinden başlattığınız bir teknik araştırmayı, akşam yolda WhatsApp veya Telegram üzerinden aynı bağlamla sürdürebilirsiniz; çünkü arka planda aynı yerel ajan çekirdeği ve aynı MEMORY.md dosyası hizmet verir. Oturumlar arası derin kodlama belleği arayan ekipler bu yapıyı claude-mem kalıcı hafıza katmanı rehberimizdeki yaklaşımla kıyaslayarak değerlendirebilir.
3. Model Bağımsızlığı ve Yedekleme Zinciri
Bulut asistanlarının en büyük darboğazı, hafızanızın ve alışkanlıklarınızın tek bir model üreticisinin ekosistemine kilitlenmesidir. OpenClaw, ~/.openclaw/openclaw.json dosyasında birincil modeli ve yedek (fallback) listesini ayırır. Karmaşık mimari incelemelerde Anthropic Claude veya OpenAI modellerini kullanırken, yüksek hacimli günlük özetlerde daha düşük maliyetli bir modele ya da tamamen çevrimdışı çalışan yerel bir Ollama örneğine tek bir yapılandırma satırıyla geçebilirsiniz. Değişen yalnızca çıkarım motorudur; çalışma alanı, beceriler ve sohbet geçmişi bozulmadan kalır.
OpenClaw ve Alternatif Yaklaşımların Mimari Karşılaştırması
Yerel bir mesajlaşma geçidi seçerken OpenClaw'ın geleneksel bulut sohbet uygulamaları ve özerk öğrenen ajan çerçeveleri karşısındaki konumunu netleştirmek gerekir. Kendi kendine yetenek üreten ajan mimarileriyle farkını görmek için Nous Research Hermes Agent incelememize de göz atabilirsiniz.
| Değerlendirme Kriteri | OpenClaw (Yerel Gateway) | Standart Bulut Sohbet Uygulamaları | Özel API Scriptleri / Webhook Botları |
|---|---|---|---|
| Veri ve Şifre Konumu | Tamamen yerel donanım (~/.openclaw/) | Sağlayıcı bulut sunucuları | Geliştiricinin barındırdığı sunucu |
| Çoklu Mesajlaşma Desteği | WhatsApp, Telegram, Slack, Discord, iMessage tek çekirdekte | Yalnızca kendi web/mobil uygulaması | Her kanal için ayrı entegrasyon kodu |
| Model Değiştirme Esnekliği | Sınırsız; birincil + yedek zinciri + yerel Ollama | Tek tedarikçi kilidi | Manuel SDK uyarlaması gerekir |
| Kalıcı Hafıza Yapısı | Okunabilir yerel Markdown (MEMORY.md, SOUL.md) | Kapalı ve taşınamaz bulut belleği | Sıfırdan veritabanı tasarımı gerekir |
| İş Akışı Determinizmi | Lobster (.lobster) boru hatları ve onay kapıları | Serbest LLM yanıt döngüsü | Kod düzeyinde sabit akış |
| Lisans ve Yönetim | MIT Lisansı (OpenClaw Foundation) | Tescilli abonelik | Kuruma özel bakım yükü |
Kurulum, CLI Komutları ve openclaw.json Yapılandırması
OpenClaw, Node.js tabanlı (v24/v26 önerilen) komut satırı arayüzü üzerinden kurulur ve yönetilir. Kurulum betiği gerekli çalışma zamanını denetler, sağlayıcı anahtarlarını yapılandırır ve arka plan daemon servisini işletim sistemine kaydeder.
# macOS / Linux / WSL2 hızlı kurulum
curl -fsSL https://openclaw.ai/install.sh | bash
# Alternatif olarak doğrudan npx ile kurulum ve daemon yapılandırması
npx openclaw@latest
openclaw onboard --install-daemon
# Çalışan geçit durumunu, model ayarını ve güvenlik denetimini doğrulama
openclaw gateway status
openclaw config set agents.defaults.model.primary "anthropic/claude-sonnet-4-6"
openclaw doctor --fix
openclaw security audit --deep
Windows ortamında PowerShell üzerinden iwr -useb https://openclaw.ai/install.ps1 | iex komutuyla kurulum başlatılabilir. Kurulum sonrasında tüm çekirdek ayarlar JSON5 biçimindeki ~/.openclaw/openclaw.json dosyasında iki ana bölme mantığıyla tutulur: kök düzeyinde gateway, channels ve özel models tanımları; agents.defaults altında ise çalışma alanı ve model yönlendirme kuralları bulunur.
{
gateway: {
// Güvenlik için yalnızca yerel loopback arayüzüne bağla
bind: "loopback",
port: 18789,
},
channels: {
whatsapp: {
allowFrom: ["+905550000000"],
groups: {
"*": { requireMention: true },
},
},
telegram: {
botToken: "TELEGRAM_BOT_TOKEN_BURAYA",
allowFrom: ["yetkili_kullanici_id"],
},
},
agents: {
defaults: {
workspace: "~/.openclaw/workspace",
model: {
primary: "anthropic/claude-sonnet-4-6",
fallbacks: [
"openai/gpt-4o",
"ollama/qwen2.5-coder",
],
},
},
},
}
İpucu
openclaw.json dosyasını elle düzenlemek yerine openclaw configure --section channels veya openclaw config get agents.defaults.model.primary komutlarını kullanmak, JSON5 sözdizimi hatalarını önler ve şema doğrulamasını anında çalıştırır.
Lobster İş Akışı Kabuğu ve Yetenek (Skills) Ekosistemi
OpenClaw yalnızca sohbet yanıtlayan bir bot değildir; dosya sistemine erişebilir, terminal komutları çalıştırabilir, takvim ve e-posta akışlarını okuyabilir veya GitHub depolarını inceleyebilir. Ancak karmaşık çok adımlı bir operasyonu tamamen dil modelinin o anki kararına bırakmak hem yüksek token maliyeti doğurur hem de beklenmedik yan etkilere yol açabilir.
Bu riski çözmek için ekosistemde Lobster (openclaw/lobster / @openclaw/lobster) adı verilen yerel öncelikli deterministik iş akışı kabuğu kullanılır. Lobster, .lobster uzantılı tiplenmiş boru hatları üzerinden katı JSON veri akışı sağlar. Kritik bir yan etki (örneğin bir üretim sunucusunda betik çalıştırmak veya harici müşteriye mesaj göndermek) gerektiğinde approve yapı taşı akışı tamamen durdurur ve bir devam belirteci (resume token) ile insan onayı bekler.
Ekosistemde ek araçlar (Skills) ClawHub gibi topluluk dizinlerinden eklenebilir ya da kuruma özel TypeScript modülleri olarak yazılabilir. Özellikle kendi iç API'lerinize veya kapalı kurumsal sistemlerinize bağlanan özel yetenekler geliştirirken, Kling Digital Özel Yazılım Geliştirme ekibimizin uyguladığı katı girdi doğrulama ve en az yetki prensiplerini temel almak uzun vadeli bakım maliyetini belirgin biçimde düşürür. Sistemlerin dış yüzeyini kod yazmadan önce haritalandırmak isteyen ekipler için REA (Reverse Engineer Anything) MCP mimari rehberimiz de tamamlayıcı bir başlangıç noktası sunar.
Güvenlik ve Gizlilik Mimarisi: Üretim Ortamında Dikkat Edilmesi Gerekenler
Yerel makinenizde terminal çalıştırma ve mesajlaşma kanallarından komut alma yetkisine sahip bir yazılım, yanlış yapılandırıldığında ciddi bir saldırı yüzeyi oluşturur. OpenClaw topluluğunda en çok tartışılan üç risk başlığı şunlardır:
- Dolaylı İstem Enjeksiyonu (Indirect Prompt Injection): Ajanın okuduğu harici bir web sayfası, e-posta veya grup sohbeti mesajı içine gizlenmiş kötü niyetli talimatlar, yerel komut yürütmeyi tetiklemeye çalışabilir.
- Üçüncü Taraf Yetenek (Skill) Güvenliği: Doğrulanmamış topluluk eklentileri, çalışma dizinindeki hassas ortam değişkenlerine veya yerel dosyalara erişim talep edebilir.
- Ağa Açık Geçit (Gateway) Yapılandırması:
gateway.bindayarını kimlik doğrulama katmanı ve şifreli tünel olmadan0.0.0.0değerine çekmek, yerel geçidi ağdaki yetkisiz istemcilere açar.
Uyarı
OpenClaw Gateway servisini asla kimlik doğrulamasız biçimde genel internete (0.0.0.0) açmayın. Varsayılan bind: "loopback" ayarını koruyun, her kanalda allowFrom beyaz listelerini tanımlayın, grup sohbetlerinde requireMention: true kuralını zorunlu tutun ve kritik yan etkileri Lobster approve kapılarının arkasına alın.
Kurumsal ortamlarda OpenClaw'ı güvenli biçimde konumlandırmak için şu sertleştirme adımlarını standartlaştırmak gerekir:
- İzole Çalışma Alanı: Ajanı yalnızca ayrılmış bir konteyner veya kısıtlı bir kullanıcı hesabı altında çalıştırın; ana geliştirici makinesindeki SSH anahtarlarına doğrudan okuma izni vermeyin.
- Düzenli Güvenlik Denetimi: Her yapılandırma veya eklenti değişikliğinden sonra
openclaw security audit --deepçıktısını inceleyin. - Eklenti Kod İncelemesi: Topluluktan alınan her yeni yeteneğin kaynak kodunu ve ağ çağrılarını kurulum öncesinde denetleyin.
- İzlenebilir Uzaktan Yönetim: Kodlama ajanlarını telefon veya farklı bir bilgisayardan izole biçimde yönlendirmek gerektiğinde, mesajlaşma geçidinin sınırlarını zorlamak yerine T3 Code uzaktan yönetim rehberimizde ele aldığımız özel kontrol yüzeyi mimarisini tercih edin.
Kurumsal Kullanım Senaryoları ve Kling Digital Değerlendirmesi
OpenClaw, özellikle veri gizliliği politikaları nedeniyle müşteri verilerini üçüncü taraf yapay zekâ SaaS platformlarına yükleyemeyen yazılım ekipleri, teknik operasyon merkezleri ve yönetici asistanlığı akışları için somut bir alternatif oluşturur. Slack üzerinden sistem sağlık raporlarını yerel log dosyalarından özetleyen, Telegram'dan gelen onay mesajıyla belirli bir dağıtım kontrol listesini Lobster üzerinden yürüten veya yerel Ollama modelleriyle tamamen çevrimdışı belge taraması yapan kurulumlar pratikte yüksek verim sağlar.
Kurumunuzun mevcut mesajlaşma kanallarına, güvenlik sınırlarına ve veri egemenliği gereksinimlerine uygun bir yerel yapay zekâ geçidi tasarlamak veya mevcut ajan altyapınızı sertleştirmek için Kling Digital iletişim sayfasından mimari ekibimizle doğrudan görüşebilirsiniz.




