Panduan Bikin Bot Telegram & Integrasi Hermes Agent Lengkap

Pelajari cara membuat bot Telegram dari nol dan mengintegrasikannya dengan Hermes Agent untuk respons AI yang cerdas. Panduan langkah demi langkah dengan contoh kode Python.

Apa Itu Hermes Agent?

Hermes Agent adalah platform AI agent open-source (MIT License) buatan Nous Research — lab di balik model Hermes, Nomos, dan Psyche. Bukan sekadar chatbot wrapper, Hermes adalah agen otonom yang:

Berjalan di server Anda sendiri (data tetap lokal)
Terhubung ke Telegram, Discord, Slack, WhatsApp, Signal, Email, dan CLI
Memiliki persistent memory & auto-generate skill (semakin lama dipakai, semakin pintar)
Mendukung cron job bahasa natural, delegasi sub-agent, dan sandboxing (Docker/SSH/Singularity)
Bisa mengakses web, browser, vision, image generation, dan text-to-speech

Dengan integrasi Telegram, Anda bisa ngobrol dengan agent AI Anda langsung dari HP — seperti punya asisten pribadi 24/7. Artikel ini adalah panduan lengkap bikin bot Telegram + integrasi Hermes Agent dari nol sampai production-ready.

Prasyarat

1. Server Linux atau VPS

Hermes Agent membutuhkan Linux. Spesifikasi minimum:

CPU: 2 vCPU
RAM: 4-8 GB (8 GB direkomendasikan untuk Docker sandbox)
Storage: 20 GB SSD
OS: Ubuntu 22.04/24.04, Debian 12, atau macOS

Windows user? Harus pakai WSL2. Aktifkan Virtual Machine Platform & Windows Subsystem for Linux di Turn Windows Features, restart, lalu jalankan wsl --install.

2. Python 3.8+

Verifikasi: python3 --version. Jika belum ada: sudo apt install python3 python3-pip -y.

3. Akun Telegram

Akun Telegram aktif untuk membuat bot via BotFather.

4. API Key LLM Provider

Hermes tidak menjalankan inference sendiri — ia memanggil model eksternal. Pilih salah satu:

OpenRouter (termudah, banyak model)
Nous Portal (official, model Hermes 3)
OpenAI / Anthropic / Groq
Custom endpoint (ollama, vLLM lokal)

Langkah 1: Install Hermes Agent

Gunakan script instalasi resmi:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Saat instalasi menanyakan apakah ingin menginstall ripgrep dan build tools, ketik Y — diperlukan untuk file searching dan eksekusi skill.

Verifikasi instalasi berhasil:

hermes --version

Selesai instalasi, reload environment:

source ~/.bashrc

Langkah 2: Konfigurasi Dasar

Jalankan setup wizard:

hermes setup

Wizard akan menanyakan:

LLM Provider — pilih provider Anda (OpenRouter, Nous Portal, dll)
API Key — masukkan API key provider
Model — rekomendasi: anthropic/claude-sonnet-4 atau nousresearch/hermes-3
Messaging — skip dulu, kita setup manual

Konfigurasi disimpan di ~/.hermes/config.yaml dan ~/.hermes/.env.

Langkah 3: Buat Bot Telegram

3a. Dapatkan Bot Token

Buka Telegram, cari @BotFather
Kirim /newbot
Ikuti petunjuk: beri nama bot (contoh: "Asisten Hermes"), lalu username bot (harus berakhiran bot, contoh: asisten_hermes_bot)
BotFather akan memberikan Bot Token — format: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
⚠️ Simpan token aman. Jika bocor, revoke via /revoke di BotFather

3b. Opsional: Kustomisasi Bot

Kirim perintah berikut ke BotFather:

/setdescription - Atur deskripsi bot
/setabouttext   - Atur teks "About"
/setuserpic     - Atur foto profil bot
/setcommands    - Atur daftar command

Contoh command suggestion:

help    - Tampilkan bantuan
new     - Mulai percakapan baru
sethome - Set chat ini sebagai home channel

3c. Dapatkan User ID

User ID diperlukan untuk whitelist akses. Chat @userinfobot atau @get_id_bot, kirim /start. Catat angka yang muncul (contoh: 123456789).

Langkah 4: Hubungkan Telegram ke Hermes

4a. Interactive Setup (Direkomendasikan)

hermes gateway setup

Pilih Telegram, masukkan Bot Token dan User ID yang diizinkan.

4b. Manual Setup

Edit ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

⚠️ Tanpa whitelist, siapa pun yang tahu username bot Anda bisa mengakses agent — termasuk terminal server!

Langkah 5: Jalankan Gateway

hermes gateway

Setelah beberapa detik, log akan menampilkan:

[telegram] Connected to Telegram (polling mode)

Sekarang kirim pesan ke bot Telegram Anda — agent akan merespons!

Tips: Gunakan tmux atau screen agar gateway tetap berjalan setelah SSH terputus:

sudo apt install tmux -y
tmux new -s hermes
hermes gateway
# Tekan Ctrl+B lalu D untuk detach

Atau buat systemd service untuk auto-start saat boot.

Langkah 6: Voice Messages (Opsional)

Hermes Agent mendukung voice message via Telegram:

Speech-to-Text: Kirim voice note → agent auto-transcribe lalu proses sebagai teks
Text-to-Speech: Agent bisa membalas dengan voice bubble (perlu ffmpeg untuk konversi Opus)

Nonaktifkan STT (agent terima path file audio mentah):

# ~/.hermes/config.yaml
stt:
  enabled: false

Langkah 7: Group Chat (Opsional)

Tambahkan bot ke grup Telegram. Secara default, Privacy Mode ON — bot hanya melihat command dan pesan yang mention/reply ke bot.

Untuk mengizinkan bot melihat semua pesan grup:

BotFather → /mybots → pilih bot → Bot Settings → Group Privacy → Turn off
Keluarkan bot dari grup, lalu tambahkan kembali

Konfigurasi ~/.hermes/config.yaml:

platforms:
  telegram:
    allowed_chats:
      - "-1001234567890"  # ID grup
    require_mention: true   # hanya respon jika di-mention

Langkah 8: Home Channel & Cron

Set home channel agar hasil cron job terkirim otomatis ke Telegram:

/sethome

Kirim command ini di DM bot. Sekarang cron job bisa deliver hasil langsung ke Telegram:

hermes cron create --schedule "0 7 * * *" --prompt "Buat ringkasan berita pagi ini"

Langkah 9: Webhook Mode (Cloud Deployment)

Untuk deployment di Fly.io, Railway, atau cloud yang mendukung sleep-when-idle, gunakan webhook alih-alih polling:

# ~/.hermes/.env
TELEGRAM_WEBHOOK_URL=https://my-app.fly.dev/telegram
TELEGRAM_WEBHOOK_SECRET=$(openssl rand -hex 32)

Restart gateway — log akan menunjukkan [telegram] Connected to Telegram (webhook mode).

Langkah 10: Keamanan (PENTING!)

10a. Whitelist User

Pastikan TELEGRAM_ALLOWED_USERS hanya berisi ID Anda. Akun Telegram yang dikompromikan = akses shell ke server.

10b. Docker Backend

Isolasi terminal agent dalam container Docker:

hermes config set terminal.backend docker

Lebih lambat saat start, tapi blast radius terbatas.

10c. Batasi BotFather

Di BotFather → /mybots → Bot Settings:

Allow Groups? → Disable (kecuali butuh)
Group Privacy → ON (default)

10d. Environment Variables

Jangan hardcode token di file. Simpan di ~/.hermes/.env dengan permission 600:

chmod 600 ~/.hermes/.env

Troubleshooting

Bot tidak merespons

Cek log: hermes gateway (jalan di foreground untuk lihat error)
Pastikan token benar — cek ulang di BotFather
Pastikan User ID sudah di-whitelist

Command not found: hermes

source ~/.bashrc
# Atau gunakan path absolut:
~/.hermes/bin/hermes gateway

Bot mati setelah SSH terputus

Gunakan tmux (lihat Langkah 5) atau buat systemd service.

Error: "Token is invalid" / "401 Unauthorized"

Token sudah di-revoke atau salah format. Generate token baru via BotFather /mybots → API Token → Revoke current token.

Kesimpulan

Dengan mengikuti panduan bikin bot Telegram & integrasi Hermes Agent ini, Anda sekarang memiliki agen AI otonom yang bisa diakses dari HP via Telegram. Semua data tetap di server Anda (tidak dikirim ke pihak ketiga), dan agent akan semakin pintar seiring penggunaan berkat persistent memory dan auto-generated skills.

Yang sudah Anda setup:

✅ Hermes Agent terinstall dan terkonfigurasi
✅ Bot Telegram terhubung via gateway
✅ Whitelist keamanan aktif
✅ Voice messages, group chat, home channel siap pakai
✅ Siap production dengan webhook atau systemd

Referensi: Dokumentasi Resmi Hermes Agent