Pesan kaya dan persetujuan Telegram di OpenClaw

Teks hanyalah awal dari apa yang dapat dikirim bot Telegram: blok berformat, keyboard di bawah pesan, peluncur Mini App, reaksi pada pesan orang lain, prompt persetujuan dengan dua tombol. OpenClaw mengekspos masing-masing melalui sekumpulan kecil kunci konfigurasi dan aksi pesan, yang sebagian besar nonaktif sampai Anda mengaktifkannya. Berikut kontrak pemformatan, scope tombol, aksi beserta gerbangnya, dan cara persetujuan exec sampai ke pemberi persetujuan di dalam Telegram.

Pemformatan

• Teks keluar menggunakan HTML Telegram standar secara default, yang terbaca di semua klien saat ini, dengan tebal, miring, tautan, kode, spoiler, dan kutipan, dan blok kode berpagar mempertahankan isi literal dan spasinya, termasuk contoh pagar di dalam blok; blok khusus rich dari Bot API 10.3, yaitu tabel native, detail, media kaya, dan rumus, tidak digunakan kecuali Anda melakukan opt-in.
• Dengan flag rich messages aktif, agen diberi tahu bahwa pesan kaya tersedia untuk bot atau akun ini beserta kontrak penulisan Markdown dan HTML-island yang didukung, Markdown dirender melalui representasi perantara Markdown milik OpenClaw sebagai blok kaya bertipe, yaitu heading, tabel, detail, daftar periksa, media kaya, rumus, peta, dan kolase, sementara keterangan media tetap menggunakan keterangan HTML yang dibatasi 1024 karakter; teks isi rich biasa mempertahankan spasi dan baris baru hasil parsing, entitas didekode sekali, tag yang di-escape tetap menjadi teks yang terlihat, HTML yang tidak didukung tetap terlihat tanpa mencegah Markdown di dalamnya dirender, teks rich yang panjang otomatis dipecah sesuai batas Telegram, dan tabel yang melebihi batas 20 kolom beralih ke blok kode.
• Flag ini nonaktif secara default demi kompatibilitas klien, karena beberapa klien Desktop, Web, Android, dan pihak ketiga saat ini menampilkan pesan kaya yang sudah diterima sebagai tidak didukung; biarkan nonaktif kecuali setiap klien yang digunakan dengan bot dapat merendernya, dan perintah status menunjukkan apakah pesan kaya aktif atau nonaktif di sesi saat ini.
• Pratinjau tautan aktif secara default, dan kunci link-preview yang diatur ke false menonaktifkan deteksi entitas otomatis untuk teks rich; menjauhkan teks model dari sigil rich-Markdown Telegram juga menjadi alasan rentang mata uang seperti 400 hingga 600 ribu dolar tidak di-parse sebagai rumus.

Tombol Mini App hanya berfungsi di chat pribadi antara pengguna dan bot.

Tombol inline

Kapabilitas tombol inline memiliki lima scope, off, dm, group, all, dan allowlist, dengan allowlist sebagai default, diatur di tingkat saluran dan dapat ditimpa per akun; bentuk array lama dipetakan ke all, akun dengan array capabilities kosong mewarisi kapabilitas saluran, dan off yang eksplisit menonaktifkan tombol. Alat ask-user menggunakan kontrol native ini untuk satu pertanyaan pilihan tunggal, satu baris per pilihan, dengan pilihan Other yang membuka input balasan Telegram. Aksi pesan membawa presentasi dengan blok tombol, setiap tombol berupa label, aksi, dan gaya opsional seperti success atau danger; aksi callback mengembalikan nilainya, dan aksi web-app membuka URL Mini App, yang hanya berfungsi di chat pribadi antara pengguna dan bot. Nilai callback yang tidak diklaim oleh handler interaktif plugin yang terdaftar diteruskan ke agen sebagai teks dengan awalan callback data. Dengan durable ingress, pengakuan callback dikirim tepat setelah update Telegram disimpan, tanpa menunggu handler sebelumnya di jalur chat tersebut, sehingga Telegram menghapus indikator pemuatannya lebih awal, sementara aksi tombol tetap mengikuti otorisasi normal dan pemrosesan berurutan.

Aksi dan persetujuan

• Aksinya adalah send-message dengan target, konten, serta URL media, ID balasan, dan ID utas opsional, react dengan chat, pesan, dan emoji, emoji-list dengan chat dan limit opsional, delete-message, edit-message dengan konten atau keterangan serta tombol inline opsional, di mana pengeditan yang hanya berisi tombol memperbarui reply markup, dan create-forum-topic dengan nama serta warna ikon atau emoji kustom opsional, ditambah alias send, react, delete, edit, sticker, sticker-search, dan topic-create; gerbang send-message, delete-message, reactions, dan sticker nonaktif secara default, reactions mencakup react dan emoji-list, edit dan aksi topik forum aktif tanpa sakelar khusus, dan pengiriman saat runtime menggunakan snapshot konfigurasi dan rahasia dari saat startup atau reload, alih-alih me-resolve ulang referensi rahasia setiap kali mengirim.
• Emoji-list memeriksa reaksi yang diizinkan di chat dan akun tepercaya saat ini, agen tidak dapat memeriksa chat lain sementara operator langsung boleh memberikan ID chat yang berbeda, limit default-nya 100 dan tidak dapat melebihi angka itu, chat tanpa batasan mengembalikan reaksi standar dengan catatan bahwa semuanya diizinkan, reaksi yang ditolak mengembalikan contoh singkat reaksi standar yang diizinkan dan pengenal emoji kustom kecuali pencariannya sendiri gagal, dan Anda meneruskan emoji Unicode atau pengenal emoji kustom numerik langsung ke react.
• Persetujuan exec berfungsi di DM pemberi persetujuan dan secara opsional dapat memposting prompt di chat atau topik asal, pemberi persetujuan harus berupa ID pengguna numerik, kunci enabled pada auto mengaktifkannya saat setidaknya satu pemberi persetujuan dapat di-resolve, daftar approvers memakai fallback ke ID pemilik numerik dari daftar izin pemilik, target default-nya dm dengan channel dan both sebagai alternatif, filter agen dan sesi mempersempitnya, daftar izin yang menentukan siapa yang boleh berbicara dengan bot tidak menjadikan siapa pun pemberi persetujuan, meskipun penyandingan pertama yang disetujui mengisi awal daftar pemilik, pengiriman ke saluran menampilkan teks perintah sehingga channel atau both hanya pantas di grup tepercaya, prompt yang masuk ke topik forum mempertahankan topik tersebut untuk tindak lanjutnya, persetujuan kedaluwarsa setelah 30 menit secara default, tombol persetujuan inline memerlukan kapabilitas tombol yang mengizinkan permukaan target, dan ID persetujuan berawalan plugin di-resolve melalui persetujuan plugin, sedangkan sisanya mencoba persetujuan exec terlebih dahulu.

OpenClaw di Telegram adalah artikel saluran yang diperluas oleh permukaan-permukaan ini, dan perilaku pesan Telegram di OpenClaw adalah model pengiriman yang mendasarinya.

Tombol di berbagai saluran

Blok tombol, nilai callback, dan prompt persetujuan mempertahankan bentuk yang sama di setiap saluran yang memiliki komponen native, itulah sebabnya agen dapat mengajukan pertanyaan ya-atau-tidak tanpa mengetahui di mana pertanyaan itu akan dijawab. Komponen dan persetujuan Discord di OpenClaw menunjukkan sisi Discord dari kontrak tersebut, dan panduan reaksi OpenClaw menunjukkan semantik reaksi yang diimplementasikan oleh react dan emoji-list.

Di Diali

Telegram adalah salah satu saluran yang dihubungkan Diali dari dasbor, dan konfigurasi runtime yang dihasilkan diganti di setiap rilis, sehingga kunci pemformatan dan tombol di sini menggambarkan apa yang dapat dilakukan bot yang di-hosting, bukan pengaturan yang Anda edit secara manual. Telegram di Diali adalah saluran tersebut di Diali, dan keamanan Diali adalah batas yang berlaku untuk setiap tindakan yang dapat dilakukan bot.

• HTML secara default; blok rich hanya saat setiap klien dapat merendernya.
• Tombol mengikuti scope; Mini App hanya terbuka di chat pribadi.
• Pengiriman, penghapusan, reaksi, dan stiker tetap nonaktif sampai gerbangnya dibuka.