Telegram

Telegram botları varsayılan olarak Gizlilik Modu kullanır; bu, gruplarda hangi mesajları alabileceklerini sınırlar.

Botun tüm grup mesajlarını görmesi gerekiyorsa:

• /setprivacy ile gizlilik modunu devre dışı bırakın veya
• botu grup yöneticisi yapın.

Gizlilik modunu değiştirirken, Telegram'ın değişikliği uygulaması için botu her gruptan kaldırıp yeniden ekleyin.

Yönetici durumu Telegram grup ayarlarında denetlenir.

Yönetici botlar tüm grup mesajlarını alır; bu, her zaman açık grup davranışı için kullanışlıdır.

• Grup eklemelerine izin vermek/reddetmek için /setjoingroups
• Grup görünürlüğü davranışı için /setprivacy

OpenClaw kısmi yanıtları gerçek zamanlı olarak akışa verebilir:

• doğrudan sohbetler: önizleme mesajı + editMessageText
• gruplar/konular: önizleme mesajı + editMessageText

Gereksinim:

• channels.telegram.streaming, off | partial | block | progress olur (varsayılan: partial)
• progress, araç ilerlemesi için düzenlenebilir tek bir durum taslağı tutar, tamamlandığında bunu temizler ve son yanıtı normal bir mesaj olarak gönderir
• streaming.preview.toolProgress, araç/ilerleme güncellemelerinin aynı düzenlenmiş önizleme mesajını yeniden kullanıp kullanmayacağını denetler (varsayılan: önizleme akışı etkinken true)
• streaming.preview.commandText, bu araç ilerleme satırlarının içindeki komut/çalıştırma ayrıntısını denetler: raw (varsayılan, yayımlanmış davranışı korur) veya status (yalnızca araç etiketi)
• eski channels.telegram.streamMode ve boolean streaming değerleri algılanır; bunları channels.telegram.streaming.mode değerine taşımak için openclaw doctor --fix çalıştırın

Araç ilerleme önizleme güncellemeleri, araçlar çalışırken gösterilen kısa durum satırlarıdır; örneğin komut yürütme, dosya okumaları, planlama güncellemeleri veya yama özetleri. Telegram, v2026.4.22 ve sonrasındaki yayımlanmış OpenClaw davranışıyla eşleşmesi için bunları varsayılan olarak etkin tutar. Yanıt metni için düzenlenen önizlemeyi koruyup araç ilerleme satırlarını gizlemek için şunu ayarlayın:

{  "channels": {    "telegram": {      "streaming": {        "mode": "partial",        "preview": {          "toolProgress": false        }      }    }  }}

Araç ilerlemesini görünür tutup komut/çalıştırma metnini gizlemek için şunu ayarlayın:

{  "channels": {    "telegram": {      "streaming": {        "mode": "partial",        "preview": {          "commandText": "status"        }      }    }  }}

Son yanıtı aynı mesaja düzenlemeden görünür araç ilerlemesi istediğinizde progress modunu kullanın. Komut metni politikasını streaming.progress altına koyun:

{  "channels": {    "telegram": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

streaming.mode: "off" değerini yalnızca sadece son yanıt teslimi istediğinizde kullanın: Telegram önizleme düzenlemeleri devre dışı bırakılır ve genel araç/ilerleme konuşmaları bağımsız durum mesajları olarak gönderilmek yerine bastırılır. Onay istemleri, medya yükleri ve hatalar yine de normal son teslim yolundan yönlendirilir. Yalnızca araç ilerleme durum satırlarını gizlerken yanıt önizleme düzenlemelerini korumak istediğinizde streaming.preview.toolProgress: false kullanın.

Yalnızca metin yanıtları için:

• kısa DM/grup/konu önizlemeleri: OpenClaw aynı önizleme mesajını tutar ve son düzenlemeyi yerinde yapar
• birden çok Telegram mesajına bölünen uzun metin son yanıtları, mümkün olduğunda mevcut önizlemeyi ilk son parça olarak yeniden kullanır, sonra yalnızca kalan parçaları gönderir
• ilerleme modu son yanıtları durum taslağını temizler ve taslağı yanıta düzenlemek yerine normal son teslimi kullanır
• tamamlanan metin doğrulanmadan önce son düzenleme başarısız olursa OpenClaw normal son teslimi kullanır ve bayat önizlemeyi temizler

Karmaşık yanıtlar için (örneğin medya yükleri), OpenClaw normal son teslime geri döner ve ardından önizleme mesajını temizler.

Önizleme akışı, blok akışından ayrıdır. Telegram için blok akışı açıkça etkinleştirildiğinde OpenClaw çift akışı önlemek için önizleme akışını atlar.

Yalnızca Telegram akıl yürütme akışı:

• /reasoning stream, oluşturma sırasında akıl yürütmeyi canlı önizlemeye gönderir
• akıl yürütme önizlemesi son teslimden sonra silinir; akıl yürütmenin görünür kalması gerektiğinde /reasoning on kullanın
• son yanıt, akıl yürütme metni olmadan gönderilir

Giden metin Telegram parse_mode: "HTML" kullanır.

• Markdown benzeri metin, Telegram açısından güvenli HTML'ye işlenir.
• Desteklenen Telegram HTML etiketleri korunur; desteklenmeyen HTML kaçışlanır.
• Telegram ayrıştırılmış HTML'yi reddederse OpenClaw düz metin olarak yeniden dener.

Bağlantı önizlemeleri varsayılan olarak etkindir ve channels.telegram.linkPreview: false ile devre dışı bırakılabilir.

Telegram komut menüsü kaydı, başlangıçta setMyCommands ile işlenir.

Yerel komut varsayılanları:

• commands.native: "auto", Telegram için yerel komutları etkinleştirir

Özel komut menüsü girdileri ekleyin:

{channels: {telegram: {  customCommands: [    { command: "backup", description: "Git backup" },    { command: "generate", description: "Create an image" },  ],},},}

Kurallar:

• adlar normalleştirilir (başındaki / kaldırılır, küçük harfe çevrilir)
• geçerli kalıp: a-z, 0-9, _, uzunluk 1..32
• özel komutlar yerel komutları geçersiz kılamaz
• çakışmalar/çoğaltmalar atlanır ve günlüğe kaydedilir

Notlar:

• özel komutlar yalnızca menü girdileridir; davranışı otomatik olarak uygulamazlar
• Plugin/skill komutları, Telegram menüsünde gösterilmese bile yazıldığında çalışmaya devam edebilir

Yerel komutlar devre dışı bırakılırsa yerleşikler kaldırılır. Özel/Plugin komutları, yapılandırılmışsa yine de kaydolabilir.

Yaygın kurulum hataları:

• BOT_COMMANDS_TOO_MUCH ile setMyCommands failed, Telegram menüsünün kırpmadan sonra hâlâ taştığı anlamına gelir; Plugin/skill/özel komutları azaltın veya channels.telegram.commands.native ayarını devre dışı bırakın.
• Doğrudan Bot API curl komutları çalışırken deleteWebhook, deleteMyCommands veya setMyCommands işlemlerinin 404: Not Found ile başarısız olması, channels.telegram.apiRoot değerinin tam /bot<TOKEN> uç noktasına ayarlandığı anlamına gelebilir. apiRoot yalnızca Bot API kökü olmalıdır ve openclaw doctor --fix yanlışlıkla eklenmiş sondaki /bot<TOKEN> bölümünü kaldırır.
• getMe returned 401, Telegram'ın yapılandırılmış bot token'ını reddettiği anlamına gelir. botToken, tokenFile veya TELEGRAM_BOT_TOKEN değerini güncel BotFather token'ı ile güncelleyin; OpenClaw yoklamadan önce durur, bu nedenle bu bir Webhook temizleme hatası olarak bildirilmez.
• Ağ/fetch hatalarıyla setMyCommands failed genellikle api.telegram.org adresine giden DNS/HTTPS'in engellendiği anlamına gelir.

Cihaz eşleştirme komutları (device-pair Plugin'i)

device-pair Plugin'i yüklü olduğunda:

1. /pair kurulum kodu üretir
2. kodu iOS uygulamasına yapıştırın
3. /pair pending bekleyen istekleri listeler (rol/kapsamlar dahil)
4. isteği onaylayın:
   • açık onay için /pair approve <requestId>
   • yalnızca bir bekleyen istek olduğunda /pair approve
   • en yenisi için /pair approve latest

Kurulum kodu kısa ömürlü bir bootstrap token taşır. Yerleşik bootstrap devri, birincil node token'ını scopes: [] konumunda tutar; devredilen herhangi bir operatör token'ı operator.approvals, operator.read, operator.talk.secrets ve operator.write ile sınırlı kalır. Bootstrap kapsam denetimleri rol öneklidir; bu yüzden bu operatör izin listesi yalnızca operatör isteklerini karşılar; operatör olmayan rollerin hâlâ kendi rol önekleri altında kapsamlara ihtiyacı vardır.

Bir cihaz değişmiş kimlik doğrulama ayrıntılarıyla yeniden denerse (örneğin rol/kapsamlar/açık anahtar), önceki bekleyen istek geçersiz kılınır ve yeni istek farklı bir requestId kullanır. Onaylamadan önce /pair pending komutunu yeniden çalıştırın.

Daha fazla ayrıntı: Eşleştirme.

Satır içi klavye kapsamını yapılandırın:

{channels: {telegram: {  capabilities: {    inlineButtons: "allowlist",  },},},}

Hesap başına geçersiz kılma:

{channels: {telegram: {  accounts: {    main: {      capabilities: {        inlineButtons: "allowlist",      },    },  },},},}

Kapsamlar:

• off
• dm
• group
• all
• allowlist (varsayılan)

Eski capabilities: ["inlineButtons"], inlineButtons: "all" değerine eşlenir.

Mesaj eylemi örneği:

{action: "send",channel: "telegram",to: "123456789",message: "Choose an option:",buttons: [[  { text: "Yes", callback_data: "yes" },  { text: "No", callback_data: "no" },],[{ text: "Cancel", callback_data: "cancel" }],],}

Geri çağırma tıklamaları aracıya metin olarak geçirilir: callback_data: <value>

Telegram araç eylemleri şunları içerir:

• sendMessage (to, content, isteğe bağlı mediaUrl, replyToMessageId, messageThreadId)
• react (chatId, messageId, emoji)
• deleteMessage (chatId, messageId)
• editMessage (chatId, messageId, content)
• createForumTopic (chatId, name, isteğe bağlı iconColor, iconCustomEmojiId)

Kanal mesaj eylemleri ergonomik takma adlar sunar (send, react, delete, edit, sticker, sticker-search, topic-create).

Kapılama denetimleri:

• channels.telegram.actions.sendMessage
• channels.telegram.actions.deleteMessage
• channels.telegram.actions.reactions
• channels.telegram.actions.sticker (varsayılan: devre dışı)

Not: edit ve topic-create şu anda varsayılan olarak etkindir ve ayrı channels.telegram.actions.* anahtarları yoktur. Çalışma zamanı gönderimleri etkin yapılandırma/gizli bilgiler anlık görüntüsünü kullanır (başlangıç/yeniden yükleme), bu yüzden eylem yolları gönderim başına anlık SecretRef yeniden çözümlemesi yapmaz.

Tepki kaldırma semantiği: /tools/reactions

Telegram, oluşturulan çıktıda açık yanıt dizilimi etiketlerini destekler:

• [[reply_to_current]] tetikleyen mesaja yanıt verir
• [[reply_to:<id>]] belirli bir Telegram mesaj kimliğine yanıt verir

channels.telegram.replyToMode işlemeyi denetler:

• off (varsayılan)
• first
• all

Yanıt dizilimi etkinleştirildiğinde ve özgün Telegram metni veya açıklaması kullanılabilir olduğunda, OpenClaw otomatik olarak yerel bir Telegram alıntı parçası ekler. Telegram yerel alıntı metnini 1024 UTF-16 kod birimiyle sınırlar; bu nedenle daha uzun mesajlar baştan alıntılanır ve Telegram alıntıyı reddederse düz yanıta geri döner.

Not: off, örtük yanıt dizilimini devre dışı bırakır. Açık [[reply_to_*]] etiketleri yine de dikkate alınır.

Forum süper grupları:

• konu oturumu anahtarları :topic:<threadId> ekler
• yanıtlar ve yazıyor eylemi konu ileti dizisini hedefler
• konu yapılandırma yolu: channels.telegram.groups.<chatId>.topics.<threadId>

Genel konu (threadId=1) özel durumu:

• mesaj gönderimleri message_thread_id öğesini çıkarır (Telegram sendMessage(...thread_id=1) çağrısını reddeder)
• yazıyor eylemleri yine de message_thread_id içerir

Konu mirası: konu girdileri, geçersiz kılınmadıkça grup ayarlarını devralır (requireMention, allowFrom, skills, systemPrompt, enabled, groupPolicy). agentId yalnızca konuya özeldir ve grup varsayılanlarından devralınmaz.

Konu başına aracı yönlendirme: Her konu, konu yapılandırmasında agentId ayarlanarak farklı bir aracıya yönlendirilebilir. Bu, her konuya kendi yalıtılmış çalışma alanını, belleğini ve oturumunu verir. Örnek:

{  channels: {    telegram: {      groups: {        "-1001234567890": {          topics: {            "1": { agentId: "main" },      // General topic → main agent            "3": { agentId: "zu" },        // Dev topic → zu agent            "5": { agentId: "coder" }      // Code review → coder agent          }        }      }    }  }}

Ardından her konu kendi oturum anahtarına sahip olur: agent:zu:telegram:group:-1001234567890:topic:3

Kalıcı ACP konu bağlama: Forum konuları, üst düzey türlendirilmiş ACP bağlamaları aracılığıyla ACP harness oturumlarını sabitleyebilir (type: "acp" ve match.channel: "telegram", peer.kind: "group" içeren bindings[] ve -1001234567890:topic:42 gibi konu nitelemeli bir kimlik). Şu anda gruplardaki/süper gruplardaki forum konularıyla sınırlıdır. Bkz. ACP Aracıları.

Sohbetten iş parçacığına bağlı ACP başlatma: /acp spawn <agent> --thread here|auto mevcut konuyu yeni bir ACP oturumuna bağlar; devam iletileri doğrudan oraya yönlendirilir. OpenClaw başlatma onayını konu içinde sabitler. channels.telegram.threadBindings.spawnSessions etkin kalmalıdır (varsayılan: true).

Şablon bağlamı MessageThreadId ve IsForum değerlerini açığa çıkarır. message_thread_id içeren DM sohbetleri varsayılan olarak DM yönlendirmesini ve yanıt meta verilerini düz oturumlarda tutar; iş parçacığına duyarlı oturum anahtarlarını yalnızca threadReplies: "inbound", threadReplies: "always", requireTopic: true veya eşleşen bir konu yapılandırmasıyla yapılandırıldıklarında kullanırlar. Hesap varsayılanı için üst düzey channels.telegram.dm.threadReplies değerini veya tek bir DM için direct.<chatId>.threadReplies değerini kullanın.

Ses mesajları

Telegram, sesli notlar ile ses dosyalarını ayırt eder.

• varsayılan: ses dosyası davranışı
• sesli not gönderimini zorlamak için aracı yanıtında [[audio_as_voice]] etiketi
• gelen sesli not dökümleri, aracı bağlamında makine tarafından üretilmiş, güvenilmeyen metin olarak çerçevelenir; bahsetme algılama yine de ham dökümü kullanır, böylece bahsetme kapılı sesli mesajlar çalışmaya devam eder.

Mesaj eylemi örneği:

{action: "send",channel: "telegram",to: "123456789",media: "https://example.com/voice.ogg",asVoice: true,}

Video mesajları

Telegram, video dosyaları ile video notlarını ayırt eder.

Mesaj eylemi örneği:

{action: "send",channel: "telegram",to: "123456789",media: "https://example.com/video.mp4",asVideoNote: true,}

Video notları altyazıları desteklemez; sağlanan mesaj metni ayrı olarak gönderilir.

Çıkartmalar

Gelen çıkartma işleme:

• statik WEBP: indirilir ve işlenir (yer tutucu <media:sticker>)
• animasyonlu TGS: atlanır
• video WEBM: atlanır

Çıkartma bağlam alanları:

• Sticker.emoji
• Sticker.setName
• Sticker.fileId
• Sticker.fileUniqueId
• Sticker.cachedDescription

Çıkartma önbellek dosyası:

• ~/.openclaw/telegram/sticker-cache.json

Çıkartmalar bir kez açıklanır (mümkün olduğunda) ve yinelenen görsel çağrılarını azaltmak için önbelleğe alınır.

Çıkartma eylemlerini etkinleştirin:

{channels: {telegram: {  actions: {    sticker: true,  },},},}

Çıkartma gönderme eylemi:

{action: "sticker",channel: "telegram",to: "123456789",fileId: "CAACAgIAAxkBAAI...",}

Önbelleğe alınmış çıkartmaları arayın:

{action: "sticker-search",channel: "telegram",query: "cat waving",limit: 5,}

Telegram tepkileri message_reaction güncellemeleri olarak gelir (mesaj yüklerinden ayrıdır).

Etkinleştirildiğinde OpenClaw şu tür sistem olaylarını kuyruğa alır:

• Telegram reaction added: 👍 by Alice (@alice) on msg 42

Yapılandırma:

• channels.telegram.reactionNotifications: off | own | all (varsayılan: own)
• channels.telegram.reactionLevel: off | ack | minimal | extensive (varsayılan: minimal)

Notlar:

• own, yalnızca bot tarafından gönderilen mesajlara kullanıcı tepkileri anlamına gelir (gönderilen mesaj önbelleği üzerinden en iyi çaba).
• Tepki olayları yine de Telegram erişim kontrollerine uyar (dmPolicy, allowFrom, groupPolicy, groupAllowFrom); yetkisiz gönderenler düşürülür.
• Telegram, tepki güncellemelerinde iş parçacığı kimlikleri sağlamaz.
  • forum olmayan gruplar grup sohbeti oturumuna yönlendirilir
  • forum grupları, tam kaynak konuya değil, grubun genel konu oturumuna (:topic:1) yönlendirilir

Yoklama/Webhook için allowed_updates otomatik olarak message_reaction içerir.

ackReaction, OpenClaw gelen bir mesajı işlerken bir onay emojisi gönderir.

Çözümleme sırası:

• channels.telegram.accounts.<accountId>.ackReaction
• channels.telegram.ackReaction
• messages.ackReaction
• aracı kimliği emoji yedeği (agents.list[].identity.emoji, aksi halde "👀")

Notlar:

• Telegram unicode emoji bekler (örneğin "👀").
• Bir kanal veya hesap için tepkiyi devre dışı bırakmak üzere "" kullanın.

Kanal yapılandırma yazımları varsayılan olarak etkindir (configWrites !== false).

Telegram tarafından tetiklenen yazımlar şunları içerir:

• channels.telegram.groups değerini güncellemek için grup taşıma olayları (migrate_to_chat_id)
• /config set ve /config unset (komut etkinleştirmesi gerektirir)

Devre dışı bırakma:

{channels: {telegram: {  configWrites: false,},},}

Varsayılan uzun yoklamadır. Webhook modu için channels.telegram.webhookUrl ve channels.telegram.webhookSecret değerlerini ayarlayın; isteğe bağlı olarak webhookPath, webhookHost, webhookPort (varsayılanlar /telegram-webhook, 127.0.0.1, 8787).

Uzun yoklama modunda OpenClaw, yeniden başlatma filigranını yalnızca bir güncelleme başarıyla dağıtıldıktan sonra kalıcı hale getirir. Bir işleyici başarısız olursa bu güncelleme aynı süreçte yeniden denenebilir durumda kalır ve yeniden başlatma tekilleştirmesi için tamamlanmış olarak yazılmaz.

Yerel dinleyici 127.0.0.1:8787 adresine bağlanır. Genel giriş için yerel bağlantı noktasının önüne bir ters proxy koyun veya bilinçli olarak webhookHost: "0.0.0.0" ayarlayın.

Webhook modu, Telegram'a 200 döndürmeden önce istek korumalarını, Telegram gizli belirtecini ve JSON gövdesini doğrular. OpenClaw ardından güncellemeyi uzun yoklamanın kullandığı aynı sohbet başına/konu başına bot hatları üzerinden eşzamansız olarak işler; böylece yavaş aracı dönüşleri Telegram'ın teslim ACK değerini bekletmez.

• channels.telegram.textChunkLimit varsayılanı 4000'dir.
• channels.telegram.chunkMode="newline", uzunluğa göre bölmeden önce paragraf sınırlarını (boş satırlar) tercih eder.
• channels.telegram.mediaMaxMb (varsayılan 100), gelen ve giden Telegram medya boyutunu sınırlar.
• channels.telegram.mediaGroupFlushMs (varsayılan 500), OpenClaw bunları tek bir gelen mesaj olarak dağıtmadan önce Telegram albümlerinin/medya gruplarının ne kadar süre arabelleğe alınacağını denetler. Albüm parçaları geç geliyorsa artırın; albüm yanıt gecikmesini azaltmak için düşürün.
• channels.telegram.timeoutSeconds, Telegram API istemcisi zaman aşımını geçersiz kılar (ayarlanmazsa grammY varsayılanı geçerlidir). Bot istemcileri, yapılandırılan değerleri 60 saniyelik giden metin/yazıyor isteği korumasının altına sıkıştırır; böylece grammY, OpenClaw'ın aktarım koruması ve yedeği çalışmadan önce görünür yanıt teslimini iptal etmez. Uzun yoklama yine de 45 saniyelik getUpdates isteği koruması kullanır, böylece boşta yoklamalar süresiz olarak terk edilmez.
• channels.telegram.pollingStallThresholdMs varsayılan olarak 120000 değerindedir; yalnızca yanlış pozitif yoklama-durması yeniden başlatmaları için 30000 ile 600000 arasında ayarlayın.
• grup bağlam geçmişi channels.telegram.historyLimit veya messages.groupChat.historyLimit kullanır (varsayılan 50); 0 devre dışı bırakır.
• yanıt/alıntı/iletme ek bağlamı, Gateway üst mesajları gözlemlediğinde seçili tek bir konuşma bağlam penceresine normalleştirilir; gözlemlenen mesaj önbelleği oturum deposunun yanında kalıcı hale getirilir. Telegram güncellemelerde yalnızca tek bir sığ reply_to_message içerir; bu nedenle önbellekten daha eski zincirler Telegram'ın mevcut güncelleme yüküyle sınırlıdır.
• Telegram izin listeleri öncelikle aracıyı kimin tetikleyebileceğini kapılar; tam bir ek bağlam redaksiyon sınırı değildir.
• DM geçmiş denetimleri:
  • channels.telegram.dmHistoryLimit
  • channels.telegram.dms["<user_id>"].historyLimit
• channels.telegram.retry yapılandırması, kurtarılabilir giden API hataları için Telegram gönderme yardımcılarına (CLI/araçlar/eylemler) uygulanır. Gelen son-yanıt teslimi de Telegram ön bağlantı hataları için sınırlı bir güvenli-gönder yeniden denemesi kullanır, ancak görünür mesajları çoğaltabilecek belirsiz gönderim sonrası ağ zarflarını yeniden denemez.

CLI ve mesaj aracı gönderme hedefleri sayısal sohbet kimliği, kullanıcı adı veya bir forum konusu hedefi olabilir:

openclaw message send --channel telegram --target 123456789 --message "hi"openclaw message send --channel telegram --target @name --message "hi"openclaw message send --channel telegram --target -1001234567890:topic:42 --message "hi topic"

Telegram yoklamaları openclaw message poll kullanır ve forum konularını destekler:

openclaw message poll --channel telegram --target 123456789 \--poll-question "Ship it?" --poll-option "Yes" --poll-option "No"openclaw message poll --channel telegram --target -1001234567890:topic:42 \--poll-question "Pick a time" --poll-option "10am" --poll-option "2pm" \--poll-duration-seconds 300 --poll-public

Yalnızca Telegram'a özgü yoklama bayrakları:

• --poll-duration-seconds (5-600)
• --poll-anonymous
• --poll-public
• forum konuları için --thread-id (veya bir :topic: hedefi kullanın)

Telegram gönderimi ayrıca şunları destekler:

• channels.telegram.capabilities.inlineButtons izin verdiğinde satır içi klavyeler için buttons bloklarıyla --presentation
• bot o sohbette sabitleyebildiğinde sabitlenmiş teslim istemek için --pin veya --delivery '{"pin":true}'
• giden görüntüleri, GIF'leri ve videoları sıkıştırılmış fotoğraf, animasyonlu medya veya video yüklemeleri yerine belge olarak göndermek için --force-document

Eylem kapılama:

• channels.telegram.actions.sendMessage=false, yoklamalar dahil giden Telegram mesajlarını devre dışı bırakır
• channels.telegram.actions.poll=false, normal gönderimleri etkin bırakarak Telegram yoklaması oluşturmayı devre dışı bırakır

Telegram, onaylayıcı DM'lerinde exec onaylarını destekler ve isteğe bağlı olarak istemleri kaynak sohbet veya konuya gönderebilir. Onaylayıcılar sayısal Telegram kullanıcı kimlikleri olmalıdır.

Yapılandırma yolu:

• channels.telegram.execApprovals.enabled (en az bir onaylayıcı çözümlenebilir olduğunda otomatik etkinleşir)
• channels.telegram.execApprovals.approvers (commands.ownerAllowFrom içindeki sayısal sahip kimliklerine geri döner)
• channels.telegram.execApprovals.target: dm (varsayılan) | channel | both
• agentFilter, sessionFilter

channels.telegram.allowFrom, groupAllowFrom ve defaultTo, botla kimin konuşabileceğini ve normal yanıtları nereye göndereceğini denetler. Birini exec onaylayıcısı yapmazlar. Henüz komut sahibi yoksa ilk onaylanmış DM eşleştirmesi commands.ownerAllowFrom değerini önyükler; böylece tek sahipli kurulum, execApprovals.approvers altında kimlikleri çoğaltmadan çalışmaya devam eder.

Kanal teslimi komut metnini sohbette gösterir; channel veya both değerlerini yalnızca güvenilen gruplarda/konularda etkinleştirin. İstem bir forum konusuna ulaştığında OpenClaw, onay istemi ve devam iletisi için konuyu korur. Exec onayları varsayılan olarak 30 dakika sonra sona erer.

Satır içi onay düğmeleri ayrıca hedef yüzeye (dm, group veya all) izin vermesi için channels.telegram.capabilities.inlineButtons gerektirir. plugin: önekli onay kimlikleri Plugin onayları üzerinden çözümlenir; diğerleri önce exec onayları üzerinden çözümlenir.

Bkz. Exec onayları.

• requireMention=false ise Telegram gizlilik modu tam görünürlüğe izin vermelidir.
  • BotFather: /setprivacy -> Devre dışı bırak
  • ardından botu gruptan kaldırıp yeniden ekleyin
• Yapılandırma etiketsiz grup mesajları beklediğinde openclaw channels status uyarır.
• openclaw channels status --probe açık sayısal grup kimliklerini denetleyebilir; joker karakter "*" için üyelik yoklaması yapılamaz.
• hızlı oturum testi: /activation always.

• channels.telegram.groups varsa grup listelenmelidir (veya "*" dahil edilmelidir)
• botun gruptaki üyeliğini doğrulayın
• atlama nedenleri için günlükleri inceleyin: openclaw logs --follow

• gönderen kimliğinizi yetkilendirin (eşleştirme ve/veya sayısal allowFrom)
• grup ilkesi open olsa bile komut yetkilendirmesi yine de geçerlidir
• BOT_COMMANDS_TOO_MUCH ile setMyCommands failed, yerel menüde çok fazla giriş olduğu anlamına gelir; Plugin/skill/özel komutlarını azaltın veya yerel menüleri devre dışı bırakın
• Başlangıçtaki deleteMyCommands / setMyCommands çağrıları ve sendChatAction yazıyor çağrıları sınırlandırılır ve istek zaman aşımında Telegram'ın aktarım yedeği üzerinden bir kez yeniden denenir. Kalıcı ağ/fetch hataları genellikle api.telegram.org için DNS/HTTPS erişilebilirliği sorunlarını gösterir

• getMe returned 401, yapılandırılmış bot token'ı için bir Telegram kimlik doğrulama hatasıdır.
• BotFather içinde bot token'ını yeniden kopyalayın veya yeniden oluşturun, ardından varsayılan hesap için channels.telegram.botToken, channels.telegram.tokenFile, channels.telegram.accounts.<id>.botToken veya TELEGRAM_BOT_TOKEN değerini güncelleyin.
• Başlangıç sırasında deleteWebhook 401 Unauthorized da bir kimlik doğrulama hatasıdır; bunu "webhook yok" olarak ele almak, aynı hatalı token hatasını yalnızca sonraki API çağrılarına ertelemiş olur.

• Node 22+ + özel fetch/proxy, AbortSignal türleri uyuşmuyorsa anında abort davranışını tetikleyebilir.
• Bazı host'lar api.telegram.org adresini önce IPv6'ya çözer; bozuk IPv6 çıkışı aralıklı Telegram API hatalarına neden olabilir.
• Günlüklerde TypeError: fetch failed veya Network request for 'getUpdates' failed! varsa OpenClaw artık bunları kurtarılabilir ağ hataları olarak yeniden dener.
• Polling başlangıcı sırasında OpenClaw, başarılı başlangıç getMe yoklamasını grammY için yeniden kullanır; böylece runner ilk getUpdates öncesinde ikinci bir getMe çağrısına ihtiyaç duymaz.
• Polling başlangıcı sırasında deleteWebhook geçici bir ağ hatasıyla başarısız olursa OpenClaw başka bir polling öncesi kontrol düzlemi çağrısı yapmak yerine long polling'e devam eder. Hâlâ etkin olan bir webhook, getUpdates çakışması olarak görünür; OpenClaw ardından Telegram aktarımını yeniden oluşturur ve webhook temizliğini yeniden dener.
• Telegram soketleri kısa ve sabit bir aralıkla yenileniyorsa düşük bir channels.telegram.timeoutSeconds değeri olup olmadığını kontrol edin; bot istemcileri, yapılandırılmış değerleri giden istek ve getUpdates istek korumalarının altına düşmeyecek şekilde sınırlar, ancak eski sürümler bu değerler bu korumaların altındayken her polling veya yanıtı abort edebiliyordu.
• Günlüklerde Polling stall detected varsa OpenClaw varsayılan olarak 120 saniye boyunca tamamlanmış long-poll canlılığı olmadan polling'i yeniden başlatır ve Telegram aktarımını yeniden oluşturur.
• openclaw channels status --probe ve openclaw doctor, çalışan bir polling hesabı başlangıç toleransından sonra getUpdates tamamlamadığında, çalışan bir webhook hesabı başlangıç toleransından sonra setWebhook tamamlamadığında veya son başarılı polling aktarım etkinliği bayatladığında uyarır.
• channels.telegram.pollingStallThresholdMs değerini yalnızca uzun süren getUpdates çağrıları sağlıklıyken ancak host'unuz hâlâ yanlış polling-stall yeniden başlatmaları bildiriyorsa artırın. Kalıcı takılmalar genellikle host ile api.telegram.org arasındaki proxy, DNS, IPv6 veya TLS çıkış sorunlarına işaret eder.
• Telegram ayrıca Bot API aktarımı için HTTP_PROXY, HTTPS_PROXY, ALL_PROXY ve bunların küçük harfli varyantları dahil işlem proxy env değerlerini dikkate alır. NO_PROXY / no_proxy yine de api.telegram.org adresini atlayabilir.
• OpenClaw yönetimli proxy bir hizmet ortamı için OPENCLAW_PROXY_URL üzerinden yapılandırılmışsa ve standart proxy env yoksa Telegram da Bot API aktarımı için bu URL'yi kullanır.
• Kararsız doğrudan çıkış/TLS bulunan VPS host'larında Telegram API çağrılarını channels.telegram.proxy üzerinden yönlendirin:

channels:telegram:proxy: socks5://<user>:<password>@proxy-host:1080

• Node 22+ varsayılan olarak autoSelectFamily=true kullanır (WSL2 hariç). Telegram DNS sonuç sırası önce OPENCLAW_TELEGRAM_DNS_RESULT_ORDER, sonra channels.telegram.network.dnsResultOrder, sonra NODE_OPTIONS=--dns-result-order=ipv4first gibi işlem varsayılanını izler; hiçbiri geçerli değilse Node 22+ ipv4first değerine geri döner.
• Host'unuz WSL2 ise veya açıkça yalnızca IPv4 davranışıyla daha iyi çalışıyorsa aile seçimini zorlayın:

channels:telegram:network:  autoSelectFamily: false

• RFC 2544 kıyaslama aralığı yanıtlarına (198.18.0.0/15) Telegram medya indirmeleri için varsayılan olarak zaten izin verilir. Güvenilir bir fake-IP veya saydam proxy, medya indirmeleri sırasında api.telegram.org adresini başka bir private/internal/special-use adrese yeniden yazıyorsa yalnızca Telegram için geçerli bypass'a katılabilirsiniz:

channels:telegram:network:  dangerouslyAllowPrivateNetwork: true

• Aynı katılım hesap başına channels.telegram.accounts.<accountId>.network.dangerouslyAllowPrivateNetwork altında da kullanılabilir.
• Proxy'niz Telegram medya host'larını 198.18.x.x içine çözüyorsa önce tehlikeli bayrağı kapalı bırakın. Telegram medyası zaten varsayılan olarak RFC 2544 kıyaslama aralığına izin verir.

• Ortam geçersiz kılmaları (geçici):
  • OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=1
  • OPENCLAW_TELEGRAM_ENABLE_AUTO_SELECT_FAMILY=1
  • OPENCLAW_TELEGRAM_DNS_RESULT_ORDER=ipv4first
• DNS yanıtlarını doğrulayın:

dig +short api.telegram.org Adig +short api.telegram.org AAAA