Membuka potensi Telegram dengan mode thread OpenClaw

OpenClaw adalah framework agen AI sumber terbuka yang dapat mengotomatiskan tugas di berbagai platform perpesanan seperti Slack, Discord, WhatsApp, dan Telegram. Salah satu alasan utama OpenClaw begitu populer adalah karena OpenClaw mengubah model bahasa besar menjadi agen — program perangkat lunak yang dapat berjalan berjam-jam atau berhari-hari, menjalankan rangkaian tindakan yang kompleks, dan mempertahankan konteks di beberapa kanal. Telegram, dengan Bot API-nya yang lengkap dan dukungan untuk diskusi berutas, adalah pilihan yang pas. Namun, menyiapkan OpenClaw di Telegram dan memanfaatkan mode thread tidak jelas bagi banyak pengguna baru. Artikel ini menyediakan tutorial langkah demi langkah untuk menghubungkan asistenmu ke Telegram, menjelaskan cara kerja mode thread di balik layar, menawarkan contoh penggunaan di dunia nyata, dan diakhiri dengan tips serta saran pemecahan masalah. Semua informasi dalam panduan ini berasal dari dokumentasi resmi OpenClaw dan pengalaman komunitas.

Mengapa Telegram?

Telegram populer karena mendukung bot, obrolan grup, kanal privat, dan utas bergaya forum. Platform ini menawarkan batas panjang pesan yang besar (4096 karakter), unggahan media, emoji reaksi, dan keyboard inline. Berbeda dengan beberapa platform perpesanan lain, Bot API Telegram gratis, stabil, dan terdokumentasi dengan baik. Lapisan gateway OpenClaw mendukung Telegram secara penuh; integrasinya siap produksi untuk DM bot dan grup serta bekerja melalui long polling atau webhook. Dengan kata lain, setelah dikonfigurasi dengan benar, asistenmu akan mengirim dan menerima pesan secara andal tanpa perlu menulis kode khusus apa pun.

Menyiapkan OpenClaw dengan Telegram

1. Buat bot dan ambil token API

Buka Telegram dan mulai obrolan dengan @BotFather bot. Jalankan /newbot, pilih nama dan nama pengguna, lalu salin token yang dikembalikannya. Kamu akan menempelkan token ini ke konfigurasi OpenClaw. Bot Telegram dikelola sepenuhnya melalui BotFather; kamu juga dapat menggunakan /setprivacy dan /setjoingroups untuk mengubah perilaku grup nanti.

2. Konfigurasikan OpenClaw

Buka openclaw.json berkas konfigurasi (biasanya terletak di ~/.openclaw) lalu tambahkan telegram bagian di bawah kunci channels :

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

The botToken berisi token yang kamu terima dari BotFather. dmPolicy mengatur bagaimana asistenmu menanggapi pesan langsung: pairing (default) berarti bot hanya akan menjawab DM dari pengguna yang kamu setujui; terbuka mengizinkan semua orang; allowlist membatasi akses ke daftar ID pengguna tertentu; dan disabled mematikan dukungan DM. Tanda requireMention ini penting untuk grup: bila diatur ke true, bot hanya merespons bila nama penggunanya disebut, sehingga tidak membalas setiap pesan di obrolan grup yang ramai.

3. Jalankan gateway dan pasangkan akun kamu

Setelah menyimpan konfigurasi, jalankan openclaw gateway untuk memulai gateway pesan. Setelah itu, setujui akun Telegram kamu dengan membuat kode pairing dan menyetujuinya. Di terminal terpisah, jalankan openclaw pairing list telegram untuk melihat permintaan yang tertunda, lalu setujui ID pengguna kamu sendiri dengan openclaw pairing approve telegram <CODE>. Kode kedaluwarsa setelah satu jam, jadi selesaikan langkah ini segera. Setelah dipasangkan, pesan dari akun Telegram kamu akan diteruskan ke agen OpenClaw kamu.

4. Tambahkan bot ke grup dan topik

Agar asisten kamu bisa ikut dalam obrolan grup atau topik forum, tambahkan ia ke grup Telegram yang diinginkan, lalu perbarui channels.telegram.groups di konfigurasi. Contoh:

"channels": {
  "telegram": {
    "groups": {
      "-100123456789": { "requireMention": true },
      "*": { "requireMention": false }
    },
    "groupPolicy": "allowlist"
  }
}

Di sini, entri * berfungsi sebagai penangkap umum untuk grup mana pun; requireMention: true memastikan asisten tidak membanjiri kanal. Kamu juga bisa mengatur groupPolicy untuk terbuka agar bot otomatis bergabung dengan grup mana pun yang mengundangnya, atau disabled untuk memblokir penggunaan grup sepenuhnya. Setelah mengatur grup, mulai ulang gateway dan tambahkan lagi bot ke setiap grup bila kamu mengubah pengaturan privasi.

Memahami mode thread

Telegram memperkenalkan topik forum pada 2022, sehingga grup besar bisa memecah percakapan menjadi thread terpisah. OpenClaw memanfaatkan fitur ini dengan menambahkan :topic:<threadId> ke kunci sesi internalnya. Artinya, setiap topik punya konteks percakapan sendiri; pesan yang dikirim di satu thread tidak bocor ke thread lain. Ada dua perilaku penting dari rancangan ini:

1. Isolasi topik: Saat asisten menerima pesan dengan message_thread_id, ia memakai kunci sesi seperti telegram:<chatId>:topic:<threadId>. Balasan dikirim kembali ke thread yang sama. Beginilah cara agen menjaga konteks dalam diskusi panjang yang bercabang banyak.
2. Topik umum vs. topik khusus: Telegram memperlakukan thread ID 1 sebagai topik “umum” bawaan. Saat mengirim pesan ke thread 1, sebaiknya kamu menghilangkan message_thread_id pada panggilan API; jika tidak, Telegram akan menolaknya. OpenClaw menangani ini otomatis saat mengirim balasan.

Mode thread tidak terbatas pada supergrup forum. Di obrolan pribadi (DM), Telegram kadang melampirkan message_thread_id ke balasan pesan lama. OpenClaw mempertahankan ID ini dan memakai kunci sesi yang sadar thread, sehingga riwayat percakapan kamu tetap tertata bahkan di DM.

Konfigurasi mode balasan

Secara bawaan OpenClaw menetapkan channels.telegram.replyToMode untuk nonaktif, yang menonaktifkan utas balasan implisit. Jika kamu ingin asisten membalas langsung ke pesan pemicunya, aturlah replyToMode untuk pertama atau semua. Kamu juga bisa menyertakan tag eksplisit seperti [[reply_to_current]] atau [[reply_to:<messageId>]] dalam respons agenmu. Tag ini memberi tahu gateway untuk mengarahkan balasan ke utas yang sesuai.

Streaming dan indikator mengetik

OpenClaw mendukung streaming balasan parsial di Telegram. Dengan channels.telegram.streaming diatur ke partial atau progress, gateway mengirim pesan sementara lalu menyuntingnya saat model menghasilkan teks. Ini memberi pengalaman pengguna yang lebih baik pada respons panjang. Kamu bahkan bisa mengaktifkan output penalaran real‑time lewat perintah /reasoning stream selama percakapan. Indikator mengetik dikirim otomatis, termasuk di dalam utas; namun, untuk thread ID 1 (topik umum) Telegram mengabaikan message_thread_id pada aksi mengetik.

Reaksi, stiker dan perintah inline

Bot API Telegram mendukung reaksi pesan, stiker dan tombol inline. OpenClaw menyediakan fitur-fitur ini lewat sistem aksinya:

• Reaksi: The react memungkinkan agen bereaksi terhadap pesan dengan emoji. Notifikasi reaksi dapat diatur lewat channels.telegram.reactionNotifications dan reactionLevel, untuk mengaktifkan notifikasi bagi pesan bot, semua pesan, atau tidak sama sekali. Perlu diingat Telegram tidak menyediakan thread ID untuk reaksi, jadi reaksi selalu diarahkan ke utas utama.
• Stiker: Aktifkan aksi stiker dengan mengatur channels.telegram.actions.sticker: true. Stiker disimpan di cache lokal; kamu bisa mencari di cache dengan sticker-search aksi dan mengirim stiker dengan aksi sticker.
• Tombol inline: Konfigurasi channels.telegram.capabilities.inlineButtons untuk menentukan kapan keyboard inline diizinkan (off, dm, group, all atau allowlist). Kamu lalu bisa mengirim pesan dengan tombol dengan menyertakan buttons array di badan aksi.

Kasus penggunaan mode thread

Mode thread membuka alur kerja yang kuat yang jika tidak akan membingungkan atau mustahil dilakukan dalam satu chat. Berikut beberapa skenario praktis:

1. Koordinasi multi‑proyek

Bayangkan kamu mengelola beberapa proyek sekaligus. Buat satu supergrup Telegram dan aktifkan topik forum. Untuk setiap proyek, buat topik khusus (mis., Desain Ulang Situs Web, Kampanye Pemasaran, Perbaikan Bug). Saat kamu mengirim pesan ke asistenmu di dalam sebuah topik, OpenClaw otomatis memakai kunci sesi unik untuk thread itu. Ini menjaga konteks percakapan tetap terpisah, jadi ketika kamu bertanya tentang “tenggat waktunya,” asisten tahu proyek mana yang kamu maksud.

2. Thread sampingan pribadi di chat grup

Di chat keluarga atau tim yang sibuk, kamu mungkin ingin bertanya kepada asistenmu tanpa mengganggu diskusi utama. Balas pesanmu sebelumnya atau sebut bot dalam balasan; Telegram melampirkan message_thread_id, sehingga OpenClaw mengarahkan percakapan ke thread yang terikat pada pesan itu. Sekarang kamu bisa mengajukan pertanyaan lanjutan seperti “Apa daftar tugas saya?” atau “Ringkas pesan hari ini” tanpa membanjiri chat utama.

3. Tugas yang berjalan lama

Sebagian tugas butuh waktu: merangkum dokumen panjang, membuat laporan, atau menjalankan skrip. Memulai tugas ini di sebuah thread membuat pembaruan kemajuan tetap rapi. Atur channels.telegram.streaming untuk progress agar asisten mengirim pesan pratinjau dan menyuntingnya sampai hasil akhir siap. Jika kamu punya beberapa tugas panjang, setiap thread tetap terisolasi, sehingga mencegah percakapan tercampur.

4. Sesi curah pendapat

Topik forum bisa berfungsi sebagai ruang curah pendapat. Misalnya, buka topik bernama Ide Blog dan curahkan ide artikel bersama agenmu. Asisten akan menjaga konteks tentang saran sebelumnya di dalam thread, sehingga lebih mudah menyempurnakan dan mengembangkan ide. Sementara itu, chat umummu tetap bersih.

5. Dukungan pelanggan atau FAQ

Jika kamu mengelola chat komunitas, kamu bisa membuat topik untuk pertanyaan dukungan yang berbeda-beda. Pengguna bertanya di thread mereka masing-masing, dan agen OpenClaw-mu menjawab dengan informasi yang disesuaikan. Karena kunci sesi spesifik per thread, agen tidak akan mencampur aduk jawaban. Kamu bahkan bisa mendelegasikan tugas: agen bisa membuat issue di GitHub atau membuat acara kalender sebagai tindakan lanjutan.

Pemecahan masalah dan tips

Mode privasi: Bot Telegram secara bawaan memakai mode privasi, artinya mereka hanya melihat pesan yang diawali dengan / perintah atau yang menyebut mereka. Jika kamu perlu visibilitas penuh pesan di grup, matikan privasi lewat /setprivacy atau jadikan bot sebagai admin. Ingatlah untuk menghapus lalu menambahkan kembali bot agar perubahan berlaku.

Batas riwayat: OpenClaw menyimpan riwayat terbatas per chat atau thread (50 pesan secara bawaan untuk grup dan dikonfigurasi lewat channels.telegram.historyLimit). Naikkan batas ini jika agenmu butuh lebih banyak konteks, tetapi perhatikan penggunaan memori.

Webhook vs long polling: Secara bawaan, OpenClaw memakai long polling, yang lebih mudah disiapkan. Jika kamu ingin memakai webhook (misalnya untuk mengurangi latensi), atur channels.telegram.webhookUrl dan webhookSecret. Baca dokumentasi untuk opsi port dan host.

Tag balasan eksplisit: Gunakan [[reply_to_current]] atau [[reply_to:<id>]] dalam respons agenmu saat kamu butuh kendali yang sangat rinci atas target balasan. Ini sangat membantu untuk bot yang memantau beberapa thread sekaligus.

Mengelola akses: Gunakan channels.telegram.allowFrom dan groupPolicy untuk membatasi siapa yang bisa bicara dengan botmu dan grup mana yang bisa diikutinya. Ini mencegah spam dan perintah tanpa izin.

Kesimpulan

Telegram adalah salah satu platform paling serbaguna untuk menjalankan agen OpenClaw. Dengan memahami cara kerja mode thread dan mengonfigurasi grup serta DM dengan benar, kamu bisa membangun percakapan multi-konteks yang tetap teratur. Gunakan thread untuk memisahkan proyek, menjalankan tugas berdurasi panjang, memudahkan brainstorming, atau memberikan dukungan pelanggan. Manfaatkan fitur seperti pratinjau streaming, tombol inline dan notifikasi reaksi untuk menciptakan pengalaman yang menarik. Dengan konfigurasi yang tepat, asisten OpenClaw kamu akan terasa seperti peserta alami di komunitas Telegram kamu.