OpenClaw v2026.2 için geçerlidir | Bu makale, OpenClaw kurulumunu tamamladığınızı ve kullanılabilir bir Telegram Bot Token’ınız (ücretsiz olarak edinilebilir) olduğunu varsayar.

TL;DR: Telegram, yapılandırması en kolay kanaldır: Bot oluştur (@BotFather), Token al, ~/.openclaw/openclaw.json dosyasına yapılandır, Gateway’i başlat. Varsayılan olarak DM eşleştirme koruması etkindir, gruplarda yanıt vermek için @mention gerekir. Ayrıca WhatsApp (QR kod ile giriş), Discord (Bot Token), Slack yapılandırması da ele alınmıştır.

Neden Telegram ile Başlamalı?

Kanal Karşılaştırması

Telegram’ı Seçme Nedenleri

1. En kolay yapılandırma: Yalnızca Bot oluşturup Token almak yeterli
2. En kapsamlı belgeler: Telegram Bot API sektör standardıdır
3. En zengin özellikler: Komutlar, düğmeler, satır içi sorgular ve daha fazlasını destekler
4. En aktif topluluk: Sorunlara çözüm bulmak kolaydır

Telegram Bot Oluşturma

Adım 1: BotFather’ı Bulun

1. Telegram uygulamasını açın
2. @BotFather araması yapın (resmi Bot yönetim aracı)
3. Sohbete girin

sequenceDiagram
    participant U as Siz
    participant BF as BotFather
    participant TG as Telegram
    
    U->>BF: /newbot
    BF->>U: Bot görünen adını girin
    U->>BF: My OpenClaw Assistant
    BF->>U: Bot kullanıcı adını girin (bot ile bitmeli)
    U->>BF: myclaw_bot
    BF->>TG: Bot oluştur
    TG-->>BF: Bot başarıyla oluşturuldu
    BF->>U: API Token döndür

Adım 2: Yeni Bot Oluştur

BotFather’da komutu gönderin:

/newbot

Talimatları izleyin:

1. Bot görünen adı: Örn. My OpenClaw (boşluk içerebilir)
2. Bot kullanıcı adı: Örn. myclaw_bot (bot ile bitmeli)

Başarılı oluşturma sonrası BotFather şunu döndürür:

Done! Congratulations on your new bot...

Use this token to access the HTTP API:
7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your token secure...

⚠️ Önemli: API Token’ı güvenli bir yerde saklayın, Bot üzerinde tam kontrol yetkisine sahiptir.

Adım 3: Bot Bilgilerini Yapılandır (İsteğe Bağlı)

# BotFather'da Bot profil resmi ayarla
/setuserpic
# Botunuzu seçin, resim yükleyin

# Bot açıklaması ayarla
/setdescription
# Botunuzu seçin, açıklama metnini girin

# Bot hakkında bilgi ayarla
/setabouttext
# Botunuzu seçin, hakkında metnini girin

# Bot komutlarını ayarla
/setcommands
# Komut listesini girin, örn.:
# start - Kullanmaya başla
# help - Yardım al
# status - Durumu görüntüle

OpenClaw Yapılandırması

Yöntem A: Ortam Değişkeni (Hızlı Test)

# Ortam değişkenini ayarla
export TELEGRAM_BOT_TOKEN="7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Gateway'i başlat
openclaw gateway

Yöntem B: Yapılandırma Dosyası (Üretim İçin Önerilir)

~/.openclaw/openclaw.json dosyasını düzenleyin:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}

Yöntem C: CLI ile Yapılandırma

# Etkileşimli yapılandırma
openclaw config set channels.telegram.botToken "7123456789:AAH..."

# Veya onboard sihirbazı ile
openclaw onboard

Yapılandırmayı Doğrula

# Yapılandırmayı kontrol et
openclaw config get channels.telegram.botToken

# Tanılama çalıştır
openclaw doctor

# Gateway'i başlat (hata ayıklama modu)
openclaw gateway --verbose

Başarılı başlatma sonrası şuna benzer günlükleri göreceksiniz:

[INFO] Gateway starting on port 18789
[INFO] Telegram channel connected
[INFO] Bot: @myclaw_bot
[INFO] Waiting for messages...

Güvenlik Yapılandırması

DM Eşleştirme Mekanizması

Varsayılan olarak OpenClaw, yabancıların Bot’unuzu kötüye kullanmasını önlemek için DM eşleştirme mekanizmasını (dmPolicy: "pairing") etkinleştirir.

sequenceDiagram
    participant S as Yabancı
    participant B as Bot
    participant G as Gateway
    participant O as Siz
    
    S->>B: Mesaj gönder "Merhaba"
    B->>G: Mesaj ulaştı
    G->>G: Eşleştirme durumunu kontrol et
    G-->>B: Eşleştirilmedi, eşleştirme kodu döndür
    B-->>S: "Lütfen eşleştirin: Kod ABC123"
    S->>O: Eşleştirme kodunu söyle
    O->>G: openclaw pairing approve telegram ABC123
    G->>G: Beyaz listeye ekle
    G-->>S: Eşleştirme başarılı, sohbet edebilirsiniz

DM Politikasını Yapılandır

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "dmPolicy": "pairing",
      "allowFrom": []
    }
  }
}

Eşleştirme İsteklerini Yönet

# Bekleyen eşleştirme listesini görüntüle
openclaw pairing list

# Örnek çıktı:
# Channel    Code     User        Created
# telegram   ABC123   @stranger   2026-02-26 10:30:00

# Eşleştirmeyi onayla
openclaw pairing approve telegram ABC123

# Eşleştirmeyi reddet
openclaw pairing reject telegram ABC123

# Eşleştirilmiş kullanıcıları görüntüle
openclaw pairing show telegram

Beyaz Liste Modu

Yalnızca belirli kullanıcıların mesaj göndermesine izin ver:

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "dmPolicy": "open",
      "allowFrom": [123456789, 987654321]
    }
  }
}

💡 Telegram Kullanıcı ID’sini Alma: @userinfobot‘a herhangi bir mesaj gönderin, sayısal ID’nizi döndürecektir.

Grup Yapılandırması

Temel Grup Ayarı

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Çoklu Grup Farklılaştırılmış Yapılandırma

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "groups": {
        "-100123456789": {
          "requireMention": false,
          "name": "İş grubu"
        },
        "-100987654321": {
          "requireMention": true,
          "name": "Sohbet grubu"
        },
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

💡 Grup ID’sini Alma: Bot’u gruba ekledikten sonra grupta herhangi bir mesaj gönderin, Gateway günlüklerinde grup ID’sini görebilirsiniz.

Bot’u Gruba Ekle

1. Grup ayarlarında “Üye Ekle"ye tıklayın
2. Bot kullanıcı adınızı arayın (örn. @myclaw_bot)
3. Ekle’yi seçin
4. (İsteğe bağlı) Daha fazla yetki için Bot’u yönetici yapın

WhatsApp Yapılandırması

Yöntem: QR Kod ile Giriş

WhatsApp, Web protokolünü kullanır ve QR kod ile bağlanma gerektirir:

# Giriş sürecini başlat
openclaw channels login whatsapp

# Terminalde QR kod görüntülenir
# Telefondaki WhatsApp ile tarayın:
# Ayarlar > Bağlı Cihazlar > Cihaz Bağla > QR Kodu Tara

sequenceDiagram
    participant U as Kullanıcı
    participant C as CLI
    participant W as WhatsApp
    participant G as Gateway
    
    U->>C: openclaw channels login whatsapp
    C->>W: QR kod iste
    W-->>C: QR kod döndür
    C->>U: QR kodu göster
    U->>W: Telefonla tara
    W-->>C: Kimlik doğrulama başarılı
    C->>G: Kimlik bilgilerini kaydet
    G-->>U: WhatsApp bağlandı

Yapılandırma Örneği

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

WhatsApp Kısıtlamaları

Discord Yapılandırması

Discord Bot Oluşturma

1. Discord Developer Portal adresini ziyaret edin
2. “New Application"a tıklayın
3. Ad girin, örn. OpenClaw Assistant
4. “Bot” sayfasına gidin, “Add Bot"a tıklayın
5. Token‘ı kopyalayın (Application ID değil)

OAuth2 Yetkilerini Yapılandır

1. “OAuth2” > “URL Generator"a gidin
2. Aşağıdaki yetkileri işaretleyin:

3. Oluşturulan davet bağlantısını kopyalayın
4. Tarayıcıda bağlantıyı açın, Bot’u sunucuya davet edin

Yapılandırma Örneği

{
  "channels": {
    "discord": {
      "token": "MTk4NjIyNDgzNDc...",
      "guilds": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Discord Özellik Yapılandırması

{
  "channels": {
    "discord": {
      "token": "your_token",
      "commands": {
        "native": true,
        "text": true
      },
      "mediaMaxMb": 25
    }
  }
}

Slack Yapılandırması

Slack App Oluşturma

1. Slack API adresini ziyaret edin
2. “Create New App"e tıklayın
3. “From scratch"i seçin
4. App adını girin, çalışma alanını seçin

OAuth Yetkilerini Yapılandır

“OAuth & Permissions” sayfasında aşağıdaki Bot Token Scopes’ları ekleyin:

app_mentions:read
channels:history
channels:read
chat:write
files:read
files:write
groups:history
groups:read
im:history
im:read
im:write
mpim:history
mpim:read
mpim:write
reactions:read
reactions:write
users:read

Çalışma Alanına Kur

1. “Install to Workspace"e tıklayın
2. Yetkileri onaylayın
3. Bot User OAuth Token‘ı kopyalayın (xoxb- ile başlar)

Yapılandırma Örneği

{
  "channels": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "signingSecret": "..."
    }
  }
}

Socket Mode’u Etkinleştir (Önerilir)

1. “Socket Mode” sayfasında etkinleştirin
2. App-Level Token oluşturun
3. OpenClaw’a yapılandırın:

{
  "channels": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "socketMode": true
    }
  }
}

Çoklu Kanal Eş Zamanlı Etkinleştirme

Tam Yapılandırma Örneği

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback"
  },
  "channels": {
    "telegram": {
      "botToken": "telegram_bot_token",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"]
    },
    "discord": {
      "token": "discord_token",
      "guilds": {
        "*": { "requireMention": true }
      }
    },
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

Mesaj Yönlendirme Şeması

flowchart TB
    subgraph Users["Kullanıcılar"]
        WA[WhatsApp Kullanıcısı]
        TG[Telegram Kullanıcısı]
        DC[Discord Kullanıcısı]
        SL[Slack Kullanıcısı]
    end
    
    subgraph Gateway["Gateway"]
        MR[Mesaj Yönlendiricisi]
        SM[Oturum Yöneticisi]
    end
    
    subgraph Agent["Pi Agent"]
        AI[AI Çekirdeği]
        CTX[Paylaşımlı Bağlam]
    end
    
    WA --> MR
    TG --> MR
    DC --> MR
    SL --> MR
    MR --> SM
    SM --> AI
    AI --> CTX

Tüm kanallar aynı Agent’ı paylaşır, bağlam birleşik olarak yönetilir. Bu şu anlama gelir:

• Telegram’da sorulan soruya WhatsApp’ta devam edilebilir
• Farklı kanallardaki kullanıcılar aynı belleği paylaşabilir
• Her kanal bağımsız oturum izolasyon politikasına sahip olabilir

Oturum Yönetim Komutları

Tüm kanallar için geçerli komutlar (sohbette gönderin):

Sorun Giderme

Telegram Bot Yanıt Vermiyor

Belirti: Mesaj gönderdikten sonra yanıt yok

Sorun Giderme Adımları:

# 1. Gateway'in çalışıp çalışmadığını kontrol et
curl http://127.0.0.1:18789/health

# 2. Bot Token'ı kontrol et
openclaw config get channels.telegram.botToken

# 3. Ayrıntılı günlükleri görüntüle
openclaw gateway --verbose

# 4. Tanılama yap
openclaw doctor

Yaygın Nedenler:

WhatsApp QR Kod Tarama Başarısız

Belirti: Tarama sonrası başarısızlık gösteriliyor

Çözüm:

# QR kodu yeniden oluştur
openclaw channels logout whatsapp
openclaw channels login whatsapp

# Ağı kontrol et
ping web.whatsapp.com

# Kimlik bilgisi önbelleğini temizle
rm -rf ~/.openclaw/credentials/whatsapp*

Discord Bot Yetki Yok

Belirti: Bot sunucuda yanıt vermiyor veya yetkisi yok

Çözüm:

1. Bot rol yetkilerini kontrol edin
2. Bot’un sunucuya davet edildiğini onaylayın
3. Bot’u yeniden davet edin (doğru OAuth URL ile)

# Günlüklerdeki yetki hatalarını görüntüle
openclaw gateway --verbose 2>&1 | grep -i permission

Yapılandırma Etkili Olmuyor

Belirti: Yapılandırma değişikliği sonrası davranış değişmedi

Çözüm:

# 1. Gateway'i yeniden başlat
openclaw gateway --restart

# 2. Önbelleği temizle
rm -rf ~/.openclaw/cache/*

# 3. Yapılandırma dosyası sözdizimini doğrula
cat ~/.openclaw/openclaw.json | jq .

# 4. Yapılandırma önceliğini kontrol et
openclaw config list

Güvenlik En İyi Uygulamaları

1. Token Güvenliği

# Token'ı sürüm kontrolüne göndermeyin
echo ".openclaw/" >> .gitignore

# Hassas bilgileri ortam değişkenlerinde saklayın
export TELEGRAM_BOT_TOKEN="your_token"

# Token'ı düzenli olarak yenileyin (BotFather'da)
# /revoke komutu ile Token yeniden oluşturulabilir

2. Erişim Kontrolü

{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing",
      "allowFrom": [],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  },
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

3. Günlük Denetimi

# Ayrıntılı günlükleri etkinleştir
openclaw gateway --verbose

# Oturum geçmişini görüntüle
openclaw sessions list
openclaw sessions show <session-id>

# Komut yürütmesini denetle
grep "bash" ~/.openclaw/logs/gateway.log

Sonraki Adım

Tebrikler! İlk kanal yapılandırmasını tamamladınız. Şimdi şunları yapabilirsiniz:

1. Sohbeti test et → Yapılandırılmış kanalda mesaj gönderin
2. Skills kur → AI yeteneklerini genişletin
3. Çoklu kanal yapılandır → Daha fazla kanal ekleyin

Bu Bölümün Özeti:

• Telegram Bot oluşturma ve yapılandırmayı öğrendiniz
• DM eşleştirme ve grup yapılandırmasını anladınız
• WhatsApp, Discord, Slack yapılandırma yöntemlerini öğrendiniz
• Çoklu kanalı aynı anda etkinleştirme yöntemini kavradınız
• Yaygın sorunların giderilmesini öğrendiniz

Güncelleme Kayıtları:

• 2026-02-26: İlk sürüm yayınlandı, OpenClaw v2026.2 temel alınmıştır

Seri Navigasyonu:

• ← Önceki makale: Ortam Kurulumu ve İlk Çalıştırma
• → Sonraki makale: Gateway Temel Kavramları