Cara Menghubungkan Hermes Agent ke Telegram dan Mengelola Tugas dari Ponsel

Anda dapat mengirim pesan atau mendiktekan tugas kepada Hermes Agent di Telegram dari ponsel saat sedang tidak berada di depan komputer, lalu menerima hasilnya di chat yang sama. Hasil tugas terjadwal akan tiba di chat yang Anda tetapkan sebagai chat utama satu kali.

Jika Anda belum memiliki Hermes, mulailah dengan panduan tentang apa itu agen ini dan cara memasangnya, lalu kembali untuk menghubungkan Telegram.

Petunjuk tambahan tersedia di dokumentasi Ailoot.

Apa yang Anda perlukan untuk menghubungkan Hermes Agent ke Telegram?#

Perintah hermes doctor memeriksa instalasi Hermes dan koneksi model Anda. Kita akan membuat bot di aplikasi Telegram, dan Anda memerlukan komputer untuk menjalankan perintah di terminal.

Bagaimana cara membuat bot melalui BotFather?#

Setiap bot Telegram memiliki token — kunci rahasia untuk mengendalikan bot. Token ini diterbitkan oleh bot resmi Telegram, @BotFather.

1. Buka @BotFather

   Cari @BotFather di Telegram atau buka t.me/BotFather. BotFather yang asli memiliki tanda centang verifikasi biru. Mulai percakapan dengan mengetuk “Start.”

2. Kirim perintah /newbot

   BotFather akan meminta dua nama. Yang pertama adalah nama tampilan; namanya bisa apa saja, misalnya “My Agent.” Yang kedua adalah nama pengguna: nama ini harus unik dan diakhiri dengan bot, misalnya moy_agent_bot.

3. Dapatkan token

   BotFather akan mengirim pesan ucapan selamat dan rangkaian panjang dalam format 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Ini adalah token bot. Salin seluruh rangkaian tersebut.

Ada juga cara cepat yang tidak memerlukan percakapan manual dengan BotFather. Di dasbor web Hermes (hermes dashboard) dan aplikasi desktop, pada halaman “Messaging → Telegram”, terdapat tombol “Create with QR”: pindai kode dengan ponsel Anda, dan Hermes akan membuat bot, mendeteksi ID Anda, menyimpan token di pengaturan, lalu memulai ulang gateway. Langkah-langkah di bawah menjelaskan metode manual; jika Anda memilih QR, langsung lanjut ke pemeriksaan koneksi.

Bagaimana cara menemukan ID Telegram Anda, dan mengapa Anda memerlukannya?#

Akun Telegram memiliki dua pengenal: nama pengguna publik yang diawali tanda @ dan ID numerik internal. Hermes menggunakan nomor tersebut.

The quick “Create with QR” method described above detects your ID automatically. Write it down next to your token.

Bagaimana cara memberikan token kepada Hermes Agent dan memulai gateway?#

1. Jalankan wizard penyiapan

   hermes gateway setup
   

   Jalankan perintah di mesin tempat Hermes terpasang. Wizard akan menampilkan daftar aplikasi pesan.

2. Pilih Telegram dan masukkan detail Anda

   Wizard akan meminta token bot dan ID yang diizinkan (Anda dapat memasukkan beberapa ID, dipisahkan dengan koma), lalu menyimpan semuanya langsung di pengaturan.

3. Mulai gateway

   hermes gateway
   

   Gateway akan dimulai dan terhubung ke Telegram. Setelah beberapa detik, kirim pesan apa saja kepada bot Anda dari aplikasi: jika Hermes membalas, koneksi sudah siap.

Metode manual sebagai pengganti wizard seperti ini: buka file ~/.hermes/.env dan tambahkan dua baris, lalu ganti token dengan token dari BotFather dan ID numerik Anda:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Baris kedua mengizinkan orang-orang itu dalam chat pribadi dan grup; otorisasi chat grup yang terpisah juga dapat memberikan akses. Pisahkan beberapa orang dengan koma. Setelah menyimpan file, mulai gateway dengan perintah hermes gateway yang sama.

Jika bot tetap diam bahkan di chat pribadi, periksa log gateway di terminal yang sama dan pastikan dahulu token dan ID Anda tercantum dengan benar dalam daftar akses; kesalahan lainnya dibahas dalam tabel di bagian akhir artikel.

Apa saja yang dapat dilakukan bot Telegram di ponsel Anda?#

Ada lima kemampuan yang paling sering Anda perlukan di ponsel.

Pesan teks dan suara. Tulis tugas dengan kata-kata atau diktekan sebagai pesan suara — jika pengenalan suara sudah dikonfigurasi, Hermes akan mentranskripsikannya dan memahaminya. Dengan penyedia lokal, Anda tidak memerlukan kunci; semuanya diproses di mesin tempat agen berjalan.

File dan gambar. Anda dapat meneruskan dokumen, spreadsheet, atau tangkapan layar ke bot — agen akan menerimanya sebagai lampiran. Agen juga dapat mengirim file yang dibuat kembali kepada Anda: minta laporan, dan laporan itu akan dikirim sebagai file di chat.

Konfirmasi untuk tindakan berbahaya. Saat agen akan melakukan sesuatu yang berisiko, seperti menghapus file, agen akan bertanya terlebih dahulu di chat: balas “yes” atau “y” untuk menjalankannya; balas “no” atau “n” untuk membatalkannya.

Tombol sebagai pengganti mengetik balasan. Saat agen memerlukan penjelasan, agen akan mengirim pertanyaan dengan tombol pilihan sebaris — ketuk salah satu pilihan, dan agen akan melanjutkan pekerjaan. Perintah /model tanpa argumen menampilkan menu pemilihan model dengan tombol serupa.

Notifikasi senyap. Secara default, ponsel Anda hanya berbunyi untuk jawaban akhir, permintaan konfirmasi, dan konfirmasi perintah. Notifikasi layanan seperti “calling a tool” dan “compressing context” tiba tanpa suara, sehingga ponsel Anda tidak berbunyi setiap kali ada langkah. Jika Anda ingin notifikasi berbunyi di setiap langkah, ubah modenya di pengaturan.

Bagaimana cara mendapatkan hasil tugas latar belakang di chat?#

Chat utama untuk tugas terjadwal. Hermes mendukung tugas terjadwal: “setiap pagi pukul 7:43, buatkan ringkasan untuk saya.” Hasilnya dikirim ke chat utama, yang Anda tetapkan satu kali dengan mengirim perintah /sethome langsung dalam percakapan dengan bot. Selama gateway berjalan, ringkasan akan tiba secara otomatis.

Tugas latar belakang. Anda dapat mengirim tugas panjang untuk dijalankan di latar belakang dan melanjutkan aktivitas harian: bot akan mengirim pesan kepada Anda saat tugas selesai. Tugas yang dimulai dari suatu topik akan mengirim jawabannya kembali ke topik yang sama, sehingga tidak ada yang hilang.

Batasan penting: bot hanya membalas saat gateway berjalan. Jika Anda mematikan komputer yang menjalankan Hermes atau mengalihkannya ke mode tidur, bot tidak akan membalas sampai mesin itu berjalan kembali. Agar bot selalu online, pindahkan agen ke server: kami memiliki panduan terpisah tentang cara menjalankan Hermes Agent sepanjang waktu. Secara default, gateway melakukan polling Telegram untuk pesan baru; untuk platform cloud yang masuk mode tidur tanpa lalu lintas masuk, dokumentasi menawarkan mode webhook, yang membalik arah koneksi sehingga Telegram sendiri mengirim permintaan ke bot.

Bagaimana cara mencegah orang asing mengakses bot?#

Nama pengguna bot Anda dapat ditemukan melalui pencarian Telegram, jadi perlindungan bergantung pada dua hal: daftar akses dan menjaga kerahasiaan token.

Pertama, atur akses pengirim dengan TELEGRAM_ALLOWED_USERS. Untuk grup, periksa juga TELEGRAM_GROUP_ALLOWED_CHATS: mencantumkan chat di sana mengizinkan setiap anggotanya, meskipun ID pengirim tidak ada pada daftar izin pribadi. Karena itu daftar pribadi yang kosong saja tidak membuktikan setiap grup tertutup.

Kedua, ada token. Token tidak boleh muncul di tangkapan layar, pesan yang diteruskan, atau repositori. Jika token bocor, cabut dengan perintah /revoke di BotFather. Kemudian masukkan token baru di pengaturan dan mulai ulang gateway.

Catatan terpisah tentang grup: otorisasi pengirim dan otorisasi chat berbeda. Anggota grup yang diizinkan melalui TELEGRAM_GROUP_ALLOWED_CHATS dapat memakai bot meskipun ID-nya tidak ada dalam TELEGRAM_ALLOWED_USERS. Jika akses harus tetap individual, jangan berikan akses kepada seluruh grup; atur dan verifikasi pembatasan pengirim untuk versi yang terpasang. Jika Anda ingin bot hanya merespons saat dipanggil di dalam grup, tersedia pengaturan telegram.require_mention — bot kemudian merespons mention @, balasan ke pesannya, perintah seperti /command@yourbot, dan kecocokan dengan pola Anda di telegram.mention_patterns, sambil mengabaikan pesan grup biasa.

Mengapa bot diam di grup, dan bagaimana cara memperbaikinya?#

Bot Telegram baru mengaktifkan mode privasi secara default; dokumentasi Hermes menyebutnya sebagai penyebab kebingungan paling umum terkait bot di grup. Dalam mode ini, bot hanya menerima pesan yang diawali perintah /, balasan terhadap pesannya sendiri, dan notifikasi layanan. Bot sama sekali tidak menerima pesan grup biasa — Telegram tidak mengirimkannya kepada bot, dan tidak ada pengaturan agen yang dapat memperbaikinya.

Cara memperbaikinya:

1. Buka @BotFather dan kirim /mybots.
2. Pilih bot Anda.
3. Buka “Bot Settings” → “Group Privacy” → “Turn off.”
4. Hapus bot dari grup, lalu tambahkan kembali.

Langkah keempat mudah terlewat, sehingga bot “tetap diam.” Telegram mengingat pengaturan privasi sejak bot bergabung dengan grup, dan tidak memperbaruinya sampai bot dihapus dari grup lalu ditambahkan kembali.

Jika Anda tidak ingin menonaktifkan privasi secara global, ada pilihan kedua: jadikan bot administrator grup. Bot admin menerima semua pesan dalam mode privasi apa pun.

Kesalahan koneksi umum dan cara mengatasinya#

Apa lagi yang ditanyakan orang tentang Hermes Agent di Telegram?#

Saat Anda siap, kenali Ailoot.