OpenClaw Kurulumu: Windows'ta DeepSeek ve Telegram ile Adım Adım

OpenClaw, bilgisayarında çalışan bir yapay zeka ağ geçididir. Telegram gibi mesajlaşma uygulamalarını seçtiğin bir yapay zeka modeline bağlar. Bu rehberde OpenClaw'ı Windows'ta sıfırdan kuruyor, DeepSeek modelini bağlıyor ve bir Telegram botunu yalnızca senin kullanabileceğin şekilde ayarlıyoruz.

Test bilgisi: Bu rehber OpenClaw 2026.9.5 sürümüyle, 19 Eylül 2026'da Windows 11'de denenmiştir. Sürümler hızlı değişir. Komutlar farklı çıkarsa resmi dokümantasyona bak.

Bu rehberde neler var

Node.js 24 kurulumu
OpenClaw paketinin kurulumu
Kurulum sihirbazı ve Gateway
DeepSeek modelini bağlama
Telegram botunu bağlama
Botu sadece kendine kilitleme
Tek promptla kurulum
Güvenlik notları
Sık karşılaşılan hatalar

Başlamadan önce

Gerekenler:

Windows 10 veya 11 (OpenClaw dokümantasyonu Windows'ta WSL2 kullanmayı önerir. Bu rehber yerel Windows'ta çalıştı, ama bazı şeyler daha sorunlu olabilir.)
Yönetici izni (Node.js kurulumu ve Gateway servisi için)
Bir DeepSeek hesabı, API anahtarı ve bakiye
Bir Telegram hesabı

Not: OpenClaw Node.js 24.16 veya üstünü ister. Node 20 ve 22 çalışmaz. Paketin engines alanı >=24.16.0 <25 || >=26.1.0 şeklindedir.

1. Node.js 24'ü kur

Önce mevcut sürümü kontrol et:

node --version

v24.16.0 veya üstünü görüyorsan 2. adıma geç. Daha eskiyse, Windows'ta winget ile Node 24 LTS'i kur:

winget install --id OpenJS.NodeJS.LTS --source winget

Kurulum yönetici onayı isteyecektir. Bu komut sistemdeki mevcut Node'un yerine geçer. Başka projelerin Node 20 gerektiriyorsa bunu bilerek yap.

Kurulumdan sonra PowerShell'i kapatıp yeniden aç. Sonra kontrol et:

node --version

Çıktı v24.19.0 gibi olmalı.

2. OpenClaw'ı kur

OpenClaw'ın resmi npm paketi openclaw'dır. Sadece bu paketi kur:

npm install -g openclaw@latest

Kurulum birkaç dakika sürebilir (yaklaşık 330 paket iner). npm warn deprecated satırları normaldir. Bittiğinde kontrol et:

openclaw --version

Çıktı OpenClaw 2026.9.5 gibi bir sürüm gösterir.

Uyarı: GitHub'da dolaşan "özelleştirilmiş" veya fork edilmiş OpenClaw depolarını kurma. OpenClaw bilgisayarında komut çalıştırabilen bir araçtır. Güvenmediğin bir kaynaktan gelen sürüm bilgisayarına zarar verebilir. Resmi adresler: openclaw.ai ve docs.openclaw.ai.

3. Kurulum sihirbazını çalıştır

Sihirbaz çalışma alanını ve Gateway'i hazırlar. Adım adım sorularla ilerlemek için:

openclaw onboard --install-daemon

Ben kanalları ve model anahtarını sonradan kendim eklemek için tek komutla, sorusuz kurulum yaptım:

openclaw onboard --non-interactive --accept-risk --mode local --flow quickstart --auth-choice skip --skip-channels --skip-skills --skip-search --skip-hooks --skip-ui --install-daemon --gateway-bind loopback --gateway-auth token --gateway-port 18789

Bayrakların anlamı:

Bayrak	Ne yapar
`--non-interactive`	Soru sormadan çalışır
`--accept-risk`	"Agent'lar güçlüdür, tam sistem erişimi risklidir" uyarısını kabul eder. Non-interactive modda zorunludur. Kabul etmeden önce oku.
`--auth-choice skip`	Model anahtarı girmeyi atlar (sonra ekleyeceğiz)
`--skip-channels`, `--skip-skills`, `--skip-hooks`, `--skip-search`	Kanal, skill, hook ve arama kurulumunu atlar
`--install-daemon`	Gateway'i arka planda çalışan bir servis olarak kurar
`--gateway-bind loopback`	Gateway'e yalnızca senin bilgisayarından erişilir
`--gateway-auth token`	Gateway erişimi token ile korunur
`--gateway-port 18789`	Gateway portu

Bu komut Windows'ta "OpenClaw Gateway" adında bir Zamanlanmış Görev (Scheduled Task) oluşturur.

Gateway çalışıyor mu?

openclaw gateway status

Şunları görmelisin:

Runtime: running
bind=loopback (127.0.0.1), port=18789
Connectivity probe: ok

bind=loopback çok önemlidir. Gateway'e internetten değil, sadece bu bilgisayardan erişilebilir demektir.

Control UI'ı aç

openclaw dashboard

Bu komut tarayıcıda OpenClaw'ın kendi yönetim arayüzünü (Control UI) açar. Adresi http://127.0.0.1:18789/ şeklindedir. Arayüz bilgisayarında çalışır, internete açık değildir.

Ekran kaydı alıyorsan: openclaw dashboard token'lı bir bağlantıyla açabilir. Kayıttan önce adres çubuğunu temiz adrese (http://127.0.0.1:18789/) çevir.

4. DeepSeek modelini bağla

Yapay zeka cevapları için bir modele ihtiyacın var. Bu rehberde DeepSeek kullanıyoruz.

DeepSeek platformunda bir API anahtarı oluştur ve hesabına bakiye yükle.
Ayar sihirbazını aç:
```
openclaw configure
```
Menüden Model'i seç, sağlayıcı olarak DeepSeek'i seç.
API anahtarını istendiği alana yapıştır.
Model listesinde deepseek-flash işaretle (Tab ile seç, Enter ile onayla). Varsayılan model olarak da bunu seç.
Ana menüde Skip for now ile çık.

Anahtarını kimseyle paylaşma. Sohbetlere, ekran görüntülerine ve videolara yapıştırma. Anahtarlar bilgisayarında ~\.openclaw klasöründe saklanır. Bu klasörü paylaşma.

Hangi modeli seçmeli?

DeepSeek'in fiyat sayfasına göre (yazının yazıldığı tarihte, 1 milyon token başına):

Model	Girdi	Çıktı
`deepseek-flash`	0,15–0,30 $	0,60–1,20 $
`deepseek-v4-pro`	0,66–1,32 $	1,98–3,96 $

İlk rakam yoğun olmayan saatlerin, ikinci rakam yoğun saatlerin fiyatıdır. Günlük kullanım için Flash yeterli ve yaklaşık dört kat ucuzdur. Fiyatlar değişebilir, güncel halini DeepSeek'in sayfasından kontrol et.

Model bağlandı mı?

openclaw models status

Çıktıda şunları ara:

Default: deepseek/deepseek-flash
Auth bölümünde deepseek için bir api-key profili

Varsayılan model farklıysa ayarla:

openclaw models set deepseek/deepseek-flash

Ardından Gateway'i yeniden başlat:

openclaw gateway restart

5. Telegram botunu bağla

Botu oluştur

Telegram'da @BotFather'ı aç.
/newbot yaz.
Botuna bir isim ve bot ile biten bir kullanıcı adı ver.
BotFather sana bir token verir. Bu token botunun şifresidir. Kimseyle paylaşma.

Botu OpenClaw'a ekle

openclaw channels add --channel telegram

Sihirbaz sırasıyla şunları sorar:

Token nasıl verilecek? Token'ı gir. Yıldızlı görünür.
DM erişim politikası: Varsayılan pairing'dir. Bu politikada botu bulan herkes eşleştirme isteği gönderebilir (istek senin onayını bekler). Bir sonraki bölümde bunu daha katı yapacağız.
"Set up administration from your own chat account?" Bu, kendi sohbet hesabına OpenClaw'ı yönetme yetkisi vermekle ilgilidir. Şimdilik Skip for now seç.

Bittiğinde "channels updated" benzeri bir mesaj görürsün.

Kanal çalışıyor mu?

openclaw channels status

Şu satırı görmelisin:

Telegram default: enabled, configured, running, connected

6. Botu sadece kendine kilitle

Botunun kullanıcı adını bilen herkes ona yazmayı deneyebilir. Bota yalnızca senin yazabilmen için bir izin listesi (allowlist) kullan.

Telegram kullanıcı ID'ni öğren. Kullanıcı adın değil, sayısal ID gerekir. Telegram'da @userinfobot'a /start yazarsan ID'ni söyler.

Şu iki komutu çalıştır (SENIN_ID yerine kendi ID'ni yaz):

openclaw config set channels.telegram.dmPolicy "allowlist"
openclaw config set channels.telegram.allowFrom '["SENIN_ID"]'

Kontrol et:

openclaw config get channels.telegram.dmPolicy
openclaw config get channels.telegram.allowFrom

İlki allowlist, ikincisi senin ID'ni içeren bir liste göstermeli.

Kanal kurulumu sırasında sihirbaz bunu sorarsa aynı seçenekleri oradan da yapabilirsin.

7. Dene

Telegram'da botunu aç, /start yaz, sonra bir mesaj at:

Merhaba, kendini tanıt.

Birkaç saniye içinde DeepSeek cevap vermelidir. Aynı konuşmayı Control UI'da da görebilirsin.

Cevap gelmezse:

openclaw channels status ile Telegram kanalının bağlı olduğunu doğrula.
openclaw models status ile model anahtarının kayıtlı olduğunu doğrula.
DeepSeek hesabında bakiye olduğunu kontrol et.
ID'nin doğru girildiğini kontrol et.

Tek promptla kurmak istersen

Yukarıdaki adımları elle yapmak yerine, terminalde komut çalıştırabilen bir yapay zeka aracına (örneğin Claude Code) tek bir prompt da verebilirsin. Aşağıdaki prompt sadece temel kurulumu yaptırır: Node kontrolü, resmi paket, Gateway ve Control UI. Model anahtarını ve Telegram gibi kanalları bilerek dışarıda bırakır. Onları 4. ve 5. bölümdeki gibi kendin yap.

OpenClaw'u (resmi site: openclaw.ai, dökümantasyon: docs.openclaw.ai,
npm paketi: "openclaw") bilgisayarımda kurup kullanıma hazır hale
getirmeni istiyorum. Şunları yap:

1. Sistemimde Node.js kurulu mu ve sürümü uygun mu kontrol et
   (OpenClaw Node 24.16+ istiyor, Node 22 ve altı çalışmaz). Kurulu
   değilse veya sürüm eskiyse kurulum/güncelleme adımlarını söyle ve
   sistem genelini değiştiren bir kurulum yapmadan önce bana sor.
2. Resmi npm paketini kur: `npm install -g openclaw@latest`
   (ya da `pnpm add -g openclaw@latest`). SADECE bu resmi paketi
   kullan, GitHub'da dolaşan "fork" veya "özelleştirilmiş" repoları
   ASLA kullanma veya önerme.
3. `openclaw onboard --install-daemon` komutunu çalıştırıp kurulum
   sihirbazını başlat, Gateway ve workspace ayarlarını benim için
   yapılandır. Sihirbazı etkileşimli süremiyorsan, risk uyarısını
   benim yerime kabul eden `--accept-risk` bayrağını kullanmadan önce
   bana sor.
4. Herhangi bir mesajlaşma platformuna (WhatsApp, Telegram, Discord
   vb.) BAĞLAMA, hiçbir hesabımı OTOMATİK yetkilendirme, mail/takvim/
   dosya erişimi VERME, API anahtarı veya token girme — bu adımları
   ben kendim, ne yetki verdiğimi görerek yapacağım. Sadece temel
   kurulumu tamamlayıp Control UI'ı açık ve çalışır hale getir.
5. Kurulum bittiğinde bana şunu özetle: hangi platformları
   bağlayabileceğimi, hangi izinleri istediğini, ve üçüncü parti
   "skill" eklemenin risklerini (denetlenmediklerini) kısaca anlat.
6. Karşılaşabileceğim yaygın kurulum hatalarını (port çakışması,
   Node sürüm uyumsuzluğu, izin sorunları) ve çözümlerini not et.

Amacım ekran kaydı ile bir video/Reels çekmek, bu yüzden arayüzün açık
ve kullanıma hazır olması, ama hiçbir gerçek hesabımın veya kişisel
verimin otomatik bağlanmamış/yetkilendirilmemiş olması çok önemli.

Prompt'u kullanmadan önce bil:

Yapay zeka aracı bilgisayarında komut çalıştırır. Çalıştırdığı komutları onay ekranında oku. Kuralları senin yerine kabul etmesine izin verme.
Prompt model bağlamaz. Kurulum bitince OpenClaw hazır ama cevap vermez. DeepSeek anahtarını 4. bölümdeki gibi kendin gir.
Anahtar ve token'ı prompt'a yazma. Yapay zeka aracına anahtar vermek, onu konuşma geçmişine yazmak demektir.

Güvenlik notları

Araç yetkileri. Varsayılan agent, araç profili full ile çalışır (openclaw config get tools). Bu, modelin bilgisayarında komut çalıştırıp dosya okuyup yazabileceği anlamına gelir. Bota yazabilen herkes bilgisayarında dolaylı olarak komut çalıştırabilir. Bu yüzden allowlist adımı isteğe bağlı değildir. Gerçek hesaplar bağlamadan önce araç yetkilerini daraltmayı düşün.

Üçüncü parti skill'ler. OpenClaw'a topluluk tarafından yazılmış skill'ler eklenebilir. Bunlar denetlenmez. Bir skill, agent'ın araçlarıyla çalıştığı için anahtar sızdırabilir, dosya silebilir veya prompt injection uygulayabilir. Yüklemeden önce kaynağını ve kodunu oku, yayıncıyı kontrol et, mümkünse ayrı bir agent'ta dene.

Token ve anahtarlar. Token'ı veya API anahtarını yanlışlıkla paylaştıysan hemen yenile. Telegram için BotFather'da /revoke, DeepSeek için platform panelinden yeni anahtar oluştur.

WhatsApp bağlama. WhatsApp bağlantısı QR ile cihaz bağlama yoluyla yapılır ve hesabındaki tüm mesajlara erişim verir. Kişisel numaranla değil, yedek bir numarayla dene. Bağlı cihazlar listesinden istediğin an silebilirsin.

Sık karşılaşılan hatalar

Sorun	Çözüm
Node sürümü uyumsuz	Node 24 LTS kur (`winget install OpenJS.NodeJS.LTS`), yeni terminal aç.
`openclaw` veya `node` komutu eski sürümü gösteriyor ya da bulunamıyor	PATH yenilenmemiştir. PowerShell'i kapatıp yeniden aç. `npm config get prefix` klasörünün (`%APPDATA%\npm`) PATH'te olduğundan emin ol.
Port 18789 çakışması	`netstat -ano \| findstr :18789` ile portu kullanan işlemi bul. Ya da portu değiştir: `openclaw config set gateway.port 18790`, sonra `openclaw gateway restart`.
Gateway çalışmıyor	`openclaw gateway status` ve `openclaw doctor` çalıştır. Log dosyası: `~\AppData\Local\Temp\openclaw\`.
Zamanlanmış görev kurulamadı / izin hatası	PowerShell'i yönetici olarak aç, `openclaw gateway install` komutunu tekrar çalıştır.
`npm install -g` izin hatası (EACCES/EPERM)	Yönetici PowerShell'i dene. Antivirüs dosyayı kilitliyor olabilir, tekrar dene.
Control UI "Gateway kendi belirtecini bekliyor" diyor	`openclaw dashboard` ile token'lı bağlantıyı aç.
Control UI'da `No API key found for provider "deepseek"`	Anahtar kaydedilmemiştir ya da hata eski kalmıştır. `openclaw models status` ile kontrol et, gerekirse `openclaw configure` ile anahtarı yeniden gir.
Varsayılan model ile izin verilen model uyuşmuyor	`openclaw models set deepseek/deepseek-flash` ve `openclaw gateway restart`.
Bot cevap vermiyor	`openclaw channels status`, `openclaw models status`, DeepSeek bakiyesi ve allowlist ID'sini kontrol et.

Kaldırma

Gateway servisini ve paketi kaldırmak için:

openclaw gateway uninstall
npm uninstall -g openclaw

Ayarları ve oturumları sıfırlamak istersen openclaw onboard --reset --reset-scope config+creds+sessions komutu vardır. Çalıştırmadan önce ne sildiğini oku.

Sonuç

Artık bilgisayarında çalışan, DeepSeek ile konuşan ve yalnızca senin Telegram hesabına cevap veren bir asistanın var. Sonraki adım olarak WhatsApp veya Discord gibi başka kanalları ekleyebilir ya da araç yetkilerini daraltabilirsin. Her yeni yetki vermeden önce ekranda ne istediğini oku.

Takıldığın yerde sorunu yorumlarda paylaş. Hata mesajının tamamını yaz, ama token, anahtar ve kullanıcı ID'ni paylaşma.