​

Telegram (Bot API)

​

Hızlı kurulum (başlangıç)

1. @BotFather ile bir bot oluşturun (doğrudan bağlantı). Kullanıcı adının tam olarak @BotFather olduğunu doğrulayın, ardından belirteci kopyalayın.
2. Belirteci ayarlayın:
   • Env: TELEGRAM_BOT_TOKEN=...
   • Ya da yapılandırma: channels.telegram.botToken: "...".
   • Her ikisi de ayarlıysa, yapılandırma önceliklidir (ortam değişkeni geri dönüş olarak yalnızca varsayılan hesap içindir).
3. Gateway’i başlatın.
4. DM erişimi varsayılan olarak eşleştirmedir; ilk temas sırasında eşleştirme kodunu onaylayın.

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
    },
  },
}

​

Nedir?

• Gateway’e ait bir Telegram Bot API kanalıdır.
• Deterministik yönlendirme: yanıtlar Telegram’a geri döner; model kanal seçmez.
• DM’ler ajanın ana oturumunu paylaşır; gruplar yalıtılmıştır (agent:<agentId>:telegram:group:<chatId>).

​

Kurulum (hızlı yol)

​

1. Bot belirteci oluşturma (BotFather)

1. Telegram’ı açın ve @BotFather ile sohbet edin (doğrudan bağlantı). Kullanıcı adının tam olarak @BotFather olduğunu doğrulayın.
2. /newbot çalıştırın, ardından yönergeleri izleyin (ad + bot ile biten kullanıcı adı).
3. Belirteci kopyalayın ve güvenle saklayın.

• /setjoingroups — botun gruplara eklenmesine izin ver/engelle.
• /setprivacy — botun tüm grup mesajlarını görüp görmeyeceğini denetle.

​

2. Belirteci yapılandırma (ortam değişkeni veya config)

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

3. Gateway’i başlatın. Bir belirteç çözümlendiğinde Telegram başlar (önce yapılandırma, ortam değişkeni geri dönüş).
4. DM erişimi varsayılan olarak eşleştirmedir. Bot ilk kez iletişime geçtiğinde kodu onaylayın.
5. Gruplar için: botu ekleyin, gizlilik/yönetici davranışını belirleyin (aşağıda), ardından mention kapısı + izin listelerini denetlemek için channels.telegram.groups ayarlayın.

​

Belirteç + gizlilik + izinler (Telegram tarafı)

​

Belirteç oluşturma (BotFather)

• /newbot botu oluşturur ve belirteci döndürür (gizli tutun).
• If a token leaks, revoke/regenerate it via @BotFather and update your config.

​

Grup mesajı görünürlüğü (Gizlilik Modu)

• /setprivacy ile gizlilik modunu kapatın veya
• Botu grup yöneticisi olarak ekleyin (yönetici botlar tüm mesajları alır).

​

Grup izinleri (yönetici yetkileri)

​

Nasıl çalışır (davranış)

• Gelen mesajlar, yanıt bağlamı ve medya yer tutucuları ile paylaşılan kanal zarfına normalize edilir.
• Grup yanıtları varsayılan olarak bir mention gerektirir (yerel @mention veya agents.list[].groupChat.mentionPatterns / messages.groupChat.mentionPatterns).
• Çoklu ajan geçersiz kılma: agents.list[].groupChat.mentionPatterns üzerinde ajan başına desenler ayarlayın.
• Yanıtlar her zaman aynı Telegram sohbetine yönlendirilir.
• Long‑polling, sohbet başına sıralama ile grammY runner kullanır; genel eşzamanlılık agents.defaults.maxConcurrent ile sınırlandırılır.
• Telegram Bot API okundu bilgilerini desteklemez; sendReadReceipts seçeneği yoktur.

​

Taslak akışı

• @BotFather’da bot için Threaded Mode etkin olmalıdır (forum konu modu).
• Yalnızca özel sohbet iş parçacıkları (Telegram, gelen mesajlarda message_thread_id içerir).
• channels.telegram.streamMode, "off" olarak ayarlı olmamalıdır (varsayılan: "partial"; "block" parça parça taslak güncellemelerini etkinleştirir).

​

Biçimlendirme (Telegram HTML)

• Giden Telegram metni parse_mode: "HTML" kullanır (Telegram’ın desteklediği etiket alt kümesi).
• Markdown benzeri giriş Telegram‑güvenli HTML’e dönüştürülür (kalın/italik/üstü çizili/kod/bağlantılar); blok öğeleri yeni satırlar/maddelerle metne düzleştirilir.
• Modellerden gelen ham HTML, Telegram ayrıştırma hatalarını önlemek için kaçışlanır.
• Telegram HTML yükünü reddederse, OpenClaw aynı mesajı düz metin olarak yeniden dener.

​

Komutlar (yerel + özel)

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

​

Kurulum sorun giderme (komutlar)

• Günlüklerde setMyCommands failed genellikle api.telegram.org adresine giden HTTPS/DNS çıkışının engellendiği anlamına gelir.
• sendMessage veya sendChatAction hataları görürseniz, IPv6 yönlendirmesi ve DNS’i kontrol edin.

• Özel komutlar yalnızca menü girdileridir; OpenClaw bunları başka yerde ele almadıkça uygulamaz.
• Bazı komutlar Telegram’ın komut menüsüne kaydedilmeden eklentiler/yetenekler tarafından işlenebilir. Yazıldıklarında yine çalışırlar (sadece /commands / menüde görünmezler).
• Komut adları normalize edilir (başta gelen / kaldırılır, küçük harfe çevrilir) ve a-z, 0-9, _ ile eşleşmelidir (1–32 karakter).
• Özel komutlar yerel komutların üzerine yazamaz. Çakışmalar yok sayılır ve kayda alınır.
• commands.native devre dışıysa, yalnızca özel komutlar kaydedilir (yoksa temizlenir).

​

Cihaz eşleştirme komutları (device-pair eklentisi)

1. /pair bir kurulum kodu üretir (kolay kopyala/yapıştır için ayrı bir mesaj olarak gönderilir).
2. Bağlanmak için kurulum kodunu iOS uygulamasına yapıştırın.
3. /pair approve en son bekleyen cihaz isteğini onaylar.

​

Sınırlar

• Giden metin channels.telegram.textChunkLimit’a bölünür (varsayılan 4000).
• İsteğe bağlı yeni satıra göre bölme: uzunluk bölmeden önce boş satırlarda (paragraf sınırları) bölmek için channels.telegram.chunkMode="newline" ayarlayın.
• Medya indirme/yükleme channels.telegram.mediaMaxMb ile sınırlandırılır (varsayılan 5).
• Telegram Bot API istekleri channels.telegram.timeoutSeconds sonra zaman aşımına uğrar (grammY ile varsayılan 500). Uzun beklemeleri önlemek için daha düşüğe ayarlayın.
• Grup geçmişi bağlamı channels.telegram.historyLimit (veya channels.telegram.accounts.*.historyLimit) kullanır; aksi halde messages.groupChat.historyLimit’ya düşer. Devre dışı bırakmak için 0 ayarlayın (varsayılan 50).
• DM geçmişi channels.telegram.dmHistoryLimit (kullanıcı dönüşleri) ile sınırlandırılabilir. Kullanıcı başına geçersiz kılmalar: channels.telegram.dms["<user_id>"].historyLimit.

​

Grup etkinleştirme modları

​

Yapılandırma ile (önerilen)

{
  channels: {
    telegram: {
      groups: {
        "-1001234567890": { requireMention: false }, // always respond in this group
      },
    },
  },
}

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: false }, // all groups, always respond
      },
    },
  },
}

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: true }, // or omit groups entirely
      },
    },
  },
}

​

Komut ile (oturum düzeyi)

• /activation always — tüm mesajlara yanıt ver
• /activation mention — mention gerektir (varsayılan)

​

Grup sohbet kimliğini alma

​

Yapılandırma yazımları

• Bir grup süper gruba yükseltilir ve Telegram migrate_to_chat_id yayar (sohbet kimliği değişir). OpenClaw, channels.telegram.groups’yi otomatik olarak taşıyabilir.
• Bir Telegram sohbetinde /config set veya /config unset çalıştırırsınız (commands.config: true gerektirir).

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

​

Konular (forum süper grupları)

• Her konunun yalıtılması için Telegram grup oturum anahtarına :topic:<threadId> ekler.
• Yanıtların konu içinde kalması için yazıyor göstergeleri ve yanıtları message_thread_id ile gönderir.
• Genel konu (iş parçacığı kimliği 1) özeldir: mesaj gönderimleri message_thread_id içermez (Telegram reddeder), ancak yazıyor göstergeleri yine de içerir.
• Yönlendirme/şablonlama için şablon bağlamında MessageThreadId + IsForum sunar.
• Konuya özgü yapılandırma channels.telegram.groups.<chatId>.topics.<threadId> altında mevcuttur (skills, izin listeleri, otomatik yanıt, sistem istemleri, devre dışı).
• Konu yapılandırmaları, konu başına geçersiz kılınmadıkça grup ayarlarını (requireMention, izin listeleri, skills, prompts, enabled) devralır.

​

Satır İçi Düğmeler

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

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

• off — satır içi düğmeler devre dışı
• dm — yalnızca DM’ler (grup hedefleri engellenir)
• group — yalnızca gruplar (DM hedefleri engellenir)
• all — DM’ler + gruplar
• allowlist — DM’ler + gruplar, ancak yalnızca allowFrom/groupAllowFrom tarafından izin verilen gönderenler (kontrol komutlarıyla aynı kurallar)

​

Düğme gönderme

{
  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" }],
  ],
}

​

Yapılandırma seçenekleri

• channels.telegram.capabilities: Aksi belirtilmedikçe tüm Telegram hesaplarına uygulanan genel varsayılan yetenek yapılandırması.
• channels.telegram.accounts.<account>.capabilities: Belirli bir hesap için genel varsayılanları geçersiz kılan hesap başına yetenekler.

​

Erişim denetimi (DM’ler + gruplar)

​

DM erişimi

• Varsayılan: channels.telegram.dmPolicy = "pairing". Bilinmeyen gönderenler bir eşleştirme kodu alır; onaylanana kadar mesajlar yok sayılır (kodlar 1 saat sonra dolar).
• Onaylama yolları:
  • openclaw pairing list telegram
  • openclaw pairing approve telegram <CODE>
• Eşleştirme, Telegram DM’leri için varsayılan belirteç değişimidir. Ayrıntılar: Eşleştirme
• channels.telegram.allowFrom sayısal kullanıcı kimliklerini (önerilir) veya @username girdilerini kabul eder. Bot kullanıcı adı değildir; insan gönderenin kimliğini kullanın. Sihirbaz @username kabul eder ve mümkünse sayısal kimliğe çözer.

​

Telegram kullanıcı kimliğinizi bulma

1. Gateway’i başlatın ve botunuza DM gönderin.
2. openclaw logs --follow çalıştırın ve from.id’i arayın.

1. Botunuza DM gönderin.
2. Bot belirtecinizle güncellemeleri çekin ve message.from.id’yi okuyun:
   curl "https://api.telegram.org/bot<bot_token>/getUpdates"
   

• @userinfobot veya @getidsbot’e DM gönderin ve dönen kullanıcı kimliğini kullanın.

​

Grup erişimi

• groups yapılandırması yok = tüm gruplara izin verilir
• groups yapılandırması varsa = yalnızca listelenen gruplar veya "*" izinlidir
• Örnek: "groups": { "-1001234567890": {}, "*": {} } tüm gruplara izin verir

• "open" = izinli gruplardaki tüm gönderenler mesaj atabilir
• "allowlist" = yalnızca channels.telegram.groupAllowFrom içindeki gönderenler mesaj atabilir
• "disabled" = grup mesajları hiç kabul edilmez Varsayılan groupPolicy: "allowlist"’tir (groupAllowFrom eklemediğiniz sürece engelli).

{
  channels: {
    telegram: {
      groups: {
        "-1001234567890": {
          groupPolicy: "open",
          requireMention: false,
        },
      },
    },
  },
}

​

Long‑polling vs webhook

• Varsayılan: long‑polling (herhangi bir herkese açık URL gerekmez).
• Webhook modu: channels.telegram.webhookUrl ve channels.telegram.webhookSecret ayarlayın (isteğe bağlı channels.telegram.webhookPath).
  • Yerel dinleyici 0.0.0.0:8787’e bağlanır ve varsayılan olarak POST /telegram-webhook’ü sunar.
  • Genel URL’niz farklıysa, bir ters vekil kullanın ve channels.telegram.webhookUrl’i genel uç noktaya yönlendirin.

​

Yanıt iş parçacığı (threading)

• [[reply_to_current]] — tetikleyici mesaja yanıt ver.
• [[reply_to:<id>]] — belirli bir mesaj kimliğine yanıt ver.

• first (varsayılan), all, off.

​

Sesli mesajlar (ses notu vs dosya)

• [[audio_as_voice]] — sesi dosya yerine ses notu olarak gönder.

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

​

Video mesajları (video vs video notu)

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

​

Çıkartmalar

​

Receiving stickers

• Statik çıkartmalar (WEBP): İndirilir ve görsel işleme üzerinden işlenir. Çıkartma, mesaj içeriğinde bir <media:sticker> yer tutucusu olarak görünür.
• Animasyonlu çıkartmalar (TGS): Atlanır (Lottie biçimi işleme için desteklenmez).
• Video çıkartmalar (WEBM): Atlanır (video biçimi işleme için desteklenmez).

• Sticker — şu alanlara sahip nesne:
  • emoji — çıkartmayla ilişkili emoji
  • setName — çıkartma setinin adı
  • fileId — Telegram dosya kimliği (aynı çıkartmayı geri göndermek için)
  • fileUniqueId — önbellek araması için kararlı kimlik
  • cachedDescription — mevcutsa önbelleğe alınmış görsel açıklaması

​

Sticker cache

1. İlk karşılaşma: Çıkartma görseli görsel analiz için yapay zekâya gönderilir. Yapay zekâ bir açıklama üretir (örn. “Heyecanla el sallayan bir çizgi film kedisi”).
2. Önbelleğe alma: Açıklama; çıkartmanın dosya kimliği, emojisi ve set adıyla birlikte kaydedilir.
3. Sonraki karşılaşmalar: Aynı çıkartma tekrar görüldüğünde, önbellekteki açıklama doğrudan kullanılır. Görsel yapay zekâya gönderilmez.

{
  "fileId": "CAACAgIAAxkBAAI...",
  "fileUniqueId": "AgADBAADb6cxG2Y",
  "emoji": "👋",
  "setName": "CoolCats",
  "description": "A cartoon cat waving enthusiastically",
  "cachedAt": "2026-01-15T10:30:00.000Z"
}

• Aynı çıkartma için tekrarlanan görsel çağrıları önleyerek API maliyetlerini düşürür
• Önbelleğe alınmış çıkartmalar için daha hızlı yanıt süreleri (görsel işleme gecikmesi yok)
• Önbelleğe alınmış açıklamalara dayalı çıkartma arama işlevini mümkün kılar

​

Sending stickers

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

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

• fileId (zorunlu) — çıkartmanın Telegram dosya kimliği. Bunu, bir çıkartma alırken Sticker.fileId’den veya bir sticker-search sonucundan edinin.
• replyTo (isteğe bağlı) — yanıtlanacak mesaj kimliği.
• threadId (isteğe bağlı) — forum konuları için mesaj iş parçacığı kimliği.

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

{
  ok: true,
  count: 2,
  stickers: [
    {
      fileId: "CAACAgIAAxkBAAI...",
      emoji: "👋",
      description: "A cartoon cat waving enthusiastically",
      setName: "CoolCats",
    },
  ],
}

{
  action: "sticker",
  channel: "telegram",
  to: "-1001234567890",
  fileId: "CAACAgIAAxkBAAI...",
  replyTo: 42,
  threadId: 123,
}

​

Akış (taslaklar)

• Konular etkin olan özel sohbetler (bot için forum konu modu).
• Gelen mesajlar message_thread_id içermelidir (özel konu iş parçacığı).
• Gruplar/süper gruplar/kanallar için akış yok sayılır.

• channels.telegram.streamMode: "off" | "partial" | "block" (varsayılan: partial)
  • partial: taslak baloncuğunu en son akış metniyle güncelle.
  • block: taslak baloncuğunu daha büyük bloklar halinde güncelle (parçalı).
  • off: taslak akışını devre dışı bırak.
• İsteğe bağlı (yalnızca streamMode: "block" için):
  • channels.telegram.draftChunk: { minChars?, maxChars?, breakPreference? }
    • varsayılanlar: minChars: 200, maxChars: 800, breakPreference: "paragraph" (channels.telegram.textChunkLimit’e sıkıştırılır).

• /reasoning stream, yanıt üretilirken gerekçelendirmeyi taslak baloncuğuna akış halinde gönderir, ardından gerekçelendirme olmadan nihai yanıtı yollar.
• channels.telegram.streamMode off ise gerekçelendirme akışı devre dışıdır. Daha fazla bağlam: Akış + parçalama.

​

Yeniden deneme politikası

​

Ajan aracı (mesajlar + tepkiler)

• Araç: telegram ve sendMessage eylemi (to, content, isteğe bağlı mediaUrl, replyToMessageId, messageThreadId).
• Araç: telegram ve react eylemi (chatId, messageId, emoji).
• Araç: telegram ve deleteMessage eylemi (chatId, messageId).
• Tepki kaldırma semantiği: /tools/reactions.
• Araç kapılama: channels.telegram.actions.reactions, channels.telegram.actions.sendMessage, channels.telegram.actions.deleteMessage (varsayılan: etkin) ve channels.telegram.actions.sticker (varsayılan: devre dışı).

​

Tepki bildirimleri

1. Telegram API’den message_reaction güncellemesini alır
2. Bunu şu biçimde bir sistem olayına dönüştürür: "Telegram reaction added: {emoji} by {user} on msg {id}"
3. Sistem olayını normal mesajlarla aynı oturum anahtarı ile kuyruğa alır
4. Aynı konuşmada bir sonraki mesaj geldiğinde, sistem olayları boşaltılır ve ajanın bağlamının başına eklenir

• channels.telegram.reactionNotifications: Hangi tepkilerin bildirim tetikleyeceğini denetler
  • "off" — tüm tepkileri yok say
  • "own" — kullanıcılar bot mesajlarına tepki verdiğinde bildir (en iyi çaba; bellek içi) (varsayılan)
  • "all" — tüm tepkiler için bildir
• channels.telegram.reactionLevel: Ajanın tepki yeteneğini denetler
  • "off" — ajan mesajlara tepki veremez
  • "ack" — bot onaylayıcı tepkiler gönderir (işlenirken 👀) (varsayılan)
  • "minimal" — ajan ölçülü şekilde tepki verebilir (kılavuz: 5–10 etkileşimde 1)
  • "extensive" — ajan uygun olduğunda serbestçe tepki verebilir

{
  channels: {
    telegram: {
      reactionNotifications: "all", // See all reactions
      reactionLevel: "minimal", // Agent can react sparingly
    },
  },
}

• Telegram botları, allowed_updates içinde açıkça message_reaction talep etmelidir (OpenClaw tarafından otomatik yapılandırılır)
• Webhook modunda tepkiler webhook allowed_updates içinde yer alır
• Polling modunda tepkiler getUpdates allowed_updates içinde yer alır

​

Teslim hedefleri (CLI/cron)

• Hedef olarak bir sohbet kimliği (123456789) veya bir kullanıcı adı (@name) kullanın.
• Örnek: openclaw message send --channel telegram --target 123456789 --message "hi".

​

Sorun giderme

• channels.telegram.groups.*.requireMention=false ayarladıysanız, Telegram Bot API gizlilik modu devre dışı olmalıdır.
  • BotFather: /setprivacy → Disable (sonra botu gruptan kaldırıp yeniden ekleyin)
• openclaw channels status, yapılandırma mention’sız grup mesajlarını beklediğinde uyarı gösterir.
• openclaw channels status --probe, açık sayısal grup kimlikleri için üyeliği ayrıca denetleyebilir (joker "*" kurallarını denetleyemez).
• Hızlı test: /activation always (yalnızca oturum; kalıcılık için yapılandırmayı kullanın)

• channels.telegram.groups ayarlıysa, grup listelenmiş olmalı veya "*" kullanılmalıdır
• @BotFather’da Gizlilik Ayarlarını kontrol edin → “Group Privacy” OFF olmalı
• Botun gerçekten üye olduğunu doğrulayın (okuma erişimi olmayan yalnızca yönetici değil)
• Gateway günlüklerini kontrol edin: openclaw logs --follow (“skipping group message” arayın)

• /activation komutu oturum durumunu günceller ancak yapılandırmaya kalıcı yazmaz
• Kalıcı davranış için grubu channels.telegram.groups’ye requireMention: false ile ekleyin

• Telegram kullanıcı kimliğinizin yetkili olduğundan emin olun (eşleştirme veya channels.telegram.allowFrom ile)
• Komutlar, groupPolicy: "open" olan gruplarda bile yetkilendirme gerektirir

• Node 22+, AbortSignal örnekleri konusunda daha katıdır; yabancı sinyaller fetch çağrılarını anında iptal edebilir.
• İptal sinyallerini normalize eden bir OpenClaw sürümüne yükseltin veya yükseltene kadar Gateway’i Node 20 üzerinde çalıştırın.

• Bazı barındırmalar api.telegram.org’yi önce IPv6’ya çözer. Sunucunuzda çalışan IPv6 çıkışı yoksa, grammY IPv6‑yalnız isteklerde takılabilir.
• Çözüm: IPv6 çıkışını etkinleştirin veya api.telegram.org için IPv4 çözümlemesini zorlayın (ör. IPv4 A kaydını kullanarak bir /etc/hosts girdisi ekleyin ya da işletim sisteminizin DNS yığınında IPv4’ü tercih edin), ardından Gateway’i yeniden başlatın.
• Hızlı kontrol: DNS’in ne döndürdüğünü doğrulamak için dig +short api.telegram.org A ve dig +short api.telegram.org AAAA.

​

Yapılandırma başvurusu (Telegram)

• channels.telegram.enabled: kanal başlangıcını etkinleştir/devre dışı bırak.
• channels.telegram.botToken: bot belirteci (BotFather).
• channels.telegram.tokenFile: belirteci dosya yolundan oku.
• channels.telegram.dmPolicy: pairing | allowlist | open | disabled (varsayılan: eşleştirme).
• channels.telegram.allowFrom: DM izin listesi (kimlikler/kullanıcı adları). open, "*" gerektirir.
• channels.telegram.groupPolicy: open | allowlist | disabled (varsayılan: izin listesi).
• channels.telegram.groupAllowFrom: grup gönderen izin listesi (kimlikler/kullanıcı adları).
• channels.telegram.groups: grup başına varsayılanlar + izin listesi (genel varsayılanlar için "*" kullanın).
  • channels.telegram.groups.<id>.groupPolicy: groupPolicy için grup başına geçersiz kılma (open | allowlist | disabled).
  • channels.telegram.groups.<id>.requireMention: mention kapısı varsayılanı.
  • channels.telegram.groups.<id>.skills: skill filtresi (yok = tüm Skills, boş = hiçbiri).
  • channels.telegram.groups.<id>.allowFrom: grup başına gönderen izin listesi geçersiz kılması.
  • channels.telegram.groups.<id>.systemPrompt: grup için ek sistem istemi.
  • channels.telegram.groups.<id>.enabled: false olduğunda grubu devre dışı bırak.
  • channels.telegram.groups.<id>.topics.<threadId>.*: konu başına geçersiz kılmalar (grup ile aynı alanlar).
  • channels.telegram.groups.<id>.topics.<threadId>.groupPolicy: groupPolicy için konu başına geçersiz kılma (open | allowlist | disabled).
  • channels.telegram.groups.<id>.topics.<threadId>.requireMention: konu başına mention kapısı geçersiz kılması.
• channels.telegram.capabilities.inlineButtons: off | dm | group | all | allowlist (varsayılan: izin listesi).
• channels.telegram.accounts.<account>.capabilities.inlineButtons: hesap başına geçersiz kılma.
• channels.telegram.replyToMode: off | first | all (varsayılan: first).
• channels.telegram.textChunkLimit: giden parça boyutu (karakter).
• channels.telegram.chunkMode: length (varsayılan) veya uzunluk bölmeden önce boş satırlarda (paragraf sınırları) bölmek için newline.
• channels.telegram.linkPreview: giden mesajlar için bağlantı önizlemelerini aç/kapat (varsayılan: true).
• channels.telegram.streamMode: off | partial | block (taslak akışı).
• channels.telegram.mediaMaxMb: gelen/giden medya üst sınırı (MB).
• channels.telegram.retry: giden Telegram API çağrıları için yeniden deneme ilkesi (denemeler, minDelayMs, maxDelayMs, jitter).
• channels.telegram.network.autoSelectFamily: Node autoSelectFamily geçersiz kılması (true=etkin, false=devre dışı). Node 22’de Happy Eyeballs zaman aşımını önlemek için varsayılan olarak devre dışıdır.
• channels.telegram.proxy: Bot API çağrıları için proxy URL’si (SOCKS/HTTP).
• channels.telegram.webhookUrl: webhook modunu etkinleştirir (channels.telegram.webhookSecret gerektirir).
• channels.telegram.webhookSecret: webhook gizlisi (webhookUrl ayarlıysa zorunlu).
• channels.telegram.webhookPath: yerel webhook yolu (varsayılan /telegram-webhook).
• channels.telegram.actions.reactions: Telegram araç tepkilerini kapıla.
• channels.telegram.actions.sendMessage: Telegram araç mesaj gönderimlerini kapıla.
• channels.telegram.actions.deleteMessage: Telegram araç mesaj silmelerini kapıla.
• channels.telegram.actions.sticker: Telegram çıkartma eylemlerini kapıla — gönderme ve arama (varsayılan: false).
• channels.telegram.reactionNotifications: off | own | all — hangi tepkilerin sistem olaylarını tetikleyeceğini denetler (ayarlı değilse varsayılan: own).
• channels.telegram.reactionLevel: off | ack | minimal | extensive — ajanın tepki yeteneğini denetler (ayarlı değilse varsayılan: minimal).

• agents.list[].groupChat.mentionPatterns (mention kapısı desenleri).
• messages.groupChat.mentionPatterns (genel geri dönüş).
• commands.native (varsayılan "auto" → Telegram/Discord için açık, Slack için kapalı), commands.text, commands.useAccessGroups (komut davranışı). channels.telegram.commands.native ile geçersiz kılın.
• messages.responsePrefix, messages.ackReaction, messages.ackReactionScope, messages.removeAckAfterReply.