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

Kısa cevap. Telegram'da @BotFather ile bir bot oluştur (/newbot) ve token'ını kopyala. Token'ı OpenClaw'a ver, sonra ona yalnızca kendi sayısal Telegram kullanıcı ID'nin mesaj atmasına izin ver. Kendi makinende bu, openclaw channels add --channel telegram --token <token> artı allowFrom içinde ID'nle dmPolicy: "allowlist" demektir. PlayNHost'ta token'ı ve ID'ni Ajan sayfasında yapıştırıp yeniden başlatırsın.

6 Kasım 2026'da kontrol edildi, OpenClaw 2026.11.1 için doğrudur.

Bu rehber OpenClaw'ın Telegram belgelerini ve PlayNHost panelinin bugünkü işleyişini kullanır. Telegram OpenClaw'ın içinde gelir: kurulacak bir eklenti yok.

Adım 1: botu oluştur ve token'ını kopyala

1. Telegram'da @BotFather ile bir sohbet aç. Kullanıcı adının tam olarak @BotFather olduğunu kontrol et.
2. /newbot gönder, görünen bir ad seç, sonra bot ile biten bir kullanıcı adı seç.
3. BotFather, 123456789:AAH... gibi görünen token ile yanıt verir. Gizli tut: onu bilen herkes botunu yönetebilir.

BotFather'ın aynı işi düğmelerle yapan bir web uygulaması da var (t.me/BotFather?startapp).

Başka hiçbir şeyin çalıştırmadığı bir bot kullan. Dizüstündeki eski bir OpenClaw veya başka herhangi bir program hâlâ aynı token'ı kullanıyorsa önce onu durdur ya da yeni bir bot oluştur.

Adım 2: Telegram kullanıcı ID'ni bul

OpenClaw'ın izin listesi, @kullanıcıadını, telefon numaranı veya botun ID'sini değil, sayısal kullanıcı ID'ni ister. OpenClaw belgelerinin saydığı yollar:

• Botun kendisinden (üçüncü taraf yok). Bot pairing modundayken ona herhangi bir mesaj at. Eşleştirme yanıtında "Your Telegram user id" yazar. PlayNHost'ta önerdiğimiz yol budur, aşağıya bak.
• OpenClaw'ın günlüğünden. openclaw logs --follow çalıştır, bota mesaj at ve telegram pairing request kaydındaki senderUserId değerini oku.
• Telegram'ın kendi API'sinden. Bota mesaj at, sonra https://api.telegram.org/bot<bot_token>/getUpdates adresini aç ve message.from.id değerini oku.
• Üçüncü taraf bir bot, örneğin @userinfobot veya @getidsbot. OpenClaw belgeleri bunu daha az gizli olarak niteler.

PlayNHost'ta Adım 3: token'ı ve ID'ni yapıştır

Aynı sayfada bir yapay zeka sağlayıcı anahtarına da ihtiyacın var. Yoksa Başlat şu mesajla durur: "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token." (Ajanın henüz kurulmadı: bir yapay zeka sağlayıcısından API anahtarı ve bir Telegram veya Discord bot token'ı gerekiyor.)

1. Sunucunu panel.playnhost.com adresinde aç, sonra Ajan sekmesini aç.
2. Yapay zeka sağlayıcısı altında henüz yapmadıysan bir anahtar gir (bkz. OpenClaw ile hangi yapay zeka sağlayıcı anahtarı kullanılır).
3. Sohbet uygulamaları altında Telegram bot token’ı satırında Ayarla'ya bas, BotFather'daki token'ı yapıştır ve Kaydet'e bas. Panel biçimini kontrol eder; yanlış yapıştırırsan "That is not a valid telegram bot token." (Bu geçerli bir Telegram bot token'ı değil.) mesajını alırsın. Kaydedildikten sonra satırda yalnızca son dört karakter görünür ve token bir daha gösterilmez.
4. ID'ni henüz bilmiyor musun? Telegram kullanıcı ID’leri alanını boş bırak ve Başlat'a bas. Ajan ayağa kalkınca konsol şunu yazar:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Telegram'da botuna bir mesaj at. Bot bir kez, bir eşleştirme koduyla ve Telegram kullanıcı ID'nle yanıt verir (OpenClaw kişi başına yaklaşık saatte bir kod gönderir ve aradaki mesajları yok sayar). ID'yi kopyala ve kodu yok say: PlayNHost'ta onaylanacak bir şey yok. Bu adımla kimse içeri alınmaz.
5. Ona kim yazabilir altında, ID'ni Telegram kullanıcı ID’leri alanına yaz ve Kaydet'e bas. Birden fazla ID tek satıra, virgülle ayrılarak yazılır.
6. Sayfa şunu söyler: "Değişiklikler ajanınız bir sonraki başlatıldığında uygulanır." Şimdi yeniden başlat'a bas. Konsol bunu şöyle onaylar:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Botuna mesaj at. Ajanın yanıt verir. Başka Telegram hesaplarından gelen mesajlar yok sayılır.

PlayNHost senin için neleri ayarlar?

• Ajan sayfasında ID'ler varsa Telegram DM'leri tam olarak bu ID'lerle dmPolicy: "allowlist" kullanır; OpenClaw belgelerinin tek sahipli bir bot için önerdiği budur. ID yoksa pairing kullanır: yabancılar bir kod alır ve yok sayılır; OpenClaw'ın komut satırı veya panosu olmadan kimse onları onaylayamaz, bir PlayNHost sunucusu da bunların hiçbirini sunmaz.
• Listelediğin ID'ler aynı zamanda OpenClaw'ın komut sahipleri olur (commands.ownerAllowFrom); böylece yalnızca sahibe açık komutlar ilk mesajdan itibaren senin için çalışır.
• Token, OpenClaw'a ortamında TELEGRAM_BOT_TOKEN olarak ulaşır. OpenClaw'ın kendi ayar dosyasına yazılmış bir token bunun önüne geçerdi; bu yüzden başlatma onu dosyadan siler: kullanılan, Ajan sayfasındaki token'dır.
• Gruplar kapalı kalır: OpenClaw, ayarlarına eklenene kadar hiçbir gruba izin vermez ve herkesin ajanla konuşmasına izin veren bir ayar, bir sonraki başlatmada senin ID'lerine geri çevrilir.

Kendi makinende Adım 3

1. Token'ı ekle:

   openclaw channels add --channel telegram --token <bot-token>

   veya Gateway'in ortamında TELEGRAM_BOT_TOKEN ayarla. Yapılandırma dosyasındaki bir token, ortam değişkeninin önüne geçer.
2. ~/.openclaw/openclaw.json içinde yalnızca kendine izin ver:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   commands kısmı seni yalnızca sahibe açık komutlar için sahip yapar: OpenClaw bunu elle yazılmış bir izin listesi için yapmaz. Boş allowFrom ile bir allowlist her DM'yi engeller ve OpenClaw'ın yapılandırma kontrolü tarafından reddedilir.
3. Ya da varsayılan pairing modunu koru ve ilk mesajından sonra kendini onayla:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Kodların süresi bir saat sonra dolar. İlk onaylanan eşleştirme seni komut sahibi de yapar.
4. Kanalı openclaw channels status --probe ile kontrol et.

Yanıt vermediğinde

Discord'u da mı istiyorsun? OpenClaw'ı Discord'a bağlama yazısına bak. Henüz kurmadın mı? Bir OpenClaw sunucusu oluştur.

PlayNHost, OpenClaw Foundation ile bağlantılı değildir. OpenClaw, MIT lisansı altında açık kaynaklı bir yazılımdır.