Tüm Yazılar
KategoriAI
Okuma Süresi
10 dk
Yayın Tarihi
2026-02-13
Kelime Sayısı
2.294kelime

Kahveni hazırla - bu içerikli bir makale!

OpenClaw (Clawdbot): Açık Kaynak, Çok Kanallı AI Asistanı

Özet

Peter Steinberger'in Warelay/CLAWDIS/Clawdbot/Moltbot isimleriyle geçen projesi OpenClaw'a dönüştü: WhatsApp, Telegram, Slack, Discord ve Signal üzerinden çalışan, yerel JSONL + SQLite tabanlı self-host bir AI asistanı. Gerçek mimari, kurulum ve skill sistemi.

  • OpenClaw, Peter Steinberger'in Kasım 2025'te Warelay adıyla başlattığı projenin Clawdbot ve Moltbot isimlerinden geçerek 30 Ocak 2026'da aldığı güncel isim.
  • WhatsApp entegrasyonu resmi Business API değil, Baileys kütüphanesiyle WhatsApp Web protokolünü kullanıyor (QR ile eşleştirme).
  • Self-host için harici PostgreSQL/Redis gerekmiyor; oturumlar yerel JSONL dosyalarında, hafıza/vektör indeksi SQLite'ta tutuluyor, kurulum npm veya resmi install script ile yapılıyor.
  • Genişletme mekanizması SKILL.md tabanlı skill'ler; kod seviyesindeki plugin'ler doğrudan 'openclaw' paketinin plugin-sdk alt modüllerini kullanıyor.
  • Zamanlanmış görevler 'openclaw cron create' komutuyla tanımlanıyor; üçüncü parti skill ve plugin'ler güvenilmeyen kod olarak ele alınmalı.
OpenClaw (Clawdbot): Açık Kaynak, Çok Kanallı AI Asistanı

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

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?

  1. Gerçek ihtiyaçtan doğdu — Steinberger kendi günlük işlerini otomatize etmek için yazdı
  2. 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
  3. Çok kanallı — Tek bir Gateway süreci, zaten kullandığın mesajlaşma uygulamalarına bağlanıyor
  4. Açık kaynak — MIT lisansı, fork ve özelleştirme özgürlüğü
  5. 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ı

text
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:

text
1// WhatsApp'tan: "Masaüstümdeki rapor.xlsx dosyasını özetle"
2//
3// Agent:
4// 1. Dosya tool'uyla belgeyi okur
5// 2. İçeriği LLM ile analiz eder
6// 3. Özeti aynı kanaldan geri gönderir

2. GitHub PR özetleme (bir skill ile):

text
1// "main branch'teki açık PR'ları özetle"
2//
3// Agent, GitHub erişimi veren bir skill/tool üzerinden:
4// → open PR listesini çeker
5// → diff'leri analiz eder
6// → özeti Slack'e gönderir

Zamanlanmış (Cron) Görevler

OpenClaw'un dahili bir zamanlayıcısı var ve bunu doğal dil + cron ifadesiyle kullanıyorsun:

bash
1# Her iş günü sabah 09:00'da standup özeti gönder
2openclaw 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

bash
1# macOS / Linux / WSL2
2curl -fsSL https://openclaw.ai/install.sh | bash
3 
4# ya da doğrudan npm ile
5npm install -g openclaw@latest
6 
7# kurulumdan sonra
8openclaw onboard --install-daemon
9openclaw gateway status

Minimum 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:latest ortam 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:

json5
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:

markdown
1---
2name: hava-durumu
3description: Türkiye şehirleri için hava durumu sorgulama
4metadata:
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:

bash
1# Bir Git deposundan skill kur
2openclaw skills install git:owner/repo@main
3 
4# Yerel bir dizinden skill kur
5openclaw skills install ./skills/hava-durumu --as hava-durumu
6 
7# Workspace'teki tüm skill'leri güncelle
8openclaw 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 audit ve openclaw policy komutları, mevcut güvenlik ayarlarını ve tool politikasını incelemek için kullanılıyor. (Not: openclaw policy komutu 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:

  1. Self-host ile başla — Verilerin kontrolü sende kalsın
  2. Telegram ile dene — En az sürtünmeli kurulum, BotFather ile dakikalar içinde hazır
  3. Skill ekosistemini keşfet — SKILL.md ile kendi otomasyonlarını yaz
  4. Zamanlanmış işleri kullan — openclaw cron create ile tekrarlayan görevleri otomatize et
  5. 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 imsg CLI 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

#OpenClaw#Clawdbot#Open Source#AI Assistant#Self-Host#Multi-Channel#Peter Steinberger
Muhittin Çamdalı

Muhittin Çamdalı

Senior Mobile Engineer

12+ yıllık deneyime sahip Senior Mobile Engineer. iOS, Flutter ve React Native ile mobil ürünler geliştiriyorum; full-stack ve AI-native çalışıyorum.

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

Paylaş

İlgili İçerik