# OpenClaw nasıl kurulur ve Telegram'a nasıl bağlanır?

Boş bir makineden Telegram'da size yanıt veren bir ajana geçmek yaklaşık yarım saat sürer. Gösterilen komutlar resmî belgelerden alınmıştır; bu nedenle bunları kurduğunuz sürümle karşılaştırın.

## Gerekenler

- macOS, Linux, WSL2 veya Windows çalıştıran bir bilgisayar ya da VPS
- Node 24.16+ veya Node 26; yükleyici bunları sizin için kurabilir
- Bir model için API anahtarı veya abonelik ya da yerel bir model
- Bir Telegram hesabı

## Adım adım

### 1. Bir makine seçin ve bot oluşturun

Deneme için dizüstü bilgisayar yeterlidir; sürekli açık kalacak bir ajan içinse küçük bir VPS veya ev sunucusu kullanın. Ağ geçidi bağlantı noktası internete asla açık olmamalıdır. Telegram'da kullanıcı adını dikkatlice kontrol ettikten sonra @BotFather'a mesaj gönderin, /newbot komutunu çalıştırın ve verilen token'ı kopyalayın.

### 2. OpenClaw'ı kurun

Sisteminiz için resmî yükleyiciyi çalıştırın. Yükleyici işletim sistemini algılar, yoksa Node'u ekler, OpenClaw'ı kurar ve ardından ilk kurulumu başlatır.

```bash
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
```

### 3. İlk kurulumu tamamlayın ve ağ geçidi hizmetini kurun

Algılanan AI erişimini kullanmak için Quick start'ı, tüm seçenekleri belirlemek içinse Custom setup'ı seçin. İlk kurulum tamamlandığında, ön planda çalışan ağ geçidini durdurun ve yeniden başlatma sonrasında tekrar çalışması için arka plan hizmeti olarak kurun.

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. Telegram kanalını ekleyin

Bot token’ınızı kullanarak Telegram’ı kanal olarak ekleyin. Ardından bağlantının çalıştığını doğrulamak için kanal durumunu kontrol edin.

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. Eşleştirmeyi onaylayın

Botunuza herhangi bir mesaj gönderin. Tanınmayan gönderenlere yanıt yerine bir eşleştirme kodu gönderilir. Bekleyen istekleri listeleyin ve kendi kodunuzu bir saat içinde onaylayın.

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. Denetleyin ve güncelleyin

Yerleşik güvenlik denetimini çalıştırın ve kararlı kanaldan güncelleyin. 2026.4.22’den eski sürümlerde bilinen kritik güvenlik açıkları var; bu sürümlerden birini kullanmaya devam etmeyin.

```bash
openclaw security audit
openclaw update --channel stable
```

## Kurulumdan sonra yapılacak ilk işler

- Botunuzu bulan yabancıların kullanamaması için dmPolicy ayarını pairing olarak bırakın.
- Kurulumunuza güvenene kadar exec approvals ayarını her zaman soracak şekilde belirleyin.
- Güvenlik denetimini ve güncellemeleri düzenli olarak tekrarlayın.

## Sık yapılan hatalar

- Ağ geçidi bağlantı noktasını dışarı açmak yerine gateway.bind ayarını loopback olarak bırakın ve SSH veya Tailscale üzerinden bağlanın.
- Çok sayıda üçüncü taraf beceri yüklemekten kaçının. Bunları tarayıcı eklentileri gibi değerlendirin ve yalnızca güvendiğiniz kaynaklardan birkaçını ekleyin.
- Döngüde takılı kalan bir ajanın model token’larını harcamaya devam edeceğini unutmayın.