Cara Menghubungkan Hermes Agent ke Telegram: Panduan Instalasi dan Konfigurasi Bot

Ingin mengakses AI agent melalui smartphone tanpa harus selalu membuka terminal? Anda dapat menghubungkan Hermes Agent dengan Telegram agar bisa berinteraksi melalui percakapan pribadi.

Integrasi ini menggunakan Telegram Bot API dan Hermes Gateway sebagai penghubung antara pesan Telegram dan Hermes Agent yang berjalan di komputer atau server Anda.

Dalam panduan ini, kita akan membahas cara membuat bot Telegram, mengonfigurasi Hermes Agent, menguji respons pertama, dan mengamankan akses bot agar hanya pengguna yang diizinkan dapat menggunakannya.

1. Apa yang Dibutuhkan?

Sebelum memulai, pastikan Anda sudah memiliki:

1. Hermes Agent yang terinstal dan dapat menjalankan percakapan dengan model AI.
2. Akun Telegram yang aktif.
3. Akses ke terminal komputer atau VPS.
4. Koneksi internet yang dapat menjangkau Telegram Bot API.
5. Hak akses untuk mengatur konfigurasi Hermes Agent.

Jika Hermes Agent belum terinstal, baca panduan cara install Hermes Agent di Ubuntu terlebih dahulu. Sesuaikan URL internal tersebut dengan alamat artikel yang sebenarnya di website Anda.

2. Buat Bot Telegram Menggunakan BotFather

BotFather adalah bot resmi Telegram untuk membuat dan mengelola bot.

Ikuti langkah berikut:

1. Buka Telegram.
2. Cari akun resmi @BotFather.
3. Kirim perintah /newbot.
4. Masukkan nama tampilan bot, misalnya Ethan AI Assistant.
5. Tentukan username unik yang diakhiri dengan bot.
6. Simpan token yang diberikan BotFather di tempat yang aman.

Token tersebut digunakan oleh Hermes Agent untuk terhubung ke bot Telegram Anda.

Penting: jangan membagikan token bot kepada orang lain. Siapa pun yang memiliki token tersebut berpotensi mengambil alih bot. Jika token bocor, cabut atau buat ulang melalui BotFather.

3. Dapatkan Telegram User ID

Selain token bot, Anda perlu menentukan siapa yang boleh menggunakan AI agent.

Telegram User ID adalah nomor identitas numerik akun pengguna. Nilainya berbeda dari username Telegram seperti @namaanda.

Salah satu cara mendapatkannya adalah menggunakan layanan informasi ID Telegram yang tepercaya, misalnya @userinfobot.

Simpan ID numerik akun Anda. ID inilah yang nantinya digunakan dalam konfigurasi akses pengguna Hermes Agent.

Jangan memasukkan ID bot sebagai pengganti ID akun manusia yang akan mengirim pesan.

4. Konfigurasikan Telegram pada Hermes Agent

Setelah bot dibuat, kembali ke terminal pada komputer atau server tempat Hermes Agent dijalankan.

Jalankan wizard konfigurasi gateway:

hermes gateway setup

Pilih Telegram sebagai platform yang ingin dihubungkan. Ikuti instruksi untuk memasukkan token bot dan ID pengguna yang diizinkan.

Wizard akan membantu menyiapkan konfigurasi yang diperlukan. Nama menu dan pilihan yang tersedia dapat berbeda menurut versi Hermes Agent yang digunakan.

Jika Anda menggunakan versi yang mendukung pengaturan manual, konfigurasi Telegram dapat mencakup variabel berikut di file ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=GANTI_DENGAN_TOKEN_BOTTELEGRAM_ALLOWED_USERS=GANTI_DENGAN_USER_ID

Ganti nilai contoh dengan kredensial Anda yang sebenarnya. Untuk beberapa pengguna, dokumentasi Hermes Agent mendukung daftar ID yang dipisahkan dengan koma.

Jangan menempelkan token asli ke artikel, repositori publik, atau tangkapan layar.

5. Jalankan Hermes Gateway

Hermes Gateway berfungsi sebagai penghubung antara Telegram dan agent yang berjalan pada lingkungan Anda.

Untuk pengujian awal, jalankan gateway di terminal:

hermes gateway run

Periksa output terminal untuk memastikan proses berhasil terhubung ke Telegram.

Jika Anda menggunakan versi yang menyediakan perintah status, periksa dengan:

hermes gateway status

Untuk menjalankan gateway sebagai proses yang dikelola di latar belakang, ikuti metode yang sesuai dengan versi dan metode instalasi Hermes Agent Anda. Pada versi yang mendukungnya, perintah hermes gateway start dapat digunakan untuk memulai layanan.

Jangan menjalankan beberapa gateway secara bersamaan dengan token bot yang sama. Telegram dapat menolak koneksi polling yang berjalan secara bersamaan untuk bot tersebut.

6. Uji Bot Telegram Anda

Setelah gateway aktif:

1. Buka Telegram.
2. Cari username bot yang dibuat sebelumnya.
3. Tekan tombol Start jika tersedia.
4. Kirim pesan sederhana, misalnya:
5. Halo, apa yang bisa kamu bantu?
6. Tunggu respons dari Hermes Agent.

Jika bot membalas dengan benar, berarti alur dasar dari Telegram menuju gateway dan model AI sudah berfungsi.

Cobalah satu atau dua pertanyaan sederhana sebelum menambahkan fitur tambahan.

Perlu diingat, bot Telegram merupakan antarmuka untuk mengakses agent. Proses inferensi tetap bergantung pada model AI, konfigurasi provider, koneksi jaringan, dan server tempat Hermes Agent berjalan.

7. Cara Membatasi Akses Bot Telegram

Bot yang dapat menjalankan tools tidak sebaiknya dibiarkan terbuka bagi semua pengguna.

Gunakan mekanisme otorisasi yang didukung Hermes Agent, seperti allowlist atau pairing, sesuai konfigurasi versi Anda.

Untuk konfigurasi berbasis environment variable, TELEGRAM_ALLOWED_USERS digunakan untuk menentukan pengguna yang diizinkan.

Beberapa praktik yang disarankan:

1. Izinkan hanya akun yang memang membutuhkan akses.
2. Periksa kembali daftar pengguna yang diizinkan.
3. Jangan membagikan token bot di grup atau channel.
4. Hindari akses terbuka pada bot yang mempunyai akses ke terminal atau file sensitif.
5. Uji konfigurasi dengan akun yang tidak diizinkan jika memungkinkan.

Pembatasan pengguna di Telegram tidak menggantikan pembatasan hak akses pada sistem operasi. Pastikan akun Linux yang menjalankan agent juga memiliki izin minimum yang diperlukan.

8. Apakah Hermes Agent Harus Berjalan di VPS?

Tidak harus. Anda dapat menjalankan Hermes Agent pada komputer pribadi yang memenuhi kebutuhan sistem atau pada VPS Linux.

Namun, ada perbedaan penting:

Jika berjalan di komputer pribadi: bot mungkin tidak merespons ketika komputer mati, gateway berhenti, atau koneksi internet terputus.

Jika berjalan di VPS: bot dapat tetap tersedia selama server, gateway, provider model AI, dan koneksi jaringan berfungsi dengan baik.

Untuk penggunaan yang membutuhkan akses lebih konsisten, VPS dapat menjadi pilihan. Meski demikian, uptime tetap bergantung pada konfigurasi dan kondisi infrastruktur.

Baca juga panduan cara menjalankan Hermes Agent di VPS Linux, dengan menyesuaikan URL tersebut ke slug aktual website Anda.

9. Troubleshooting: Bot Telegram Tidak Merespons

Bot tidak memberikan jawaban

Periksa apakah gateway aktif dan model AI dapat menjalankan percakapan normal. Pastikan juga token bot dan konfigurasi provider sudah benar.

Pesan ditolak atau pengguna tidak diizinkan

Periksa Telegram User ID yang dimasukkan dalam allowlist. Pastikan Anda menggunakan ID akun manusia yang benar.

Gateway gagal terhubung

Periksa koneksi internet, validitas token, dan akses ke Telegram Bot API. Perhatikan pesan error yang muncul sebelum mengganti konfigurasi secara berulang.

Bot bekerja di chat pribadi tetapi tidak di grup

Periksa izin bot di grup serta pengaturan privacy melalui BotFather. Telegram memiliki aturan tersendiri mengenai pesan grup yang dapat diterima bot.

Untuk penggunaan grup, batasi akses dan pertimbangkan agar bot hanya merespons ketika disebut secara eksplisit.

Bot berhenti merespons setelah terminal ditutup

Periksa apakah gateway berjalan di foreground. Jika iya, proses dapat berhenti ketika sesi terminal berakhir. Gunakan metode pengelolaan layanan yang sesuai untuk menjalankan gateway secara berkelanjutan.

10. Tips Keamanan Sebelum Digunakan Lebih Lanjut

Sebelum menggunakan bot untuk automasi atau tugas penting, lakukan beberapa pemeriksaan:

1. Pastikan token bot disimpan dengan aman.
2. Batasi pengguna yang dapat mengirim instruksi.
3. Gunakan akun sistem operasi non-root jika memungkinkan.
4. Tinjau akses tools dan direktori yang dapat digunakan agent.
5. Jangan memberikan akses ke data sensitif yang tidak dibutuhkan.
6. Pantau log, penggunaan model AI, dan biaya provider.
7. Uji terlebih dahulu setiap integrasi tambahan pada lingkungan yang tidak sensitif.

Jika Hermes Agent digunakan untuk pekerjaan perusahaan, lakukan penilaian risiko sebelum menghubungkannya ke sistem internal, database produksi, atau layanan yang memiliki hak akses penting.

Kesimpulan

Menghubungkan Hermes Agent dengan Telegram memungkinkan Anda mengakses AI agent melalui antarmuka percakapan yang familiar.

Proses dasarnya terdiri dari membuat bot melalui BotFather, mendapatkan Telegram User ID, mengonfigurasi Hermes Gateway, lalu menguji respons pertama. Setelah berhasil, prioritaskan pengamanan token dan pembatasan pengguna sebelum menambahkan integrasi yang lebih kompleks.

Artikel terkait:

1. Cara Install Hermes Agent di Ubuntu
2. Cara Menjalankan Hermes Agent di VPS Linux
3. Cara Konfigurasi Hermes Agent dan Model AI
4. Tips Keamanan Hermes Agent: API Key, Akses Server, dan Privasi

Catatan: perintah dan opsi konfigurasi dapat berubah mengikuti versi Hermes Agent. Selalu periksa dokumentasi resmi sebelum menerapkannya pada server produksi.