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

OpenClaw, kendi bilgisayarına ya da kiraladığın bir sunucuya kurduğun ve sadece senin için çalışan bir yapay zeka asistanı. ChatGPT'nin sitesinden farkı şu: OpenClaw arka planda 7/24 açık kalıyor. Sen ona WhatsApp'tan, Telegram'dan ya da tarayıcıdan mesaj atıyorsun, o da işi senin bilgisayarında yapıyor. Kurulum yarım saat kadar sürüyor. Ama başlamadan önce risk bölümünü mutlaka oku, çünkü bu araç bilgisayarında gerçekten iş yapabiliyor.

İçindekiler

1. OpenClaw Nedir?
2. ⚠️ Riskler — Önce Bunu Oku
3. Kurulumdan Önce Neler Lazım?
4. Modeli Bağla: ChatGPT Hesabı ya da API Anahtarı
5. Windows'a Kurulum
6. macOS'a Kurulum
7. İlk Açılış ve Kontrol Paneli
8. WhatsApp ve Telegram Bağlamak
9. Kullanım Örnekleri
10. Güvenli Kullanım

1. OpenClaw Nedir?

Proje Kasım 2025'te Clawdbot adıyla çıktı. Anthropic itiraz edince adı kısa bir süre Moltbot oldu, sonunda OpenClaw'da karar kılındı. Ocak 2026'da GitHub'da patladı ve sitenin en hızlı büyüyen açık kaynak projelerinden biri oldu. Bugün 390 binin üzerinde yıldızı var.

Şubat 2026'da projenin yaratıcısı Peter Steinberger OpenAI'ye katıldı. Bu bir satın alma değildi. OpenClaw açık kaynak olarak kaldı ve bugün bağımsız, kâr amacı gütmeyen OpenClaw Foundation tarafından yönetiliyor.

Neler yapabiliyor? WhatsApp, Telegram ya da Discord'dan yazdığın komutları bilgisayarında uyguluyor. E-postanı okuyabiliyor, takvimini düzenleyebiliyor, internette arama yapabiliyor. Dosya oluşturup düzenleyebiliyor ve kod çalıştırabiliyor. Hatırlatıcı kurup işleri arka planda yürütebiliyor. SkillⁱOpenClaw'a yeni bir yetenek kazandıran küçük eklenti denen eklentilerle yeni işler öğrenebiliyor, hatta bunları kendisi yazabiliyor. Arkasında OpenAI, Anthropic ya da Gemini gibi farklı yapay zeka modellerini çalıştırabiliyorsun.

ℹ️ Ücret: OpenClaw'un kendisi ücretsiz ve açık kaynak (MIT lisansı). Para, arkada kullandığın yapay zeka modeli için ödeniyor. Ya APIiprogramların birbirine bağlandığı kapı üzerinden kullandığın kadar ödüyorsun ya da var olan ChatGPT aboneliğini bağlıyorsun.

2. ⚠️ Riskler — Önce Bunu Oku

🔴 Önemli uyarı: OpenClaw bugün güvenliği en çok tartışılan yapay zeka araçlarından biri. Kaspersky, Cisco ve The Register gibi isimler bu konuda uyarı yayımladı. Kurmadan önce aşağıdaki riskleri bilmen gerekiyor.

Bilinen riskler:

• 🔑 Anahtar sızıntısı — Yanlış kurulmuş bir OpenClaw, API anahtarlarını ve bilgisayarındaki şifreleri dışarı sızdırabilir. Kötü niyetli bir skill bu bilgileri başkasına gönderebilir.
• 💉 Gizli talimat saldırısı (prompt injection) — Bir e-postanın ya da web sayfasının içine gizlenmiş talimatlar, OpenClaw'a senin istemediğin bir işi yaptırabilir.
• 🛒 Tehlikeli skill marketi — Güvenlik şirketi Snyk, Şubat 2026'da ClawHub ve skills.sh'teki yaklaşık 4.000 skill'i taradı. Bunların %13'ünde ciddi güvenlik sorunu çıktı, 76 tanesi doğrudan zararlı koddu. Rastgele skill indirme.
• 🌐 İnternete açılan yönetim paneli — Ayarlar yanlış yapılırsa yönetim paneline internetten ulaşılabilir hale gelebilir. Panelin varsayılan kapısı (port) 18789 ve bu kapı internete açık olmamalı.
• 💸 Beklenmedik fatura — Model kontrolsüz çalışırsa çok fazla tokenimodelin metni işlerken kullandığı birim, yaklaşık 4 harf 1 token eder harcayabilir. Harcama limitini baştan koy.
• 🖥️ Bilgisayarına tam erişim — OpenClaw dosya okuyup yazabiliyor ve komut çalıştırabiliyor. Bu yetki yanlış birinin ya da zararlı bir talimatın eline geçerse ciddi sorun çıkar.

Ne yapmalısın? OpenClaw'u iş bilgisayarına kurma, ayrı bir makine ya da kiralık sunucu (VPS) kullan. Gizli talimatlara daha dayanıklı olduğu için güçlü bir model seç. Skill'leri sadece güvendiğin yerlerden indir. Yönetim panelini internete açık bırakma. Model hesabına harcama limiti koy. İlk başta az yetkiyle başla, alıştıkça genişlet.

⚠️ Yeni başlıyorsan: Teknik bilgin sınırlıysa OpenClaw'u önce hiçbir kişisel dosyanın olmadığı ayrı bir bilgisayarda dene.

3. Kurulumdan Önce Neler Lazım?

Node.jsⁱbilgisayarda JavaScript programlarını çalıştıran altyapı için ayrıca bir şey yapman gerekmiyor, kurulum bunu kendisi hallediyor.

4. Modeli Bağla: ChatGPT Hesabı ya da API Anahtarı

OpenClaw'un çalışması için arkada bir yapay zeka modeli lazım. Bunu iki yoldan bağlayabilirsin.

ChatGPT hesabıyla (API anahtarı gerekmez): ChatGPT aboneliğin varsa kurulum sihirbazında OpenAI'yi seçip ChatGPT hesabınla giriş yapman yeterli. Ayrı bir fatura çıkmıyor, kullanım aboneliğinin limitinden düşüyor. Sonradan bağlamak istersen şu komutu kullan: openclaw models auth login --provider openai

API anahtarıyla: Kullandığın kadar ödüyorsun. Eskiden önerdiğimiz GPT-4o mini ve gpt-5.4-nano artık OpenAI'nin fiyat listesinde yok. Şu an listedeki en ucuz model gpt-6-luna. 1 milyon token girişi 0,10$, çıkışı 0,50$ tutuyor.

API anahtarını şöyle alırsın:

1. platform.openai.com adresine git ve ücretsiz hesap aç.
2. Sol menüden Billing > Add payment method (ödeme yöntemi ekle) bölümüne gir ve en az 5$ yükle. Burada Spending Limit (harcama sınırı) da koy, örneğin ayda 20$.
3. Sol menüden API Keys'e tıkla, sonra Create new secret key (yeni gizli anahtar oluştur) de. Çıkan ve sk-... ile başlayan anahtarı bir yere kaydet, çünkü bir daha gösterilmiyor.

🔴 Anahtarını koru: API anahtarını kimseyle paylaşma, ekran görüntüsüne koyma, mesajla gönderme. Bu anahtar kredi kartı bilgin kadar değerli.

5. Windows'a Kurulum

Windows'ta üç yol var. En kolayı ve resmi belgenin önerdiği yol Windows Hub adlı masaüstü uygulaması. Terminalle çalışmak istersen WSL2 ya da PowerShell ile de kurabilirsin. Linux'la tam uyum gerekiyorsa en sağlam seçenek hâlâ WSL2.

5.1 En Kolay Yol: Windows Hub Uygulaması

1. openclaw-windows-node sürüm sayfasından OpenClawCompanion-Setup-x64.exe dosyasını indir. Bilgisayarın ARM işlemciliyse OpenClawCompanion-Setup-arm64.exe dosyasını al.
2. Dosyayı çalıştırıp kur. Yönetici yetkisi istemiyor. Windows 10 (20H2 ve sonrası) ya da Windows 11 gerekiyor.
3. İlk açılışta Set up locally (bu bilgisayara kur) seçeneğine tıkla. Uygulama kendine ait ayrı bir Linux ortamı kuruyor. Bilgisayarında zaten Ubuntu varsa ona dokunmuyor.

Kurulum bitince görev çubuğundaki OpenClaw simgesinden sohbet penceresini ve sorunları gösteren Command Center ekranını açabilirsin. Terminalden kurmak istersen aşağıdaki adımlarla devam et.

5.2 WSL2'yi Kur

WSL2ⁱWindows'un içinde küçük bir Linux bilgisayar çalıştıran özellik Windows'un kendi parçası, ayrı bir program indirmen gerekmiyor.

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

wsl --install

Bu komut WSL2'yi ve Ubuntu'yu kuruyor. Bitince bilgisayarı yeniden başlat.

1. Bilgisayar açılınca Ubuntu penceresi gelecek ve senden kullanıcı adı ile şifre isteyecek. Bunlar sadece Ubuntu'nun içinde kullanılıyor.

2. systemd'yi aç. systemdⁱLinux'ta arka plan servislerini başlatan sistem OpenClaw'un arka planda sürekli çalışması için gerekiyor. Ubuntu penceresine şunu yapıştır:

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

Sonra PowerShell'de wsl --shutdown komutunu çalıştır ve Ubuntu'yu yeniden aç.

5.3 OpenClaw'u WSL2'ye Kur

1. Ubuntu penceresinde kurulum scriptini çalıştır:

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

Bu komut Node.js dahil gereken her şeyi kuruyor. İnternet hızına göre birkaç dakika sürüyor.

1. Kurulum bitince kurulum sihirbazı (onboarding) kendiliğinden açılıyor. Açılmazsa şunu yaz:

openclaw onboard --install-daemon

1. Sihirbaz sana birkaç soru soracak. Yapay zeka sağlayıcısı olarak OpenAI'yi seç. Sonra ya sk-... ile başlayan API anahtarını gir ya da ChatGPT hesabınla giriş yap. API anahtarı kullanıyorsan model sorusunda en ucuz seçenek olan gpt-6-luna'yı seçebilirsin.

2. Her şeyin çalıştığını kontrol et:

openclaw gateway status

Çıktıda running (çalışıyor) yazıyorsa tamam.

5.4 Başka Bir Yol: PowerShell ile Kurulum

WSL2 ile uğraşmadan doğrudan Windows'a kurmak istersen PowerShell'e şunu yapıştır:

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

Bu yol artık resmi seçeneklerden biri. Kurulumdan sonra openclaw doctor ve openclaw gateway status komutlarıyla kontrol et. Windows script çalıştırmayı engellerse güvenlik ayarını gevşetme. Resmi belge bu durumda npm ile kurulan openclaw.cmd yolunu öneriyor.

6. macOS'a Kurulum

Mac'te kurulum daha kısa. Spotlight'a "Terminal" yazıp Terminal'i aç ve şunu yapıştır:

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

Kurulum bitince sihirbazı başlat:

openclaw onboard --install-daemon

İstersen GitHub'daki sürüm sayfasından Mac uygulamasını da indirebilirsin. Kurunca menü çubuğunda küçük bir ıstakoz simgesi çıkıyor. Komutlar Apple Silicon ve Intel işlemcili Mac'lerde aynı.

7. İlk Açılış ve Kontrol Paneli

Kurulum bitince kontrol panelini (dashboard) açmak için şunu yaz:

openclaw dashboard

Tarayıcında http://127.0.0.1:18789/ adresi açılıyor. Bu adres sadece senin bilgisayarından açılıyor.

Panelde dört bölüm var. Control UI, yapay zekayla tarayıcıdan sohbet ettiğin yer. Sessions açık sohbetlerini, Channels ise bağladığın WhatsApp ya da Telegram gibi uygulamaları gösteriyor. Logs, OpenClaw'un ne yaptığının kaydı. Güvenlik açısından buraya ara ara göz atman iyi olur.

Sağlık kontrolü için şu komutu çalıştır:

openclaw doctor

Bu komut olası sorunları ve güvenlik uyarılarını listeliyor. Kırmızı uyarı varsa önce onları düzelt.

8. WhatsApp ve Telegram Bağlamak

OpenClaw asıl işe yaramaya bir mesajlaşma uygulamasını bağladığında başlıyor.

Telegram (başlamak için en kolayı)

1. Telegram'da @BotFather'ı aç ve /newbot yaz. Sana bir bot token'ı verecek. Bunu botunun şifresi gibi düşün.
2. Kurulum sihirbazında Telegram'ı seç ve bu token'ı yapıştır.
3. Telegram'da kendi botunu bul ve bir mesaj at. OpenClaw senden bir eşleştirme (pairing) kodu isteyecek. Bu kod, tanımadığın birinin botuna yazmasını engelliyor.

WhatsApp

⚠️ Dikkat: OpenClaw WhatsApp'a resmi iş bağlantısı (Business API) üzerinden değil, resmi olmayan bir yöntemle bağlanıyor. Bu yüzden hesabının askıya alınma riski düşük de olsa var. Ana numaran yerine ayrı bir numara kullan.

Kurulum sihirbazında WhatsApp'ı seçince ekrana bir QR kod geliyor. Telefonundan bu kodu okutarak bağlanıyorsun, tıpkı WhatsApp Web'e girer gibi.

9. Kullanım Örnekleri

Kurulum bitince tarayıcıdaki panelden ya da bağladığın mesajlaşma uygulamasından OpenClaw'a yazabilirsin. Birkaç örnek:

Basit soru:

Sen: Bugün Mersin'de hava nasıl olacak?
OpenClaw: [internette arar] Mersin için bugün 22°C, parçalı bulutlu...

Dosya oluşturma:

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

Sen: Her gün saat 09:00'da bana "Kahve iç!" mesajı at.
OpenClaw: Tamam, her gün 09:00 için hatırlatıcı kuruldu.

Kod çalıştırma:

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

✅ Bunları yap

• Model hesabında aylık harcama limiti koy.
• Gateway'i (OpenClaw'un arka planda çalışan ana programı) sadece kendi ağında çalıştır, internete açma.
• Ara ara openclaw doctor komutunu çalıştır.
• Eşleştirme (pairing) özelliğini açık tut.
• Bir skill'i indirmeden önce kimin yazdığına bak.
• Kayıtları takip et: openclaw logs --follow

✗ Bunları yapma

• OpenClaw'u iş bilgisayarına kurma.
• WhatsApp'ta ana numaranı kullanma.
• ClawHub'dan tanımadığın skill'leri yükleme.
• Mesaj (DM) ayarını "open" yapma, yoksa botuna herkes yazabilir.
• API anahtarını ayar dosyasına açık metin olarak yazma.

✅ Güncel tut: OpenClaw hızlı gelişiyor ve güvenlik açıkları sık kapatılıyor. Ara ara şu komutla güncelle: openclaw update --channel stable

Sonuç: Şimdi Ne Yaparsın?

1. Risk bölümünü oku ve OpenClaw'u kuracağın ayrı bir bilgisayar ya da sunucu seç.
2. Modeli nasıl bağlayacağına karar ver. ChatGPT aboneliğin varsa onu kullan, yoksa OpenAI'den API anahtarı al ve harcama limiti koy.
3. Windows'taysan Windows Hub'ı, Mac ya da Linux'taysan kurulum scriptini kullan.
4. openclaw doctor ile kontrol et ve kırmızı uyarı kalmadığından emin ol.
5. İlk kanal olarak Telegram'ı bağla ve eşleştirme kodunu tamamla.
6. Birkaç gün az yetkiyle kullan ve harcamanı takip et. Alıştıkça yeni skill ve kanal ekle.

OpenClaw hâlâ deneysel bir araç. Telefondan mesaj atıp bilgisayarına iş yaptırmak gerçekten işe yarıyor, ama bu yetkiyi verdiğin her şeyi kontrol altında tutman gerekiyor.

📖 Terimler Sözlüğü

OpenClaw: Peter Steinberger'ın Kasım 2025'te başlattığı, bugün OpenClaw Foundation'ın yönettiği açık kaynak (MIT lisanslı) kişisel yapay zeka asistanı. Önceki adları Clawdbot ve Moltbot.

Sunucu (VPS): İnternette 7/24 açık duran, kiraladığın uzak bir bilgisayar. DigitalOcean ya da Hetzner gibi şirketlerden aylık birkaç dolara kiralayabilirsin.

Skill: OpenClaw'a yeni bir yetenek kazandıran küçük eklenti. ClawHub adlı marketten indiriliyor. Aralarında zararlı olanlar da var, dikkatli seç.

Yapay zeka modeli: GPT, Claude ya da Gemini gibi dil modelleri. OpenClaw bunları bir motor gibi kullanıyor, hangisini kullanacağını sen seçiyorsun.

API anahtarı: Bir programın başka bir servise kendini tanıtmak için kullandığı gizli şifre. Her kullanımda hesabından küçük bir ücret düşüyor.

Token: Modelin metni işlerken kullandığı birim. Yaklaşık 4 harf 1 token ediyor.

Node.js: Bilgisayarda JavaScript programlarını çalıştıran altyapı. OpenClaw bunun üzerine kurulu.

WSL2: Microsoft'un Windows'a eklediği, Windows'un içinde Linux çalıştıran özellik. Ücretsiz ve Windows 10 ile 11'de var.

Gateway: OpenClaw'un kalbi sayılan ana program. Mesajlaşma uygulamalarından gelen isteği alıyor, modele iletiyor ve gelen cevabı sana ulaştırıyor.

Bot token: Telegram'ın senin botunu tanıması için verdiği şifre. BotFather'dan alınıyor ve API anahtarı gibi korunmalı.