Panduan Lengkap untuk Pemula
Punya AI Assistant di HP
yang Kerja Sendiri 24 Jam,
Bahkan Saat Kamu Tidur
Asisten AI mandiri yang jalan 24/7 di server pribadi kamu - bisa diperintah lewat Telegram dari mana saja. Tidak perlu pengalaman teknis, semua perintah sudah bisa langsung dicopy-paste.
9
Langkah Setup
75+
Skill Bawaan
24/7
Online di VPS
200+
Model AI via OpenRouter
Estimasi Biaya Bulanan
VPS
VPS KVM 2 (yang aku pakai)
~Rp 130rb
per bulan (12 bln)
AI Model
OpenRouter (GPT-5.4 mini)
~$2–5
tergantung intensitas pemakaian
Memori
Built-in / Honcho
Gratis
untuk built-in provider
Estimasi total per bulan
~Rp 160–200rb
* Biaya OpenRouter bisa lebih rendah jika kamu jarang pakai, atau lebih tinggi jika banyak job terjadwal berjalan. Selalu pasang credit limit di OpenRouter sebagai pengaman.
Troubleshooting
Masalah paling umum saat setup pertama - dan cara mengatasinya.
Bot Telegram tidak merespons sama sekali
Kemungkinan gateway belum jalan. Masuk ke terminal, pastikan sudah di dalam container, lalu jalankan ulang: hermes gateway run. Cek juga statusnya dengan hermes gateway status.
Muncul "Unknown Command" saat tekan Start
Ini normal dan bukan error! Hermes tidak punya perintah /start bawaan. Abaikan saja dan langsung kirim pesan biasa ke bot.
Perintah "hermes" tidak dikenali di terminal
Artinya kamu belum masuk ke dalam container. Ulangi dua perintah ini: cd /docker/hermes-agent-XXXX lalu docker compose exec -it hermes-agent /bin/bash. Harus diulang setiap buka sesi terminal baru.
Ada ikon "Red X" pada ringkasan alat
Beberapa tool butuh API key tambahan. Jalankan hermes setup tools untuk konfigurasi tool opsional, atau abaikan dulu jika belum dibutuhkan - tidak mengganggu fungsi utama Hermes.
Hermes tiba-tiba berhenti merespons
Cek saldo OpenRouter kamu di openrouter.ai - kemungkinan sudah habis atau menyentuh credit limit. Top up saldo atau naikkan limit, dan Hermes akan aktif kembali otomatis.
VPS bermasalah parah / ingin mulai dari awal
Gunakan fitur Snapshot di dashboard VPS untuk restore ke kondisi sebelumnya. Kalau belum ada snapshot, bisa wipe & redeploy VPS dari dashboard - data di luar container tidak terpengaruh. Gunakan fitur Ask AI bawaan dashboard untuk bantuan teknis lebih lanjut.
Troubleshooting Lanjutan
Error teknis spesifik yang muncul setelah Hermes jalan — biasanya terjadi di level Docker dan Gateway.
Refusing to run as root
Docker image Hermes memblokir eksekusi sebagai root untuk mencegah kerusakan permission. Solusinya jalankan sebagai user hermes:
su hermes -c "hermes gateway"
Jangan pakai HERMES_ALLOW_ROOT_GATEWAY=1 di production — bisa meninggalkan file root-owned yang merusak run berikutnya.
PermissionError: /opt/data/.env
File .env dimiliki root karena sebelumnya pernah dijalankan sebagai root. User hermes tidak bisa membacanya. Fix ownership-nya dulu:
chown hermes:hermes /opt/data/.env
Kalau ada file lain di /opt/data/ yang juga bermasalah, fix semuanya sekaligus:
chown -R hermes:hermes /opt/data/
Lalu jalankan ulang:
su hermes -c "hermes gateway"
Unauthorized user warning di Telegram
Ada user yang kirim pesan ke bot kamu tapi ID-nya tidak ada di whitelist. Tambahkan ID mereka ke TELEGRAM_ALLOWED_USERS di file .env:
grep TELEGRAM_ALLOWED_USERS /opt/data/.env
Tambahkan ID baru (ganti angkanya sesuai warning yang muncul):
sed -i 's/TELEGRAM_ALLOWED_USERS=ID_LAMA/TELEGRAM_ALLOWED_USERS=ID_LAMA,ID_BARU/' /opt/data/.env
Lalu restart gateway:
su hermes -c "hermes gateway restart"
Kalau user tersebut memang tidak berhak akses, warning ini normal dan bisa diabaikan. Hermes sudah memblokir mereka secara otomatis.
Gateway already running
Instance gateway sebelumnya masih berjalan di background. Restart saja langsung:
su hermes -c "hermes gateway restart"
Atau stop dulu baru start ulang:
su hermes -c "hermes gateway stop"
su hermes -c "hermes gateway"
Gateway mati saat terminal ditutup
Gateway ikut mati karena berjalan di foreground sesi terminal. Ada tiga cara supaya gateway tetap jalan di background:
Opsi A — Background process (paling cepat)
su hermes -c "hermes gateway restart" &
Opsi B — Screen Recommended
Gateway jalan di sesi terpisah, bisa di-detach dan di-resume kapan saja.
apt install screen -y
screen -S hermes
su hermes -c "hermes gateway"
# Detach: tekan Ctrl+A lalu D
Untuk kembali ke sesi:
screen -r hermes
Opsi C — tmux
tmux new -s hermes
su hermes -c "hermes gateway"
# Detach: tekan Ctrl+B lalu D
Untuk kembali ke sesi:
tmux attach -t hermes
FAQ
Pertanyaan yang paling sering muncul dari pengguna baru Hermes Agent.
Siap setup Hermes Agent?
Mulai dari langkah pertama - pilih VPS yang sesuai spesifikasi, sisanya ikuti panduan ini step by step.
Lihat VPS yang aku pakaiKVM 2 - 2 CPU / 8GB RAM / 100GB NVMe - cukup untuk jalan smooth