Bir düşün: WhatsApp'tan mesaj atıyorsun, AI asistanın dosyalarını düzenliyor, toplantı notlarını özetliyor, hatta GitHub'da PR'ları gözden geçiriyor. Bunu yapan açık kaynak bir proje var ve adı OpenClaw. Hikayesi Peter Steinberger'in kişisel bir deneyi olarak başladı, birkaç kez isim değiştirdi ve çok kısa sürede GitHub tarihinin en hızlı yıldız toplayan projelerinden biri haline geldi. Bu yazıda OpenClaw'un gerçek hikayesini, çok kanallı mimarisini, self-host kurulumunu ve skill/plugin sistemini — tamamını resmi kaynaklara dayanarak — inceleyeceğiz.
💡 Pro Tip: OpenClaw'u kendi sunucunda çalıştırabilirsin; konuşma geçmişi ve ayarlar yerel diskte tutuluyor, harici bir veritabanı şart değil. Self-host, verilerin üçüncü parti sunuculara gitmemesi açısından önemli bir avantaj — ama "varsayılanlar güvenli" demek değil, aşağıdaki güvenlik bölümüne mutlaka bak.
İçindekiler
- Clawdbot'tan OpenClaw'a Evrim
- Çok Kanallı Mimari
- Gerçek Dünya Görevleri ve Zamanlanmış İşler
- Self-Host Kurulumu
- AI Model Sağlayıcıları
- Skill ve Plugin Sistemi
- Güvenlik ve Gizlilik
- Sonuç ve Öneriler
Clawdbot'tan OpenClaw'a Evrim
OpenClaw'un hikayesi, sık tekrarlanan "2024'te başladı" anlatısının aksine, 2025'in sonlarına ait. Peter Steinberger — iOS dünyasında PSPDFKit'in (sonradan Nutrient olarak yeniden markalanan şirket) kurucusu olarak tanınan veteran geliştirici — kişisel kullanımı için bir mesajlaşma tabanlı AI asistanı yazmaya başladı. Proje birkaç hafta içinde dört farklı isim değiştirdi:
Tarih | İsim | Not |
|---|---|---|
24 Kasım 2025 | Warelay | İlk commit, GitHub'da yayınlandığı ilk isim |
3 Aralık 2025 | CLAWDIS | Kısa ömürlü ikinci isim |
2 Ocak 2026 | Clawdbot | "Lobster" maskotuyla birlikte popülerleşen isim |
27 Ocak 2026 | Moltbot | Anthropic'in "Clawd" / "Claude" benzerliğine itirazı sonrası geçici isim |
30 Ocak 2026 | OpenClaw | Steinberger'in "Moltbot pek tutmadı" dediği, marka taraması temiz çıkan güncel isim |
Yani bu yazının yayınlandığı Şubat 2026 ortası itibarıyla proje, OpenClaw adını aldıktan sonra henüz birkaç hafta geçmiş durumda — ama GitHub'da zaten on binlerce yıldıza ulaşmış ve Star History gibi takip siteleri onu "bu kadar hızlı büyüyen ilk yazılım deposu" olarak işaretlemiş durumda. Proje MIT lisanslı ve kaynak kodu github.com/openclaw/openclaw adresinde.
Neden Bu Kadar Popüler?
- Gerçek ihtiyaçtan doğdu — Steinberger kendi günlük işlerini otomatize etmek için yazdı
- Self-host — Konuşma geçmişi ve ayarlar kendi makinende/sunucunda kalıyor; oturumlar yerel JSONL dosyalarında, hafıza/vektör indeksi SQLite tabanlı yerel bir veritabanında (
sqlite-vec) tutuluyor - Çok kanallı — Tek bir Gateway süreci, zaten kullandığın mesajlaşma uygulamalarına bağlanıyor
- Açık kaynak — MIT lisansı, fork ve özelleştirme özgürlüğü
- Gerçek dünya görevleri — Sadece sohbet değil, dosya okuyan, komut çalıştıran, zamanlanmış işler yürüten bir ajan
Çok Kanallı Mimari
OpenClaw'un merkezinde tek bir Gateway süreci var: bu süreç oturumların, mesaj yönlendirmenin ve kanal bağlantılarının tek kaynağı. Gateway; CLI, web kontrol arayüzü, macOS/iOS/Android istemcileri ve mesajlaşma kanalları arasında köprü kuruyor.
Desteklenen Kanallardan Öne Çıkanlar (Şubat 2026)
Bu, Gateway'in o tarihteki tüm kanallarının eksiksiz listesi değil; en sık kullanılan beşi:
Kanal | Bağlantı yöntemi | Not |
|---|---|---|
WhatsApp | Baileys (WhatsApp Web protokolü) | Resmi WhatsApp Business API değil; QR kod ile hesabını "linked device" olarak eşleştiriyorsun |
Telegram | grammY + Telegram Bot API | BotFather'dan token alman yeterli |
Slack | Slack Bolt SDK | Workspace app olarak kurulum |
Discord | Carbon framework (discord-api-types üzerine) | Sunucuya bot daveti ile |
Signal | signal-cli (harici binary) | Skill/kanal, sistemde kurulu signal-cli'yi çağırıyor |
Bunların dışında o dönemde bir WebChat kanalı da vardı — Gateway'in kendi web arayüzü, ayrı bir mesajlaşma hesabı gerektirmiyor — ve isteğe bağlı bir iMessage entegrasyonu, o zamanki sürümde BlueBubbles plugin'i üzerinden (ayrı bir BlueBubbles sunucusu/uygulaması isteyen bir eklenti kanalı olarak) kullanılabiliyordu.
⚠️ Önemli not: OpenClaw'un WhatsApp entegrasyonu, Meta'nın resmi WhatsApp Business API'si değil; Baileys adlı açık kaynak kütüphane üzerinden WhatsApp Web protokolünü kullanıyor. Bu, kurulumu kolaylaştırıyor ama resmi olmayan bir entegrasyon olduğu için hesap kullanım şartlarını kendi sorumluluğunda değerlendirmen gerekiyor.
Mimari Yapı
1// OpenClaw mimarisi (basitleştirilmiş):2//3// WhatsApp -┐4// Telegram --┤5// Slack -----┤--→ Gateway (tek süreç, loopback'e bağlanır)6// Discord ---┤ │7// Signal ----┘ ▼8// Agent (tool use, oturum, hafıza)9// │10// ▼11// Skill / Tool çağrıları12// (SKILL.md + plugin'ler)13// │14// ▼15// Kanala özel yanıt💡 Pro Tip: WhatsApp için QR ile eşleştirme gerektiğinden, headless bir sunucuda kurulumda canlı QR kodunu telefonuna aktarmanın güvenilir bir yolunu planlaman gerekiyor (terminale basılan QR, ekran görüntüsü üzerinden iletilirken süresi dolabiliyor). Kişisel kullanım için Telegram ile başlamak çok daha az sürtünmeli.
Gerçek Dünya Görevleri ve Zamanlanmış İşler
OpenClaw sadece bir sohbet botu değil; ajan, elindeki tool'ları (dosya okuma/yazma, kabuk komutu çalıştırma, HTTP istekleri, skill'ler aracılığıyla üçüncü parti servisler) kullanarak gerçek işler yapabiliyor.
Örnek Senaryolar
1. Dosya özetleme:
1// WhatsApp'tan: "Masaüstümdeki rapor.xlsx dosyasını özetle"2//3// Agent:4// 1. Dosya tool'uyla belgeyi okur5// 2. İçeriği LLM ile analiz eder6// 3. Özeti aynı kanaldan geri gönderir2. GitHub PR özetleme (bir skill ile):
1// "main branch'teki açık PR'ları özetle"2//3// Agent, GitHub erişimi veren bir skill/tool üzerinden:4// → open PR listesini çeker5// → diff'leri analiz eder6// → özeti Slack'e gönderirZamanlanmış (Cron) Görevler
OpenClaw'un dahili bir zamanlayıcısı var ve bunu doğal dil + cron ifadesiyle kullanıyorsun:
1# Her iş günü sabah 09:00'da standup özeti gönder2openclaw cron create "0 9 * * 1-5" "Açık GitHub PR'larımı ve atanmış görevlerimi özetle, #team kanalına gönder" --name daily-standup(Not: pozisyonel cron create "<cron-ifadesi>" "<prompt>" söz dizimi 2026.2.12'de yoktu; 15 Ekim 2026 itibarıyla güncel CLI'yi yansıtıyor — bkz. Güncelleme.)
Bu ayrı bir workflow motoru değil; cron ifadesi + doğal dil prompt'u ikilisiyle çalışan, ajanın kendi tool'larını kullanarak yürüttüğü basit bir zamanlayıcı mekanizması.
CI/CD Pipeline süreçlerine OpenClaw'u entegre ederek PR review ve deployment bildirimlerini otomatize edebilirsin — ama bunu yaparken PR'a erişen skill/tool'un hangi izinlerle çalıştığını (bkz. Güvenlik bölümü) mutlaka kontrol et.
Self-Host Kurulumu
OpenClaw'u kendi makinende veya bir VPS'te çalıştırmak için önerilen iki yol var: kurulum betiği ya da global npm paketi. Harici bir PostgreSQL ya da Redis gerekmiyor — OpenClaw, oturum verilerini yerel JSONL dosyalarında, hafıza/vektör indeksini ise yerel bir SQLite veritabanında (sqlite-vec ile) tutuyor.
Kurulum
1# macOS / Linux / WSL22curl -fsSL https://openclaw.ai/install.sh | bash3 4# ya da doğrudan npm ile5npm install -g openclaw@latest6 7# kurulumdan sonra8openclaw onboard --install-daemon9openclaw gateway statusMinimum Sistem Gereksinimleri (Şubat 2026 sürümü)
Bileşen | Gereksinim |
|---|---|
Node.js | 22.12 veya üzeri (2026.2.12 sürümü); openclaw@latest kurduğunda güncel sürüm (2026.10.3) >=24.16.0 <25 ya da >=26.1.0 gerektiriyor — bkz. Güncelleme |
OS | macOS, Linux veya Windows (WSL2) |
Depolama | Yerel JSONL oturum dosyaları + SQLite tabanlı hafıza/vektör indeksi — ayrı bir veritabanı sunucusu gerekmiyor |
Ağ | Gateway varsayılan olarak yalnızca localhost'a bağlanır |
💡 Pro Tip: Sunucuda çalıştırmak istersen OpenClaw'un kendi deposundaki resmi kurulum betiği (scripts/docker/setup.sh) Docker Compose ile Gateway'i ayağa kaldırıyor; varsayılan olarak image'i yerelde build ediyor,OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latestortam değişkeniyle resmi GHCR imajını da kullanabilirsin — bu, topluluk yapımı değil, projenin kendi yayınladığı resmi image. Ama Gateway'i dışa açık bir porta bağlarken mutlaka bir auth token ayarlaman gerekiyor — container imajları varsayılan olarak Gateway'i dışa açık bırakıyor, loopback'e kısıtlı olan masaüstü kurulumunun aksine.
AI Model Sağlayıcıları
OpenClaw, tek bir LLM'e bağımlı değil; Anthropic, OpenAI, Google (Gemini), xAI (Grok), Mistral, Groq, DeepSeek ve Amazon Bedrock gibi birçok hosted sağlayıcıyı, bunun yanında Ollama / llama.cpp gibi yerel çalıştırma seçeneklerini destekliyor. Hangi modelin varsayılan olarak kullanılacağı ajan bazında ayarlanıyor:
1{2 agents: {3 defaults: {4 model: { primary: "anthropic/<model-id>" },5 },6 },7}(Yukarıdaki model adı örnek amaçlıdır — resmi dokümantasyon zaman içinde değişen bir model listesi sunuyor; güncel sağlayıcı/model adlarını kurulu sürümün openclaw models list çıktısından veya docs.openclaw.ai üzerinden doğrulaman gerekiyor.)
İstek içeriğine göre otomatik model seçen yerleşik bir yönlendirme özelliği resmi dokümantasyonda yer almıyor; bunun yerine ajan başına sabit bir varsayılan model ve (ClawRouter / LiteLLM / OpenRouter gibi) harici gateway'ler üzerinden sağlayıcı yönlendirmesi mevcut.
Firebase Advanced ile OpenClaw'u bağlayarak Firestore'daki verileri mesajlaşma kanallarından sorgulaman, özel bir skill yazmanı gerektiriyor — aşağıdaki bölüme bak.
Skill ve Plugin Sistemi
OpenClaw'u genişletmenin birincil yolu skill'ler. Bir skill, ajana belirli bir işi nasıl yapacağını öğreten, SKILL.md adlı tek bir Markdown dosyasıyla tanımlanan bir klasör. Dosyanın başında YAML frontmatter, altında da doğal dilde talimatlar var:
1---2name: hava-durumu3description: Türkiye şehirleri için hava durumu sorgulama4metadata:5 openclaw:6 requires:7 env: ["WEATHER_API_KEY"]8---9 10Kullanıcı bir şehrin hava durumunu sorduğunda:11 121. `web_fetch` tool'uyla `https://api.openweathermap.org/data/2.5/weather`13 adresine `q=<şehir>,TR` parametresiyle istek at; `appid` değerini `WEATHER_API_KEY`14 ortam değişkeninden okuyan bir `exec` adımıyla ekle.152. Sıcaklık, nem ve hava durumu açıklamasını Türkçe olarak özetle.Bunu <workspace>/skills/hava-durumu/SKILL.md yoluna koymak, skill'i otomatik olarak yüklüyor. Skill'leri yönetmek için:
1# Bir Git deposundan skill kur2openclaw skills install git:owner/repo@main3 4# Yerel bir dizinden skill kur5openclaw skills install ./skills/hava-durumu --as hava-durumu6 7# Workspace'teki tüm skill'leri güncelle8openclaw skills update --all(Not: skills install/skills update --all komutları 2026.2.12'de yoktu; 15 Ekim 2026 itibarıyla güncel CLI'yi yansıtıyor — bkz. Güncelleme.)
Daha düşük seviyeli, kod yazarak yeni bir tool tanımlamak istersen (API çağrısı yapan özel bir fonksiyon gibi), ayrı bir SDK paketi kurmana gerek yok: plugin kodu doğrudan openclaw paketinin kendi alt modüllerinden import ediliyor (openclaw/plugin-sdk/...), peerDependency olarak openclaw'u kullanıyor ve şema tanımı için typebox kütüphanesini kullanıyor. Pratikte çoğu kullanım için SKILL.md yeterli; kod seviyesinde plugin geliştirmek daha gelişmiş bir senaryo ve güncel API'yi mutlaka docs.openclaw.ai/plugins üzerinden kontrol etmen gerekiyor. (Not: openclaw/plugin-sdk/... alt yolu 2026.2.12'de yoktu; 15 Ekim 2026 itibarıyla güncel CLI'yi yansıtıyor.)
Güvenlik ve Gizlilik
OpenClaw'un resmi güvenlik dokümantasyonu şu temel noktaları vurguluyor:
- Tek güven sınırı varsayımı: Bir Gateway, tek bir operatör ya da birbirine güvenen bir ekip için tasarlanmış — birbirine güvenmeyen kullanıcılar arasında paylaşılan bir çoklu kiracı sınırı değil.
- Varsayılan olarak localhost: Normal bir host kurulumunda Gateway yalnızca
localhost'a bağlanıyor; container imajlarında bu varsayılan farklı olduğundan dışa açık kurulumlarda auth token şart. - Pairing / allowlist: Bilinmeyen gönderenlerden gelen DM'ler doğrudan işlenmiyor; bir eşleştirme kodu ile onaylanması gerekiyor (
openclaw pairing approve <kanal> <kod>). Grup erişimi genelde allowlist + mention gerektiriyor. - Tool izin profilleri: Ajanlar "tam erişim (sandbox yok)", "salt-okunur" veya "dosya sistemi/kabuk erişimi yok" gibi farklı izin profilleriyle çalıştırılabiliyor.
- Denetim araçları:
openclaw security auditveopenclaw policykomutları, mevcut güvenlik ayarlarını ve tool politikasını incelemek için kullanılıyor. (Not:openclaw policykomutu 2026.2.12'de yoktu; 15 Ekim 2026 itibarıyla güncel CLI'yi yansıtıyor.)
Resmi dokümantasyon, araçları izole çalıştırmak için Docker tabanlı bir sandbox'ı adlandırıyor (güncel sürümde Podman/SSH/OpenShell gibi ek backend seçenekleri de var); buna karşılık belirli bir şifreleme standardı vermiyor, yalnızca tam disk şifrelemesi öneriyor — esas güvence, varsayılan izinlerin kısıtlı tutulması ve üçüncü parti skill/plugin'lerin güvenilmeyen kod olarak ele alınması gerektiği uyarısı.
iOS Security yazısındaki prensipler burada da geçerli: özellikle API anahtarlarını ortam değişkeni olarak tutmak ve üçüncü parti skill'leri çalıştırmadan önce okumak önemli.
Sonuç ve Öneriler
OpenClaw, birkaç ay önce bir geliştiricinin kişisel ihtiyacından doğan, hızla büyüyen bir açık kaynak AI asistan projesi. Self-host edilebilir, çok kanallı ve gerçek dünya görevlerini yürütebilen bir Gateway + Agent mimarisine sahip. Clawdbot'tan OpenClaw'a (aslında Warelay'den başlayan) evrimi, bir kişisel projenin ne kadar hızlı büyüyebileceğinin iyi bir örneği.
Önerilerim:
- Self-host ile başla — Verilerin kontrolü sende kalsın
- Telegram ile dene — En az sürtünmeli kurulum, BotFather ile dakikalar içinde hazır
- Skill ekosistemini keşfet —
SKILL.mdile kendi otomasyonlarını yaz - Zamanlanmış işleri kullan —
openclaw cron createile tekrarlayan görevleri otomatize et - Güvenlik dokümantasyonunu oku — Varsayılan izinleri değiştirmeden önce ne yaptığını anla
Daha fazla bilgi için OpenClaw resmi sitesi, docs.openclaw.ai ve GitHub deposu sayfalarını inceleyebilirsin.
Flutter vs React Native kararında olduğu gibi, AI asistan seçiminde de ihtiyaçlarını iyi analiz etmek kritik. OpenClaw gizlilik ve özelleştirme öncelikliyse makul bir seçim — ama hâlâ hızla gelişen, genç bir proje olduğunu unutma.
Güncelleme (Ekim 2026)
Bu yazı Şubat 2026'nın ortasında yayınlandı; o tarihten bu yana önemli gelişmeler oldu:
- 14 Şubat 2026: Peter Steinberger, OpenAI'ye katıldığını ve OpenClaw'un kâr amacı gütmeyen "OpenClaw Foundation" tarafından yönetileceğini duyurdu.
- 19 Şubat 2026: Depo, 88 günde 200.000 GitHub star'a ulaşarak (Star History'ye göre) bu noktaya en hızlı ulaşan yazılım deposu oldu.
- 2 Mart 2026: GitHub'da 247.000 star ve 47.700 fork'a ulaştı (Wikipedia'daki anlık görüntü).
- Mart 2026: Çin'in Sanayi ve Bilişim Teknolojileri Bakanlığı'na (MIIT) bağlı birimler ve CNCERT/CC, OpenClaw'un varsayılan/hatalı yapılandırmalarda ciddi güvenlik riski taşıdığına dair uyarılar yayınladı; prompt injection başlıca endişe konusuydu.
- 2026 içinde açıklanan CVE'ler arasında çalışma dizini yolunun sistem prompt'una temizlenmeden eklenmesi (CVE-2026-27001, 2026.2.15 sürümünde giderildi) ve Slack kanal metaverilerinin prompt'a sızması (CVE-2026-24764) yer alıyor. CVE-2026-24764'ün yaması (sürüm 2026.2.3) bu yazının yayın tarihinden önce, 5 Şubat 2026'da zaten çıkmıştı; her iki CVE kaydı da MITRE'de 19 Şubat 2026'da, yani yayın tarihinden sonra açıklandı.
- 30 Ağustos 2026: OpenClaw 2.0 (v2026.8.1) yayınlandı; The Register, bu sürümde Secret Store değerlerinin diskte şifrelenmediğini ve sandbox'ın varsayılan olarak kapalı geldiğini bildirdi — yukarıdaki güvenlik bölümündeki temkinli dilin neden gerekli olduğunu doğrulayan bir gelişme.
- Kanal desteği genişledi: Güncel resmi dokümantasyon, Matrix/Nostr/Twitch/Zalo'yu birlikte "plugin channels" (eklenti kanalları) olarak listeliyor; Microsoft Teams, Google Chat ve Feishu da ayrıca anılıyor ama temel/eklenti ayrımı o kaynakta net değil. iMessage tarafında da değişiklik oldu: Şubat 2026'daki BlueBubbles plugin'i (bkz. yukarıdaki CVE-2026-27001/CVE-2026-24764 ile aynı dönemde bulunan, auth bypass içeren CVE-2026-26316) tamamen kaldırıldı; yerine macOS'ta çalışan
imsgCLI tabanlı native bir entegrasyon geldi. Skill/plugin kataloğu için resmi bir pazaryeri (ClawHub) de devreye girdi.
Yukarıdaki bölümlerdeki bazı CLI örnekleri de yayın tarihinden sonraki sürümleri yansıtıyor: skill kurulum/güncelleme komutları (openclaw skills install, skills update --all), openclaw policy, pozisyonel cron create "<cron-ifadesi>" "<prompt>" söz dizimi ve openclaw/plugin-sdk/... alt yolları, yayın tarihindeki npm sürümünde (2026.2.12) ya yoktu ya da farklı bir söz dizimiyle çalışıyordu; bu makaledeki hâlleriyle 15 Ekim 2026 itibarıyla güncel CLI'yi yansıtıyorlar.
Etiketler
iOS Geliştirme Haberleri
Haftalık Swift tips, SwiftUI tricks ve iOS best practices. Spam yok, sadece değerli içerik.
Onay e-postasındaki bağlantıyı açıp “Aboneliğimi onayla” düğmesine bastığında aboneliğin başlar. Bültende açılma/tıklama istatistikleri tutulur; dilediğin an tek tıkla ayrılabilirsin. Gizlilik
