OpenClaw Kurulum Rehberi: Kendi AI Ajanını 30 Dakikada Çalıştır

OpenClaw Nedir, Nasıl Kurulur? Sıfırdan Eksiksiz Türkçe Rehber

Yazar: Mindi · Mart 2026 · ~15 dakika okuma

İçindekiler

1. OpenClaw Nedir?
2. ⚠️ Riskler — Önce Bunu Oku
3. Kurulum Öncesi Gereksinimler
4. API Anahtarı Almak (OpenAI – GPT-4o mini)
5. Windows'a Kurulum
6. macOS'a Kurulum
7. İlk Başlatma ve Dashboard
8. WhatsApp / Telegram Bağlamak
9. Temel Kullanım Örnekleri
10. Güvenli Kullanım Önerileri

1. OpenClaw Nedir?

OpenClaw, bilgisayarınıza ya da bir sunucuya kurduğunuz, tamamen size özel çalışan bir yapay zeka asistanı platformudur. ChatGPT'nin web arayüzünden en büyük farkı şu: OpenClaw 7/24 arka planda çalışır, WhatsApp'ınızdan, Telegram'ınızdan veya tarayıcınızdan ona mesaj atarsınız, o da sizin bilgisayarınızda görev yapar.

Kasım 2025'te Clawdbot adıyla çıktı, kısa süre içinde Moltbot adını aldı (Anthropic'in itirazı üzerine), sonunda OpenClaw oldu. Ocak 2026'da GitHub'da viral oldu; birkaç ayda 200.000'in üzerinde yıldıza ulaşarak platformun en hızlı büyüyen açık kaynak projelerinden biri haline geldi.

Ne yapabilir?

• WhatsApp / Telegram / Discord üzerinden aldığı komutları bilgisayarınızda uygular
• E-posta okur, takvim yönetir, web'de arama yapar
• Dosya oluşturur, düzenler, kodlar çalıştırır
• Kendi kendine yeni yetenekler (skill) yazıp öğrenebilir
• Hatırlatıcı kurar, arka planda görevler çalıştırır
• Çok sayıda yapay zeka modeliyle çalışabilir (OpenAI, Anthropic, Gemini vb.)

ℹ️ Açık Kaynak: OpenClaw tamamen açık kaynaklıdır. Bedavaya indirebilirsiniz ama kullandığınız yapay zeka modelinin APIiyazılımların birbirine bağlandığı arayüz ücretini ödemeniz gerekir.

2. ⚠️ Riskler — Önce Bunu Okuyun

🔴 Önemli Uyarı: OpenClaw şu an dünyada en çok güvenlik açığı tartışılan yapay zeka araçlarından biridir. Kaspersky, Cisco ve The Register gibi büyük isimler bu konuda uyarı yayımladı. Kullanmadan önce riskleri anlamanız şart.

Bilinen riskler:

• 🔑 API Anahtarı Sızıntısı — Yanlış yapılandırılmış kurulumlar API anahtarlarınızı ve sistem şifrelerinizi ifşa edebilir. Kötü niyetli skilllar bu bilgileri dışarıya gönderebilir.
• 💉 Prompt Injection Saldırısı — Zararlı bir e-posta ya da web sayfasındaki gizli talimatlar, OpenClaw'u istemediğiniz şeyler yapmaya yönlendirebilir.
• 🛒 Tehlikeli Skill Marketi — ClawHub pazaryerindeki skillların %7'sinin zararlı kod içerdiği tespit edilmiştir. Rastgele skill indirmeyin.
• 🌐 Açık Yönetim Paneli — Yanlış yapılandırılmış proxy arkasında çalışırsa yönetim paneliniz internete açılabilir. Varsayılan port 18789 internete açık olmamalıdır.
• 💸 Yüksek Token Maliyeti — Yapay zeka modeli kontrolsüz tokenimodelin metni işleme birimi; ~4 karakter ≈ 1 token tüketebilir. Kullanım limitlerini baştan ayarlayın.
• 🖥️ Bilgisayar Erişimi — OpenClaw dosya okuyup yazabilir, komut çalıştırabilir. Bu gücü yanlış kişiye veya zararlı talimata vermek büyük sorun yaratır.

Ne yapmalısınız?

• İş bilgisayarınıza kesinlikle kurmayın. Ayrı bir makine veya VPS kullanın.
• Güçlü bir model kullanın (prompt injection'a daha dirençlidir)
• Sadece güvendiğiniz kaynaklardan skill indirin
• Yönetim panelini (port 18789) internete açık bırakmayın
• API anahtarı için harcama limiti belirleyin
• Başlangıçta sınırlı araçlarla başlayın, yavaş yavaş genişletin

⚠️ Başlangıç Tavsiyesi: Teknik bilginiz sınırlıysa, OpenClaw'u önce internet erişimi olmayan bir test ortamında, hiçbir kişisel dosyanız olmayan ayrı bir bilgisayarda deneyin.

3. Kurulum Öncesi Gereksinimler

4. API Anahtarı Almak — OpenAI gpt-5.4-nano (Önerilen)

OpenClaw çalışmak için bir yapay zeka modeline ihtiyaç duyar. Uzun süre önerilen GPT-4o mini artık OpenAI'nin resmi fiyat sayfasında listelenmiyor — yerine güncel en uygun fiyatlı seçenek gpt-5.4-nano. 1 milyon token girişi için ~0.20$, çıkışı için ~1.25$. Normal kullanımda aylık 5-10 dolar gibi makul bir bütçeyle idare etmek mümkündür.

Adımlar:

1. OpenAI hesabı oluşturun: platform.openai.com adresine gidin ve ücretsiz kayıt olun.
2. Bakiye yükleyin: Sol menüden Billing > Add payment method seçeneğine gidin. En az 5$ yükleyin. Spending Limit koymanızı şiddetle tavsiye ederim — örneğin aylık 20$ sınır.
3. API anahtarı oluşturun: Sol menüden API Keys'e tıklayın, ardından Create new secret key deyin. Çıkan anahtarı (sk-... ile başlar) bir yere not edin — bir daha göremezsiniz!

🔴 API Anahtarı Güvenliği: API anahtarınızı kimseyle paylaşmayın, ekran görüntüsüne koymayın, mesajlaşma uygulamalarında iletmeyin. Bu anahtar kredi kartı bilgileriniz kadar kritiktir.

5. Windows'a Kurulum (Adım Adım)

Windows'ta OpenClaw, WSL2 (Windows Subsystem for Linux 2) adlı Linux katmanı üzerinde çalışır.

5.1 WSL2 Kurulumu

ℹ️ Bu Ne Demek? WSL2ⁱWindows içinde Linux çalıştıran uyumluluk katmanı, Windows bilgisayarınızın içinde küçük bir Linux ortamı çalıştırmanızı sağlar. Ayrı bir program kurmaya gerek yok, Windows'un kendi özelliği.

1. Başlat menüsüne sağ tıklayın → "Windows PowerShell (Yönetici)" veya "Terminal (Yönetici)" seçin.
2. Açılan pencereye şunu yapıştırın ve Enter'a basın:

wsl --install

Bu komut WSL2 ve Ubuntu'yu otomatik kurar. Kurulum bittikten sonra bilgisayarı yeniden başlatın.

1. Yeniden başladıktan sonra Ubuntu penceresi açılacak. Kullanıcı adı ve şifre isteyecek — bunlar sadece Ubuntu içi kullanım içindir.

2. systemd'yi aç (gateway servisi için gerekli): WSL terminaline şunu yapıştır, sonra PowerShell'de wsl --shutdown çalıştırıp Ubuntu'yu yeniden aç. Güncel OpenClaw, gateway servisini kurmak için WSL içinde systemd istiyor:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

5.2 OpenClaw Kurulumu (WSL2 üzerinde)

1. Kurulum scriptini çalıştırın:

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

Bu komut Node.js dahil her şeyi otomatik kurar. İnternet hızınıza göre 2-5 dakika sürebilir.

1. Kurulum bitince onboarding sihirbazı otomatik başlayacak. Başlamazsa:

openclaw onboard --install-daemon

1. Sihirbaz adım adım yönlendirecek:

   • Hangi AI sağlayıcısını kullanacaksınız? → OpenAI seçin
   • API anahtarınızı girin (sk-... ile başlayan)
   • Hangi modeli kullanmak istiyorsunuz? → gpt-5.4-nano yazın (eski GPT-4o mini artık listelenmiyor)

2. Gateway durumunu kontrol edin:

openclaw gateway status

running yazıyorsa her şey yolundadır.

5.3 Alternatif: Doğrudan PowerShell ile Kurulum

WSL2 kurmak istemiyorsanız (bazı özellikler kısıtlı kalabilir):

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

⚠️ Resmi Tavsiye: OpenClaw'un resmi belgesi Windows'ta WSL2 kullanımını şiddetle tavsiye etmektedir. PowerShell kurulumu deneysel sayılır.

6. macOS'a Kurulum

macOS kurulumu çok daha basittir. Terminal'i açın (Spotlight'a "Terminal" yazın), ardından:

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

Kurulum scriptinden sonra:

openclaw onboard --install-daemon

macOS kullanıcıları için ayrıca bir menu bar uygulaması da mevcuttur — menü çubuğunuzda küçük bir ıstakoz ikonu belirir.

✅ macOS İpucu: Apple Silicon (M1/M2/M3) Mac kullanıyorsanız her şey sorunsuz çalışır. Intel Mac'lerde de aynı komutlar geçerlidir.

7. İlk Başlatma ve Dashboard (Kontrol Paneli)

Kurulum tamamlandıktan sonra web arayüzüne (Dashboard) erişmek için:

openclaw dashboard

Bu komut tarayıcınızda http://127.0.0.1:18789/ adresini otomatik açacak.

Dashboard'da ne var?

• Control UI: Yapay zekayla doğrudan tarayıcı üzerinden sohbet ettiğiniz yer
• Sessions (Oturumlar): Aktif sohbet oturumlarınız
• Channels (Kanallar): WhatsApp, Telegram gibi bağlı platformlar
• Logs (Günlükler): Ne yapıldığını görmek için — özellikle güvenlik açısından önemli

Sağlık kontrolü:

openclaw doctor

Bu komut olası sorunları ve güvenlik uyarılarını listeler. Kırmızı uyarılar varsa düzeltmenizi öneririz.

8. WhatsApp / Telegram Bağlamak

OpenClaw'un gerçek gücü, mesajlaşma uygulamalarını bağladığınızda ortaya çıkar.

Telegram Bağlantısı (Önerilen Başlangıç)

1. Telegram'da @BotFather'a gidin ve /newbot yazın. Size bir bot token'ı verecek.
2. Onboarding sihirbazında Telegram kanalını seçin ve bot token'ınızı yapıştırın.
3. Bot'unuzu Telegram'da bulun ve bir mesaj gönderin. OpenClaw "pairing" (eşleştirme) kodu isteyecektir — bu bilinmeyen kişilerin botunuza erişmesini engelleyen bir güvenlik önlemidir.

WhatsApp Bağlantısı

⚠️ WhatsApp Uyarısı: WhatsApp resmi bir API'ye sahip değil. OpenClaw, WhatsApp'ı "unofficial" (resmi olmayan) yöntemlerle bağlar. Hesabınızın askıya alınma riski — küçük de olsa — mevcuttur. Ana hesabınız yerine ayrı bir numara kullanmanızı öneririm.

Onboarding sırasında WhatsApp'ı seçerseniz, QR kod taraması yaparak hesabınızı bağlayabilirsiniz. Süreç WhatsApp Web'e bağlanmaya benzer.

9. Temel Kullanım Örnekleri

Kurulum tamamlandıktan sonra tarayıcıdaki dashboard'dan veya bağladığınız mesajlaşma uygulamasından OpenClaw'a mesaj gönderebilirsiniz.

Basit sohbet:

Siz: Bugün hava nasıl olacak Mersin'de?
OpenClaw: [web'de araştırır] Mersin için bugün 22°C, parçalı bulutlu...

Dosya oluşturma:

Siz: Masaüstüme "toplantı-notlari.txt" adında bir dosya oluştur ve içine bugünün tarihini yaz.
OpenClaw: [dosyayı oluşturur] Dosya oluşturuldu: ~/Desktop/toplantı-notlari.txt

Hatırlatıcı kurma:

Siz: Her gün saat 09:00'da bana "Kahve iç!" mesajı at.
OpenClaw: Tamam! Günlük 09:00 hatırlatıcısı kuruldu.

Kod çalıştırma:

Siz: Python ile 1'den 10'a kadar sayıları topla ve sonucu söyle.
OpenClaw: [Python çalıştırır] 1+2+...+10 = 55

10. Güvenli Kullanım Önerileri

✅ Yapmanız Gerekenler

• API anahtarınız için aylık harcama limiti belirleyin (OpenAI panelinden)
• Gateway'i sadece yerel ağınızda çalıştırın, internete açmayın
• Düzenli olarak openclaw doctor komutunu çalıştırın
• Pairing (eşleştirme) özelliğini açık tutun
• Skill indirmeden önce kaynağını araştırın
• Logları takip edin: openclaw daemon logs

✗ Yapmamanız Gerekenler

• İş bilgisayarınıza kurmayın
• WhatsApp için ana numaranızı kullanmayın
• Rastgele skill indirmeyin
• "open" DM politikasını açmayın (herkes mesaj atabilir hale gelir)
• API anahtarınızı config dosyasına düz metin olarak yazmayın
• ClawHub'dan tanımadığınız skillları yüklemeyin

✅ Son Bir Tavsiye: OpenClaw şu an hızla gelişen ama henüz olgunlaşmamış bir araçtır. Güvenlik açıkları sık sık yamalanıyor. Periyodik olarak güncelleme yapın: npm install -g openclaw@latest

Sonuç

OpenClaw, yapay zekanın geleceğinin küçük bir önizlemesi gibi. Telefonunuzdan mesaj atarak bilgisayarınızın işlerini yaptırmak — birkaç yıl önce hayal bile edilemezdi. Ama bu güç beraberinde ciddi sorumluluk getiriyor.

Riskleri anlayarak, doğru güvenlik önlemlerini alarak ve sabırla adım adım ilerleyerek kurulum yaparsanız OpenClaw size gerçekten çok şey kazandırabilir.

🦞 Mindi Notu: Ben şahsen OpenClaw'u ayrı bir test makinesinde, sınırlı araç izniyle, sadece güvendiğim kaynaklardan skill ekleyerek kullanıyorum. Hâlâ deneysel bir araç — ama potansiyeli çok büyük.

📖 Teknik Terimler Sözlüğü

OpenClaw: Ocak 2026'da Peter Steinberger tarafından geliştirilen, açık kaynaklı kişisel yapay zeka asistanı platformu. Clawdbot ve Moltbot isimlerini de taşımıştır.

Sunucu (VPS): İnternette 7/24 açık kalan uzak bir bilgisayar. DigitalOcean, Hetzner gibi şirketlerden aylık birkaç dolara kiralayabilirsiniz.

Skill (Yetenek): OpenClaw'a yeni bir yetenek kazandıran mini program. ClawHub adlı pazaryerinden indirilebilir. Zararlı skilllar da bulunduğundan dikkatli olunmalıdır.

Yapay Zeka Modeli: ChatGPT, Claude, Gemini gibi dil modellerinin her biri. OpenClaw bunları bir "motor" gibi kullanır, siz modeli seçersiniz.

API Anahtarı (API Key): Bir yazılımın, başka bir servise kimliğini kanıtlamak için kullandığı özel şifre. Her kullanımda küçük ücret kesilir.

Token: Yapay zeka modellerinin metni işleme birimi. Yaklaşık her 4 harf = 1 token.

Node.js: JavaScript programlama dilini bilgisayarda çalıştırmaya yarayan platform. OpenClaw bu teknoloji üzerine inşa edilmiştir.

WSL2 (Windows Subsystem for Linux 2): Microsoft'un Windows'a eklediği Linux uyumluluk katmanı. Ücretsizdir, Windows 10/11'de gelir.

Gateway: OpenClaw'un kalbi sayılan ana süreç. Mesajlaşma uygulamalarından gelen talepleri alır, yapay zeka modeline iletir, geri dönen cevabı size ulaştırır.

Bot Token: Telegram'ın botunuzu tanıması için verdiği özel şifre. BotFather aracılığıyla alınır. API anahtarı gibi korunmalıdır.