Penyiapan Telegram di OpenClaw

Bot Telegram adalah saluran yang paling cepat disiapkan, karena seluruh penyiapannya hanyalah satu token dari BotFather dan satu perintah yang menyimpannya. Berikut penyiapan cepat langkah demi langkah, aturan prioritas token, pengaturan yang berada di sisi Telegram dan bukan di konfigurasi, serta pilihan transport antara long polling dan webhook.

Penyiapan cepat

• Kedua alur BotFather berakhir dengan token yang Anda tempel ke OpenClaw: alur chat, di mana Anda berbicara dengan akun BotFather, memastikan handle-nya persis, menjalankan perintah pembuatan bot baru, dan menyimpan tokennya; atau alur web di aplikasi web BotFather, yang berjalan di setiap klien Telegram dan memungkinkan Anda membuat bot lewat UI lalu menyalin tokennya.
• Cara tercepat untuk mengonfigurasinya adalah perintah channels add dengan saluran Telegram dan tokennya, yang menuliskan token ke konfigurasi untuk Anda; jika mengedit secara manual, Anda memerlukan blok Telegram dengan saluran diaktifkan, token bot, kebijakan DM pairing, dan entri grup wildcard yang mewajibkan mention, dan variabel lingkungan token bot hanya menjadi fallback untuk akun default, karena akun bernama harus menggunakan kunci token atau file token.
• Dengan hot reload default, gateway yang sedang berjalan menerapkan konfigurasi saluran yang baru, dan pemeriksaan channels status memastikan Telegram sudah siap; jika gateway offline, Anda menjalankannya sebagai layanan terkelola atau di terminal, dan environment layanan yang berubah perlu restart agar dimuat.
• Mengirim pesan apa pun ke bot akan membuat permintaan penyandingan yang ditampilkan oleh perintah pairing list dan diterima oleh perintah approve, dengan kode yang kedaluwarsa setelah satu jam; menambahkan bot ke grup kemudian memerlukan ID pengguna numerik Anda untuk daftar izin dan ID chat grup sebagai kunci di bawah map groups, yang dibaca dari log, dari bot yang menampilkan ID pesan terusan, atau dari update Bot API, lalu dikonfirmasi dengan perintah whoami setelah grup diizinkan, dan ID supergroup yang negatif dimasukkan di bawah groups, tidak pernah di daftar pengirim grup.

Telegram tidak menggunakan openclaw channels login telegram.

Token dan sisi Telegram

Resolusi token memperhitungkan akun: file token mengalahkan kunci bot-token, kunci bot-token mengalahkan environment, konfigurasi selalu menang atas variabel lingkungan, yang hanya berlaku untuk akun default, dan setelah startup berhasil, OpenClaw menyimpan identitas bot di cache hingga 24 jam sehingga restart tidak perlu melakukan panggilan getMe tambahan, sementara token yang diubah atau dihapus akan mengosongkan cache tersebut. Di sisi Telegram, bot secara default berada dalam mode privasi, yang membatasi pesan grup mana yang diterimanya; untuk melihat semua pesan grup, Anda menonaktifkan mode privasi dengan perintah set-privacy atau menjadikan bot admin grup, dan setelah mengubah mode privasi, Anda mengeluarkan lalu menambahkan kembali bot di setiap grup agar Telegram menerapkan perubahannya. Status admin dikontrol di pengaturan grup, dan bot admin menerima semua pesan grup, yang cocok untuk perilaku grup yang selalu aktif. Toggle BotFather yang berguna adalah pengaturan join-groups yang mengizinkan atau menolak penambahan ke grup dan pengaturan privasi untuk visibilitas grup, keduanya juga tersedia di aplikasi web BotFather.

Long polling atau webhook

• Long polling adalah default; mode webhook memerlukan URL webhook dan rahasia webhook, dengan path opsional yang default-nya rute telegram-webhook, host yang default-nya loopback, port yang default-nya 8787, dan path sertifikat untuk PEM self-signed pada penyiapan dengan IP langsung atau tanpa domain; listener mencadangkan rute health untuk health check, sehingga path webhook harus menggunakan rute lain, dan penyiapan yang sudah ada di rute itu harus pindah, memperbarui URL dan pemetaan reverse proxy, lalu memverifikasi perubahan listener dengan pemeriksaan status.
• Dalam mode long polling, OpenClaw menyimpan posisi restart-nya setelah update di-commit ke antrean ingress persisten, sehingga handler yang gagal tetap dapat dicoba ulang dari antrean itu; listener lokal secara default terikat ke loopback di port 8787, dan ingress publik berarti reverse proxy di depannya atau host wildcard yang sengaja diatur.
• Mode webhook memvalidasi pengaman permintaan, token rahasia Telegram, dan body JSON, meng-commit update ke antrean persisten sebelum mengembalikan 200 kosong, dan menandai adopsi persisten yang berhasil dengan header accepted-delivery yang tidak disertakan dalam respons health, routing, autentikasi, validasi, dan error penyimpanan, sehingga reverse proxy dapat mewajibkannya alih-alih menyimpulkan penerimaan dari waktu respons; setelah penulisan persisten, update diklaim dan diproses melalui drain ingress inti dengan lane per chat dan per topik, dan giliran agen yang lambat tidak pernah menahan konfirmasi pengiriman Telegram.

OpenClaw di Telegram adalah artikel saluran tempat penyiapan ini berasal, dan kontrol akses Telegram di OpenClaw membahas apa yang perlu diputuskan berikutnya tentang siapa yang boleh menghubungi bot.

Di mana penyiapan biasanya gagal

Hampir setiap penyiapan Telegram yang gagal disebabkan oleh salah satu dari tiga hal: token untuk akun bernama yang dimasukkan melalui variabel lingkungan yang hanya melayani akun default, ID grup yang dimasukkan ke daftar pengirim alih-alih map groups, atau mode privasi yang dibiarkan aktif sementara kewajiban mention dimatikan. Pemecahan masalah Telegram di OpenClaw membahas gejala-gejala itu secara berurutan, dan ada juga panduan lima menit menghubungkan saluran pertama Anda.

Di Diali

Di Diali, saluran Telegram dihubungkan dari dasbor, dan konfigurasi runtime dibuat dari sana serta diganti pada setiap rilis, jadi langkah-langkah BotFather di awal artikel ini adalah bagian yang tetap menjadi tugas Anda. Telegram di Diali menjelaskan saluran tersebut di Diali, dan halaman keamanan Diali menjelaskan batas yang dimiliki bersama oleh setiap saluran yang terhubung.

• Satu token dari BotFather; CLI menuliskannya untuk Anda.
• Kode penyandingan kedaluwarsa setelah satu jam; ID grup dimasukkan di bawah groups.
• Long polling secara default; webhook memerlukan rahasia dan rute yang belum dipakai.