OpenClaw Nedir? Kurulum ve Güvenlik Rehberi

OpenClaw, sohbet uygulamalarını yapay zekâ ajanlarına bağlayan, açık kaynak ve kendi donanımında çalışan bir araç. WhatsApp'tan, Telegram'dan ya da Discord'dan yazdığın bir mesajı alıyor, seçtiğin yapay zekâ modeliyle işliyor ve verdiğin araçlarla gerçek işler yapıyor. Projenin kendi tanımı kısa: "Yapay zekâ asistanın, kendi donanımında, zaten kullandığın her sohbet uygulamasında." Bu yazıda OpenClaw'ın ne olduğunu, nasıl kurulduğunu ve özellikle bir sunucuya kurmadan önce bilmen gereken güvenlik konularını anlatıyorum.

OpenClaw, 2026'nın en hızlı büyüyen açık kaynak projelerinden biri. GitHub'da 394 binden fazla yıldızı var (8 Kasım 2026). Türkiye'de de ilgi artıyor: Google Trends'te "n8n" ile birlikte aranan sorgular arasında "openclaw" son üç ayda Büyük Çıkış etiketiyle öne çıktı.

OpenClaw nedir, ne işe yarar?

OpenClaw'ın merkezinde Gateway (geçit) adlı tek bir süreç var. Bu süreci kendi bilgisayarında ya da bir sunucuda çalıştırıyorsun. Gateway, oturumların, mesaj yönlendirmenin ve sohbet kanalı bağlantılarının tek merkezi. Bir mesaj geldiğinde onu ilgili ajana iletiyor, ajan da araçlarını kullanarak işi yapıp yanıtı aynı kanaldan geri gönderiyor.

Önemli bir ayrıntı: OpenClaw'ın kendi yapay zekâ modeli yok. Seçtiğin bir model sağlayıcısının API anahtarıyla çalışıyor; yani asıl "zekâ" bağladığın modelden geliyor, OpenClaw ise onu araçlara ve sohbet uygulamalarına bağlayan katman. Proje ilk günlerinde Clawdbot ve Moltbot adlarıyla da anıldı.

Temel kavramlar

• Ajanlar: Araç kullanımını, oturumları ve hafızayı yöneten yapay zekâ çalışanları. Her ajanın, çalışma alanının ya da mesajı gönderen kişinin oturumu ayrı tutulabiliyor.
• Kanallar: Sohbet uygulaması bağlantıları. Resmî belgelerde WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat, Matrix ve WebChat gibi kanallar listeleniyor.
• Skill'ler: Ajanın gerektiğinde yüklediği, SKILL.md dosyasıyla tanımlanan yeniden kullanılabilir prosedürler.
• Node'lar: Kamera, ekran ve ses işleri için eşleştirilen iOS ve Android cihazlar.
• Otomasyon: Zamanlanmış görevler (cron), hook'lar ve webhook'lar.
• Eklentiler: Yeni kanal, model sağlayıcısı ve araç eklemek için geliştirme kiti.

Neler yapılabilir?

OpenClaw'ın gücü, sohbet uygulamasından komut verilebilen ve araç kullanabilen bir ajan olmasından geliyor. Telegram'dan sunucunun durumunu sormak, belirli saatlerde rapor hazırlatmak, bir klasördeki dosyaları düzenletmek ya da kod üzerinde çalıştırmak bunlardan birkaçı. Ama bu güç, ajana verdiğin yetki kadar büyük; o yüzden aşağıdaki güvenlik bölümünü kurulumdan önce okumanı öneririm.

OpenClaw nasıl kurulur?

Kurulum için Node.js 24.16 ve üstü ya da 26 gerekiyor. Resmî belgeler güvenlik açısından 24.22.1 ve üstünü ya da 26.12.1 ve üstünü özellikle öneriyor. Önerilen yol, Node'u da gerekirse kuran yükleyici betik.

Kurulum betiği

macOS, Linux ve WSL2'de:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell'de:

iwr -useb https://openclaw.ai/install.ps1 | iex

Windows masaüstünde resmî belgeler ayrıca yerel Windows Hub uygulamasını öneriyor; Gateway'i WSL2 üzerinde çalıştırmak da destekleniyor.

npm ile kurulum

Node.js zaten kuruluysa npm ile de kurabilirsin. npm 12 ya da 11.16 ve üstünde, kurulum betiklerine izin vermek için ek parametre gerekiyor:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 ve öncesinde --allow-scripts=openclaw kısmını yazmana gerek yok. İkinci satırdaki onboard komutu kurulum sihirbazını başlatıyor; --install-daemon parametresi de Gateway'i arka planda sürekli çalışan bir hizmet olarak kuruyor.

Docker ile kurulum

Bir sunucuda kapsayıcı (container) ile çalıştırmak istersen depodaki kurulum betiği Docker Compose ortamını hazırlıyor. Depoyu klonladıktan sonra kök klasörde şu komutu çalıştırıyorsun:

./scripts/docker/setup.sh

Sonrasında kanal eklemek ve durumu kontrol etmek için Compose komutları kullanılıyor:

docker compose run --rm openclaw-cli channels add --channel telegram --token "BOT_TOKENIN"
docker compose run --rm openclaw-cli doctor --json
docker compose up -d openclaw-gateway

Yönetim paneli 18789 numaralı portta çalışıyor. Panelde oturum açmak için .env dosyasındaki jetonu (token) kullanıyorsun.

VPS'e kurarken dikkat edilecekler

OpenClaw'ı bir VPS'te çalıştırmak cazip; bilgisayarın kapalıyken de ajanın çalışmaya devam ediyor. Ama sunucu internete açık olduğu için hata payı da büyüyor.

• Paneli internete açma. Normal kurulumda Gateway yalnızca yerel adrese (loopback) bağlanıyor ve bu doğru varsayılan. Resmî belgelere göre Docker imajları ise varsayılan olarak dışa açık bağlanıyor; bunu kimlik doğrulaması ve güvenlik duvarı ayarı olmadan kullanma. Docker'ın kendi güvenlik duvarı zinciri (DOCKER-USER) için belgelerdeki sertleştirme rehberine bak.
• Panele tünelle bağlan. Uzaktaki paneli açmak için portu dışarı açmak yerine SSH tüneli kullanabilirsin. Genel bir örnek: ssh -L 18789:127.0.0.1:18789 kullanici@sunucu komutundan sonra paneli kendi bilgisayarında http://127.0.0.1:18789 adresinden açarsın.
• Ayrı bir kullanıcı kullan. OpenClaw'ı root olarak değil, yalnızca gerekli klasörlere erişimi olan ayrı bir işletim sistemi kullanıcısıyla çalıştır.
• Paylaşımlı hosting uygun değil. Node.js 24 ve üstü ile sürekli çalışan bir süreç gerektiği için paylaşımlı hosting paketleri genellikle bu iş için uygun değil; VPS ya da Docker kurulabilen bir sunucu seç.

OpenClaw güvenliği: kurmadan önce bilmen gerekenler

OpenClaw'ı güçlü yapan şey, aynı zamanda en büyük riski. Ajan, ona verdiğin araçlar ölçüsünde dosyalarına, komut satırına ve bağladığın hesaplara erişebiliyor. Üstelik sohbet kanalından gelen her mesaj, bir web sayfasının içeriği ya da bir e-posta, modele talimat gibi görünen metinler taşıyabiliyor.

CVE-2026-25253: tek tıkla jeton sızdırma

Şubat 2026'da yayımlanan bu açık, 2026.1.29'dan eski OpenClaw sürümlerini etkiliyor. NVD kaydına göre uygulama, bir adresin sorgu bölümündeki gatewayUrl değerini alıp kullanıcıya sormadan o adrese WebSocket bağlantısı açıyor ve jeton bilgisini gönderiyordu. Saldırganın hazırladığı bir bağlantıya tıklamak yeterli olabiliyordu. Açığın CVSS 3.1 puanı 8.8 (yüksek). Çözüm basit: 2026.1.29 ya da daha yeni bir sürüme, tercihen en son sürüme güncelle ve jetonlarını yenile.

ClawHub'daki zararlı skill'ler

ClawHub, OpenClaw için skill ve eklentilerin paylaşıldığı açık kayıt. Herkes yükleme yapabildiği için 2026'nın başında ciddi bir tedarik zinciri sorunu yaşandı. Palo Alto Networks'ün güvenlik ekibi Unit 42, 23 Haziran 2026 tarihli raporunda şunları aktarıyor:

• Koi Security'nin ClawHavoc adlı incelemesi 341 zararlı skill tespit etti.
• Bitdefender, platformun ilk haftalarında incelediği skill'lerin yaklaşık yüzde 17'sinde zararlı içerik buldu.
• Trend Micro, bazı skill'lerin macOS için bilgi çalan Atomic Stealer (AMOS) dağıttığını doğruladı.
• Bunun üzerine ClawHub, yayımlanan skill'leri VirusTotal ve ClawScan ile taramaya başladı.
• Buna rağmen Unit 42, Şubat ile Mayıs arasında engellenmemiş beş zararlı skill daha buldu. Bunlardan biri, tarayıcıların boyut sınırını aşmak için README dosyasını yaklaşık 22 MB dolgu karakteriyle şişirmişti.

Yani tarama var ama kusursuz değil. Bir skill'i kurmadan önce yayımlayan hesaba ve dosyaların içeriğine bakmak hâlâ senin sorumluluğunda. Unit 42 ayrıca kurulumdan sonra sunucunun dışarıya yaptığı bağlantıları izlemeyi öneriyor; belgelenmemiş bir adrese giden trafik, zararlı bir skill'in en belirgin işaretlerinden biri.

İstem enjeksiyonu (prompt injection)

Ajanın okuduğu güvenilmeyen içerik, örneğin bir web sayfası ya da gelen bir mesaj, modeli yönlendirmeye çalışan gizli talimatlar içerebilir. OpenClaw güvenilmeyen girdiyi ayrıca işaretleyerek modele veriyor; resmî belgeler bu korumayı atlatan ayarları canlı ortamda kapalı tutmanı ve modelini dikkatle seçmeni öneriyor.

Tek Gateway, tek güven sınırı

Resmî güvenlik belgesinin altını çizdiği bir nokta var: OpenClaw, birbirine güvenmeyen kişilerin aynı ajanı ya da aynı Gateway'i paylaştığı bir kurgu için tasarlanmamış. Bir Gateway tek bir kişiye ya da birbirine güvenen bir ekibe ait olmalı. Farklı güven düzeyindeki kullanıcılar için ayrı Gateway'ler, ayrı kimlik bilgileri ve tercihen ayrı sunucular kullan.

Güvenli OpenClaw kurulumu için kontrol listesi

1. Güncel kal. En son sürümü kullan; 2026.1.29'dan eski bir sürüm kesinlikle çalıştırma.
2. Node.js'i güncelle. 24.22.1 ve üstü ya da 26.12.1 ve üstü kullan.
3. Gateway'i yerelde tut. Paneli internete açma; uzaktan erişim için SSH tüneli ya da kimlik doğrulamalı bir yöntem kullan.
4. Kimin yazabileceğini sınırla. Sohbet kanallarında eşleştirme kodunu (DM pairing) ya da izin listelerini açık tut; grup sohbetlerinde ajanı yalnızca anıldığında yanıt verecek şekilde ayarla.
5. Skill'leri körü körüne kurma. Yayımlayana ve dosya içeriğine bak; tarama sonucunu tek güvence sayma.
6. Araç yetkilerini daralt. Her ajana yalnızca gereken araçları ver; komut çalıştırmayı mümkünse yalıtılmış ortamda (sandbox) tut.
7. API harcamasına sınır koy. Model sağlayıcının panelinden harcama limiti belirle; ele geçirilmiş bir ajan faturanı da şişirebilir.
8. Düzenli denetle. Varsayılan ayarlardan sapmaları bulmak için aşağıdaki komutu çalıştır:

openclaw security audit

Bir saldırıdan şüphelenirsen resmî belgelerin önerdiği sıra şöyle: önce yalıt, sonra bütün kimlik bilgilerini ve jetonları yenile, ardından kayıtları inceleyip kanıtları sakla. Sunucu tarafındaki genel güvenlik alışkanlıkları için PHP güvenlik açığı rehberimize de göz atabilirsin.

OpenClaw, n8n ve Claude Code: farkları ne?

Bu üç araç sık sık birlikte anılıyor ama farklı işler için tasarlandılar:

Adımları her seferinde aynı olan işler için n8n daha öngörülebilir; kod yazma ve düzenleme işleri için Claude Code daha uygun. OpenClaw ise ikisinin arasında, serbest biçimli istekleri sohbetten alıp araçlarla yerine getiren bir asistan.

Sık sorulan sorular

OpenClaw ücretsiz mi?

Yazılımın kendisi MIT lisanslı ve ücretsiz. Ancak ajanın kullandığı yapay zekâ modeli için seçtiğin sağlayıcının API ücretini ödüyorsun; ayrıca sunucu kullanıyorsan onun maliyeti de var.

Windows'ta çalışıyor mu?

Evet. Windows için PowerShell yükleyicisi ve masaüstü için Windows Hub uygulaması var; Gateway'i WSL2 üzerinde de çalıştırabiliyorsun.

Clawdbot ve Moltbot ile aynı şey mi?

Evet. NVD kaydında da OpenClaw'ın diğer adları olarak Clawdbot ve Moltbot geçiyor. Eski adlarla yazılmış rehberlerdeki komutlar artık geçerli olmayabilir; resmî belgeleri esas al.

Telefondan kullanabilir miyim?

Evet. Ajanla WhatsApp ya da Telegram gibi bir sohbet kanalı üzerinden konuşuyorsun. Ayrıca iOS ve Android cihazlar kamera, ekran ve ses işleri için Gateway'e eşleştirilebiliyor.

OpenClaw'ı paylaşımlı hostinge kurabilir miyim?

Genellikle hayır. Node.js 24 ve üstü ile sürekli çalışan bir süreç gerekiyor; bu da çoğu paylaşımlı hosting paketinde yok. Bir VPS ya da Docker kurulabilen bir sunucu daha uygun.

Sonuç

OpenClaw, yapay zekâ ajanını kendi donanımında ve kendi kurallarınla çalıştırmanın en popüler yollarından biri. Kurulumu birkaç komut; asıl iş, onu güvenli tutmak. Güncel sürümü kullan, paneli internete açma, skill'leri kaynağına bakarak kur ve ajanına yalnızca gerçekten gereken yetkileri ver. Node.js tabanlı projeler arıyorsan Node.js uygulamalarımıza göz atabilir, sunucu kurulumu ya da güvenlik için destek istersen bize yazabilirsin.

Bu yazı 8 Kasım 2026 itibarıyla resmî belgelere ve aktarılan kaynaklara göre hazırlandı. OpenClaw hızlı değişen bir proje; kurulum adımları ve güvenlik ayarları için güncel belgeleri kontrol et.

Kaynaklar

• OpenClaw resmî belgeleri
• OpenClaw kurulum rehberi
• OpenClaw Docker kurulumu
• OpenClaw Gateway güvenliği
• ClawHub: skill ve eklenti kaydı
• NVD: CVE-2026-25253
• OpenClaw güvenlik bildirimi (GitHub)
• Unit 42: OpenClaw ve ClawHub tedarik zinciri riski
• OpenClaw GitHub deposu