Telegram

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

• /setjoingroups — gruplara eklemeye izin ver/reddet
• /setprivacy — grup görünürlüğü davranışı

• channels.telegram.streaming, off | partial | block | progress değerindedir (varsayılan: partial)
• kısa ilk yanıt önizlemelerine geri sekme uygulanır; ardından çalıştırma hâlâ etkinse sınırlı bir gecikmeden sonra somutlaştırılır
• progress, araç ilerlemesi için düzenlenebilir tek bir durum taslağını korur; yanıt etkinliği araç ilerlemesinden önce geldiğinde kararlı durum etiketini gösterir, tamamlandığında taslağı temizler ve son yanıtı normal bir ileti olarak gönderir
• streaming.preview.toolProgress, araç/ilerleme güncellemelerinin aynı düzenlenmiş önizleme iletisini yeniden kullanıp kullanmayacağını denetler (varsayılan: önizleme akışı etkinken true)
• streaming.preview.commandText, bu satırlardaki komut/yürütme ayrıntısını denetler: raw (varsayılan) veya status (yalnızca araç etiketi)
• streaming.progress.commentary (varsayılan: false), geçici ilerleme taslağında asistan açıklaması/giriş metnini etkinleştirir
• eski channels.telegram.streamMode, mantıksal streaming değerleri ve kullanımdan kaldırılmış yerel taslak önizleme anahtarları algılanır; bunları taşımak için openclaw doctor --fix çalıştırın

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

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

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

{
  channels: {
    telegram: {
      customCommands: [
        { command: "backup", description: "Git yedeklemesi" },
        { command: "generate", description: "Görsel oluştur" },
      ],
    },
  },
}

• Kırpma yeniden denemesinden sonra BOT_COMMANDS_TOO_MUCH içeren setMyCommands failed, menünün hâlâ sınırı aştığı anlamına gelir; Plugin/skill/özel komutları azaltın veya channels.telegram.commands.native özelliğini devre dışı bırakın.
• Doğrudan Bot API curl komutları çalışırken deleteWebhook, deleteMyCommands veya setMyCommands işleminin 404: Not Found ile başarısız olması genellikle channels.telegram.apiRoot değerinin tam /bot<TOKEN> uç noktasına ayarlandığı anlamına gelir. apiRoot yalnızca Bot API kökü olmalıdır; 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ılan bot belirtecini reddettiği anlamına gelir. botToken, tokenFile veya TELEGRAM_BOT_TOKEN (varsayılan hesap) değerini geçerli BotFather belirteciyle güncelleyin; OpenClaw yoklamadan önce durduğu için bu durum Webhook temizleme hatası olarak bildirilmez.
• Ağ/getirme hataları içeren setMyCommands failed genellikle api.telegram.org adresine giden DNS/HTTPS trafiğinin engellendiği anlamına gelir.

​

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

1. /pair bir kurulum kodu oluşturur
2. kodu iOS uygulamasına yapıştırın
3. /pair pending bekleyen istekleri listeler (rol/kapsamlar dâhil)
4. onaylama: /pair approve <requestId>, /pair approve (yalnızca bekleyen istek) veya /pair approve latest

• sendMessage (to, content, isteğe bağlı mediaUrl, replyToMessageId, messageThreadId)
• react (chatId, messageId, emoji)
• deleteMessage (chatId, messageId)
• editMessage (chatId, messageId, content veya caption, isteğe bağlı presentation satır içi düğmeleri; yalnızca düğme düzenlemeleri yanıt işaretlemesini günceller)
• createForumTopic (chatId, name, isteğe bağlı iconColor, iconCustomEmojiId)

• [[reply_to_current]] — tetikleyici iletiyi yanıtlar
• [[reply_to:<id>]] — belirli bir ileti kimliğini yanıtlar

​

Sesli iletiler

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

​

Görüntülü iletiler

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

​

Konumlar ve mekânlar

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  location: {
    latitude: 48.858844,
    longitude: 2.294351,
    accuracy: 12,
    name: "Eiffel Kulesi",
    address: "Champ de Mars, Paris",
  },
}

​

Çıkartmalar

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

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

{
  action: "sticker-search",
  channel: "telegram",
  query: "el sallayan kedi",
  limit: 5,
}

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

• channels.telegram.accounts.<accountId>.ackReaction
• channels.telegram.ackReaction
• messages.ackReaction
• agent kimliği emojisi geri dönüşü (agents.entries.*.identity.emoji, aksi takdirde ”👀”)

• channels.telegram.textChunkLimit varsayılan olarak 4000’dir; streaming.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 medya boyutunu sınırlar.
• grup bağlamı geçmişi channels.telegram.historyLimit veya messages.groupChat.historyLimit (varsayılan 50) kullanır; 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ı penceresinde normalleştirilir; gözlemlenen mesaj önbelleği OpenClaw SQLite Plugin durumunda tutulur ve openclaw doctor --fix eski yan dosyaları içe aktarır. Telegram, güncelleme başına yalnızca bir sığ reply_to_message içerdiğinden, önbellekten daha eski zincirler bu yükle sınırlıdır.
• Telegram izin listeleri esas olarak ek bağlam için tam bir sansürleme sınırı oluşturmayı değil, aracıyı kimlerin tetikleyebileceğini denetler.
• DM geçmişi: channels.telegram.dmHistoryLimit, channels.telegram.dms["<user_id>"].historyLimit.

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"

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

• channels.telegram.execApprovals.enabled (en az bir onaylayıcı çözümlenebildiğinde "auto" etkinleştirir)
• 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

• requireMention=false ise Telegram gizlilik modu tam görünürlüğe izin vermelidir: BotFather /setprivacy -> Disable; ardından botu gruptan kaldırıp yeniden ekleyin.
• Yapılandırma, etiketleme içermeyen grup mesajlarını beklediğinde openclaw channels status uyarı verir.
• openclaw channels status --probe, açıkça belirtilen sayısal grup kimliklerini denetler; joker karakter "*" için üyelik sorgulanamaz.
• Hızlı oturum testi: /activation always.

• channels.telegram.groups mevcutsa grup listelenmelidir (veya "*" içermelidir).
• Botun gruba üye olduğunu doğrulayın.
• Atlama nedenleri için openclaw logs --follow değerini inceleyin.

• Gönderen kimliğinizi yetkilendirin (eşleştirme ve/veya sayısal allowFrom); grup ilkesi open olsa bile komut yetkilendirmesi geçerliliğini korur.
• BOT_COMMANDS_TOO_MUCH ile birlikte setMyCommands failed, yerel menüde çok fazla girdi olduğu anlamına gelir; Plugin/Skill/özel komutların sayısını azaltın veya yerel menüleri devre dışı bırakın.
• deleteMyCommands / setMyCommands başlangıç çağrıları ve sendChatAction yazma çağrıları sınırlıdır ve istek zaman aşımında Telegram’ın aktarım geri dönüşü üzerinden bir kez yeniden denenir. Sürekli ağ/fetch hataları genellikle api.telegram.org adresine DNS/HTTPS üzerinden erişilemediği anlamına gelir.

• getMe returned 401, yapılandırılan bot token’ı için bir Telegram kimlik doğrulama hatasıdır. BotFather’da token’ı yeniden kopyalayın veya oluşturun; ardından channels.telegram.botToken, tokenFile, accounts.<id>.botToken ya da TELEGRAM_BOT_TOKEN (varsayılan hesap) değerini güncelleyin.
• Başlangıç sırasındaki deleteWebhook 401 Unauthorized de bir kimlik doğrulama hatasıdır; bunu “Webhook yok” olarak değerlendirmek, aynı geçersiz token hatasını yalnızca daha sonraki bir API çağrısına erteler.

• Özel bir fetch/proxy ile Node 22+, AbortSignal türleri eşleşmezse anında iptal davranışını tetikleyebilir.
• Bazı ana makineler api.telegram.org adresini önce IPv6’ya çözümler; bozuk IPv6 çıkışı aralıklı API hatalarına neden olur.
• TypeError: fetch failed veya Network request for 'getUpdates' failed! içeren günlükler, kurtarılabilir ağ hataları olarak yeniden denenir.
• Yoklama başlangıcı sırasında OpenClaw, grammY için başarılı başlangıç getMe yoklamasını yeniden kullanır; böylece çalıştırıcının ilk getUpdates öncesinde ikinci bir getMe çağrısına ihtiyacı olmaz.
• deleteWebhook, yoklama başlangıcı sırasında geçici bir ağ hatasıyla başarısız olursa OpenClaw, yoklama öncesi başka bir denetim düzlemi çağrısı yapmak yerine uzun yoklamaya devam eder. Hâlâ etkin olan bir Webhook daha sonra getUpdates çakışması olarak ortaya çıkar; OpenClaw aktarımı yeniden oluşturur ve Webhook temizliğini yeniden dener.
• Günlüklerdeki Polling stall detected, varsayılan olarak tamamlanmış uzun yoklama canlılığı olmadan 120 saniye geçtikten sonra OpenClaw’ın yoklamayı yeniden başlatıp aktarımı yeniden oluşturduğu anlamına gelir.
• openclaw channels status --probe ve openclaw doctor; çalışan bir yoklama hesabı başlangıç ek süresinden sonra getUpdates işlemini tamamlamadığında, çalışan bir Webhook hesabı başlangıç ek süresinden sonra setWebhook işlemini tamamlamadığında veya son başarılı yoklama aktarımı etkinliği eski kaldığında uyarı verir.
• Telegram, Bot API aktarımı için işlem proxy ortam değişkenlerini dikkate alır: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY ve küçük harfli çeşitleri. NO_PROXY / no_proxy yine de api.telegram.org değerini atlayabilir.
• Bir hizmet ortamı için OPENCLAW_PROXY_URL ayarlanmışsa ve standart proxy ortam değişkeni yoksa Telegram, Bot API aktarımı için de bu URL’yi kullanır.
• Doğrudan çıkış/TLS bağlantısı kararsız VPS ana makinelerinde Telegram API çağrılarını bir 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, ardından channels.telegram.network.dnsResultOrder, sonrasında işlem varsayılanını (örneğin NODE_OPTIONS=--dns-result-order=ipv4first) dikkate alır; hiçbiri geçerli değilse Node 22+ üzerinde ipv4first değerine geri döner.
• WSL2’de veya yalnızca IPv4 davranışı daha iyi çalıştığında adres ailesi 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 sahte IP veya şeffaf proxy, medya indirmeleri sırasında api.telegram.org değerini başka bir özel/dâhilî/özel kullanım adresine dönüştürüyorsa yalnızca Telegram’a özgü atlamayı etkinleştirin:

channels:
  telegram:
    network:
      dangerouslyAllowPrivateNetwork: true

• Aynı etkinleştirme seçeneği hesap başına channels.telegram.accounts.<accountId>.network.dangerouslyAllowPrivateNetwork konumunda kullanılabilir.
• Proxy’niz Telegram medya ana makinelerini 198.18.x.x aralığına çözümlüyorsa önce tehlikeli bayrağı kapalı bırakın; bu aralığa varsayılan olarak zaten izin verilir.

• Geçici ortam geçersiz kılmaları: 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 A
dig +short api.telegram.org AAAA