Cara Install Hermes Agent dan Hubungkan ke Telegram (2026)

Hermes Agent sedang ramai dibicarakan. Repositori GitHub-nya mencatat lebih dari 253 ribu bintang per 12 Oktober 2026, dan pencarian “hermes agent” di Indonesia menyentuh 14.800 per bulan menurut Google Keyword Planner. Tapi banyak yang berhenti di tahap “sudah ter-install, kok diam saja”. Panduan Komunitech berikut membahas pemasangan Hermes dari nol sampai bisa diajak chat lewat Telegram, termasuk jebakan provider dan risiko keamanan yang jarang disebut tutorial lain.

Apa yang Perlu Disiapkan Sebelum Install Hermes Agent

Hermes Agent adalah AI Agent open-source buatan Nous Research yang dirilis dengan lisensi MIT. Kalau kamu belum kenal fitur dan konsepnya, baca dulu penjelasan Hermes Agent: apa itu, fitur, dan biayanya. Panduan ini fokus ke pemasangan.

Tiga hal yang perlu ada sebelum mulai:

• Tempat menjalankan. Laptop bisa, tapi README resmi Hermes Agent menyebut agent ini dirancang jalan di VPS seharga $5, cluster GPU, atau infrastruktur serverless. Untuk bot Telegram yang selalu online, VPS lebih masuk akal.
• Akses ke model AI. Pilihannya API key (Anthropic, OpenRouter, Google, dan lainnya), langganan Nous Portal, atau model lokal.
• Model dengan context minimal 64 ribu token. Quickstart resmi Hermes menyebut model di bawah 64K akan ditolak saat startup. Model hosted seperti Claude, GPT, dan Gemini sudah memenuhi. Model lokal perlu diatur, misalnya -c 65536 di Ollama.

Cara Install Hermes Agent di Linux, macOS, dan Windows

Installer resmi sudah mengurus Python, Node.js, dan dependensi lain. Kamu cukup menjalankan satu perintah sesuai sistem operasi.

Linux, macOS, dan WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc    # atau source ~/.zshrc

Windows (native, tanpa WSL)

Buka PowerShell, lalu jalankan:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Instalasi Windows native tersimpan di %LOCALAPPDATA%\hermes. Alternatif lain untuk macOS dan Windows adalah installer Hermes Desktop dari situs resminya, yang memasang versi command-line sekaligus aplikasi desktop.

Kalau antivirus memblokir uv.exe

Beberapa antivirus di Windows mengkarantina uv.exe dari folder bin Hermes. README resmi menjelaskan file itu adalah uv buatan Astral, package manager Python yang dibundel Hermes, dan deteksinya false positive. README juga menyertakan langkah verifikasi lewat GitHub attestation. Kalau sudah yakin asli, whitelist foldernya, bukan hash file-nya, karena hash berubah tiap versi.

Satu catatan soal pola curl ... | bash: perintah itu menjalankan skrip dari internet langsung di mesinmu. Pastikan domainnya persis hermes-agent.nousresearch.com, bukan situs tiruan dengan nama mirip.

Memilih Provider Model: API Key, Nous Portal, atau Model Lokal

Quickstart Hermes menyebut pemilihan provider sebagai langkah paling penting. Jalankan wizard-nya:

hermes model

Hermes menyimpan secret seperti API key di ~/.hermes/.env, sedangkan setelan biasa di ~/.hermes/config.yaml. Perintah hermes config set otomatis menaruh nilai ke file yang benar.

Jalur	Cara setup	Model biaya	Cocok untuk
Nous Portal	hermes setup --portal (login OAuth)	Langganan Nous, mencakup 300+ model plus Tool Gateway	Yang malas mengumpulkan banyak API key
Anthropic (Claude) via API key	hermes model → Anthropic, isi ANTHROPIC_API_KEY	Bayar per token dari saldo Claude Console	Yang ingin kualitas Claude dan biaya terukur
Anthropic via OAuth	hermes model → OAuth login	Kredit extra usage paket Claude Max	Pelanggan Max saja, bukan Pro
OpenRouter	OPENROUTER_API_KEY di ~/.hermes/.env	Bayar per token, banyak model lewat satu key	Yang ingin gonta-ganti model
Model lokal / custom endpoint	hermes model → Custom endpoint	Biaya hardware sendiri	Data sensitif, punya GPU

Jebakan paling sering ada di baris Anthropic. Halaman provider Hermes menulis jalur OAuth Anthropic hanya jalan untuk paket Claude Max yang sudah membeli kredit extra usage, dan kuota bawaan Max tidak ikut terpakai. Pelanggan Claude Pro tidak bisa memakai jalur ini dan harus pakai API key. Cara membuat key-nya dibahas langkah demi langkah di panduan Claude API key.

Kalau sudah punya key, contoh resmi dari dokumentasi Hermes:

export ANTHROPIC_API_KEY=isi-key-kamu-di-sini
hermes chat --provider anthropic --model claude-sonnet-4-6

Uji Chat Pertama Sebelum Menambah Fitur

Quickstart Hermes punya aturan sederhana: kalau Hermes belum bisa menyelesaikan satu chat normal, jangan tambah fitur apa pun dulu. Jalankan salah satu antarmuka:

hermes          # CLI klasik
hermes --tui    # TUI modern (direkomendasikan)

Beri perintah yang hasilnya gampang dicek, misalnya “cek folder aktif dan sebutkan file utama proyeknya”. Setup dianggap berhasil kalau empat hal ini terpenuhi:

1. Banner menampilkan model dan provider yang kamu pilih.
2. Hermes membalas tanpa error.
3. Hermes bisa memakai tool kalau perlu, misalnya terminal atau baca file.
4. Percakapan bisa lanjut lebih dari satu giliran.

Setelah itu, pastikan sesi tersimpan dengan hermes --continue (atau hermes -c). Perintah itu harus membawamu kembali ke percakapan tadi.

Menghubungkan Hermes Agent ke Telegram

Gateway Hermes bisa menyambung ke Telegram, Discord, Slack, WhatsApp, Signal, dan email dari satu proses. Telegram paling sering dipakai karena pembuatan bot-nya gratis dan cepat. Ada dua cara menurut dokumentasi Telegram Hermes.

Cara cepat: QR dari dashboard atau desktop

Di dashboard atau aplikasi desktop Hermes, buka Messaging → Telegram lalu klik Create with QR. Scan kodenya di Telegram. Hermes membuatkan bot, mendeteksi user ID Telegram-mu, menulis TELEGRAM_BOT_TOKEN dan TELEGRAM_ALLOWED_USERS ke file .env, lalu me-restart gateway.

Cara manual: lewat BotFather

1. Buka @BotFather di Telegram, kirim /newbot.
2. Isi nama tampilan, lalu username unik yang diakhiri bot, misalnya tokokita_hermes_bot.
3. Salin token yang dikirim BotFather.
4. Jalankan wizard gateway dan masukkan token itu:

   hermes gateway setup
   hermes gateway start

5. Kirim pesan ke bot dari akun Telegram-mu untuk menguji.

Token bot sama sensitifnya dengan password. Siapa pun yang memegangnya bisa mengendalikan bot. Kalau bocor, cabut lewat perintah /revoke di BotFather. Pastikan juga hanya user ID tertentu yang boleh mengirim perintah, karena bot yang terbuka untuk umum berarti orang asing bisa menyuruh agent yang punya akses terminal di servermu.

Masalah yang Paling Sering Muncul dan Cara Mengatasinya

Tabel di bawah merangkum bagian Common Failure Modes dari quickstart resmi Hermes.

Gejala	Penyebab umum	Solusi
Gateway jalan tapi bot tidak membalas siapa pun	Token bot, allowlist, atau setup platform belum lengkap	Ulangi hermes gateway setup, cek hermes gateway status
hermes --continue tidak menemukan sesi lama	Pindah profil atau sesi tidak tersimpan	Cek hermes sessions list dan pastikan profilnya benar
Model tidak tersedia atau fallback aneh	Routing atau fallback terlalu agresif	Matikan routing sampai provider utama stabil
hermes doctor melaporkan masalah config	Nilai config hilang atau usang	Perbaiki config, uji ulang satu chat biasa
Model ditolak saat startup	Context model di bawah 64K token	Ganti model atau naikkan context model lokal

Kalau semuanya terasa kacau, urutan pemulihan yang disarankan quickstart Hermes adalah hermes doctor, lalu hermes model, lalu uji chat lagi, baru cek hermes gateway status.

Risiko Keamanan Hermes Agent yang Perlu Kamu Tahu

Bagian ini jarang dibahas tutorial instalasi, padahal penting. Per 12 Oktober 2026, pencarian kata kunci “hermes-agent” di National Vulnerability Database (NVD) menghasilkan 39 entri CVE, semuanya terbit sepanjang 2026. Banyak yang menyasar komponen yang justru dipakai di panduan ini: gateway platform pesan, tool terminal, dan pengelolaan kredensial.

Contohnya CVE-2026-10548, celah autentikasi di sinkronisasi kredensial Anthropic pada versi sampai 2026.4.23, dengan skor CVSS 5,3 (MEDIUM). Ada juga CVE-2026-18773 di pengecekan akses perintah gateway versi sampai 2026.6.5, skor 6,3 (MEDIUM). Empat entri yang kami periksa skornya berkisar 4,3 sampai 6,3. Beberapa deskripsi NVD menyebut vendor tidak merespons laporan, tapi deskripsi itu ditulis saat CVE terbit dan belum tentu mencerminkan status perbaikan sekarang.

Langkah praktis yang bisa langsung dilakukan:

• Update rutin dengan hermes update. Rilis terbaru per 12 Oktober 2026 adalah v0.21.7.
• Batasi pengguna lewat TELEGRAM_ALLOWED_USERS atau allowlist platform lain.
• Jalankan di lingkungan terisolasi. Hermes mendukung backend terminal Docker, jadi perintah agent tidak menyentuh sistem host langsung.
• Pisahkan API key khusus untuk Hermes dan pasang spend limit di provider.

Pola risikonya bukan khas Hermes. Agent apa pun yang bisa menjalankan perintah terminal dan menerima pesan dari luar menghadapi masalah serupa. Ringkasan risikonya ada di artikel keamanan AI Agent dan cara mitigasinya.

Hermes Agent vs OpenClaw: Kapan Pilih yang Mana

Pertanyaan ini wajar muncul karena fungsi keduanya mirip: AI Agent self-hosted yang bisa diajak chat lewat Telegram dan menjalankan tugas terjadwal. Hermes bahkan menyediakan perintah hermes claw migrate khusus untuk pindahan dari OpenClaw.

Aspek	Hermes Agent	OpenClaw
Pembuat	Nous Research	Komunitas open-source
Ciri khas	Learning loop: membuat dan memperbaiki skill dari pengalaman	Gateway multi-channel dan ekosistem skill ClawHub
Jalur model “satu pintu”	Nous Portal (langganan)	Router seperti OpenRouter atau 9Router
Instalasi	Skrip satu baris, desktop app, Termux	npm, Docker, atau standalone

Komunitech memakai dan mengajarkan OpenClaw sebagai dasar AI Agent di workshop, jadi kami lebih mengenal ekosistemnya. Itu juga berarti perbandingan di atas tidak sepenuhnya netral. Hermes jelas lebih unggul kalau kamu ingin agent yang belajar dari kebiasaanmu sendiri tanpa banyak konfigurasi. Perbandingan OpenClaw dengan framework lain ada di artikel kompetitor OpenClaw.

Pertanyaan yang Sering Ditanya

Apakah Hermes Agent bisa jalan di HP Android?

Bisa untuk perangkat aarch64 lewat Termux. Nous Research menyediakan repositori APT bertanda tangan dengan kanal stable dan canary, lengkap dengan Python, Node.js, dan TUI. Panduannya terpisah dari installer desktop dan server.

Apakah data percakapan dikirim ke Nous Research?

Kalau kamu memakai API key provider sendiri, percakapan dikirim ke provider itu, misalnya Anthropic atau OpenRouter. Kalau memakai Nous Portal, request lewat server Nous dan membawa tag versi klien Hermes untuk telemetri. Untuk data paling sensitif, model lokal adalah satu-satunya jalur yang tidak meninggalkan servermu.

Kenapa bot Telegram tidak membalas pesan yang dikirim saat server mati?

Secara bawaan Hermes membuang antrean pesan lama saat start dari kondisi mati total. Kalau servermu sering dimatikan, ubah setelan drop_pending_on_cold_boot menjadi false di konfigurasi Telegram agar pesan yang tertunda diproses saat menyala.

Bisakah Hermes memakai lebih dari satu provider sekaligus?

Bisa. Hermes mendukung routing dan fallback antar provider, plus model terpisah untuk tugas tambahan seperti ringkasan dan vision. Quickstart resmi menyarankan fitur ini baru dinyalakan setelah provider utama terbukti stabil.

Berapa biaya menjalankan Hermes Agent per bulan?

Software-nya gratis. Biaya datang dari server (README menyebut VPS $5 sudah cukup untuk mulai) dan pemakaian model. Hermes bisa memanggil model beberapa kali dalam satu giliran chat, jadi tagihan API cenderung lebih besar dari perkiraan per pesan.

Kesimpulan

Memasang Hermes Agent itu cepat. Yang memakan waktu biasanya salah urutan: menyambungkan Telegram sebelum chat dasar jalan, atau memilih login Anthropic padahal langganannya Pro. Ikuti urutan install, pilih provider, uji chat, sambungkan gateway, lalu kunci aksesnya. Catatan 39 CVE di NVD jadi alasan kuat untuk update rutin dan membatasi siapa yang boleh mengobrol dengan bot.

Kalau sedang menimbang Hermes atau OpenClaw untuk otomasi bisnis, kamu bisa berdiskusi dengan sesama pembangun AI Agent di grup Telegram Komunitech.

Referensi

• NousResearch, README hermes-agent (GitHub): https://github.com/NousResearch/hermes-agent
• Hermes Agent Docs, “Quickstart”: https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• Hermes Agent Docs, “LLM and Model Providers”: https://hermes-agent.nousresearch.com/docs/integrations/providers
• Hermes Agent Docs, “Telegram”: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram
• NIST National Vulnerability Database, pencarian “hermes-agent”: https://nvd.nist.gov/vuln/search

Disclaimer

Perintah, versi, jumlah bintang GitHub, dan jumlah CVE dicek pada 12 Oktober 2026. Hermes Agent rilis sangat sering, jadi nama perintah dan opsi bisa berubah. Selalu cocokkan dengan dokumentasi resmi Hermes sebelum memasang di server produksi.

Artikel telah diupdate pada 13/10/2026 untuk memastikan artikel tetap sesuai kondisi terkini.