Selamat datang di panduan deploy Hermes Agent di Lighthouse!
Artikel ini termasuk dalam kolom: Menguasai Lighthouse
๐ Belum punya server cloud? Klik di sini untuk menikmati Penawaran Eksklusif Lighthouse dan deploy Hermes Agent dengan cepat~
Pada April 2026, Nous Research secara resmi merilis proyek AI Agent open-source Hermes Agent, yang dengan cepat mendapatkan perhatian luas di GitHub dan komunitas AI. Berbeda dengan asisten coding yang terikat pada IDE atau chatbot single-API di pasaran, Hermes Agent adalah Agen Otonom sejatiโberjalan di server Anda, memiliki memori persisten, dan menjadi semakin kuat seiring waktu. Yang lebih menarik lagi, ia memiliki loop pembelajaran mandiri yang lengkap: secara otonom membuat skill, meningkatkan skill melalui penggunaan, dan mengingat memori lintas sesi, benar-benar menjadi "semakin cerdas semakin sering digunakan."
Hermes Agent memiliki hubungan mendalam dengan proyek OpenClaw yang sebelumnya populerโbahkan menyertakan perintah bawaan hermes claw migrate, yang mendukung migrasi satu klik pengaturan, memori, skill, dan API key OpenClaw. Hermes Agent merepresentasikan evolusi komprehensif di bidang AI Agent.
Mirip dengan OpenClaw, Hermes Agent juga memiliki izin operasi sistem penuh (eksekusi terminal, baca/tulis file, otomatisasi browser, dll.), jadi rekomendasi resmi adalah untuk deploy di lingkungan yang terisolasi dari komputer pribadi utama Anda untuk memastikan keamanan data.
Hermes Agent mendukung platform Linux, macOS, WSL2, dan Android (Termux), dengan Linux sebagai lingkungan deployment yang paling direkomendasikan. Deploy Hermes Agent di server cloud tidak hanya mencapai isolasi aman dari komputer lokal Anda tetapi juga memungkinkan ketersediaan online 24/7, memungkinkan Anda berinteraksi dengannya kapan saja, di mana saja melalui aplikasi chat seperti Telegram dan Discord.
Catatan: Hermes Agent saat ini tidak mendukung lingkungan Windows native. Pengguna Windows perlu menginstal WSL2 terlebih dahulu dan menjalankannya di sana.
Tencent Cloud Lighthouse adalah produk server cloud yang dirancang untuk skenario aplikasi ringan. Tidak memerlukan pemahaman konsep cloud computing yang kompleks dan menawarkan paket server yang hemat biaya.
Dibandingkan dengan menjalankan di komputer lokal, deploy Hermes Agent menggunakan server Lighthouse memiliki keuntungan berikut:
| Keuntungan | Deskripsi |
|---|---|
| Mulai Cepat | Selesaikan deployment hanya dalam beberapa menit |
| Hemat Biaya | Mulai pengalaman hanya dengan puluhan dolar |
| Online 24/7 | Dukungan native untuk operasi sepanjang waktu, berinteraksi dengan Hermes Agent melalui aplikasi chat kapan saja |
| Isolasi Aman | Lingkungan cloud terisolasi kuat dari komputer lokal, melindungi keamanan data pribadi |
Kunjungi halaman pembelian produk Tencent Cloud Lighthouse untuk membeli server. Konfigurasi yang direkomendasikan:
Klik Beli Sekarang, ikuti panduan halaman untuk menyelesaikan pembayaran, dan tunggu sekitar 30 detik untuk menyelesaikan pembuatan server.

Catatan: Menginstal ulang sistem akan menghapus semua data di server. Harap lanjutkan dengan hati-hati!

Jika Anda memiliki instance Lighthouse idle yang ada, Anda dapat memilih image Hermes Agent melalui "Instal Ulang Sistem," kemudian konfigurasikan Hermes Agent mengikuti langkah-langkah selanjutnya.
Sebelum mengonfigurasi model, Anda perlu memperoleh kunci API (API Key) dari platform MiniMax. Kunci API berfungsi sebagai "kunci" yang memungkinkan Hermes Agent memanggil model bahasa besar MiniMax.
Buka Platform Terbuka MiniMax - Halaman Kunci API di browser Anda.
Daftar atau masuk ke akun MiniMax Anda (jika belum masuk, halaman akan secara otomatis dialihkan ke antarmuka masuk).
Setelah masuk ke halaman, klik "Buat Kunci API", dan masukkan nama kunci di jendela pop-up:


Sistem akan menghasilkan string kunci yang dimulai dengan sk-api-, mirip dengan sk-api-YyVAdYTmxxxxxxxxxxxxxxxxxxxx.
Penting: Segera salin dan simpan kunci ini dengan aman. Setelah halaman ditutup, Anda tidak akan dapat melihat kunci lengkapnya lagi.

Penting: Pastikan saldo akun MiniMax Anda tidak nol. Jika saldo akun nol, meskipun konfigurasi kunci API benar, Hermes Agent tidak akan dapat memanggil model untuk percakapan secara normal. Anda dapat memeriksa dan mengisi ulang saldo di Pusat Biaya MiniMax - Halaman Saldo.
hermes setup untuk Mengonfigurasi ModelSekarang kembali ke terminal server dan jalankan perintah berikut untuk memulai wizard konfigurasi interaktif Hermes Agent:
hermes setup
Setelah dieksekusi, terminal akan menampilkan antarmuka wizard konfigurasi seperti berikut:

Karena ini adalah instalasi pertama, wizard akan meminta Anda memilih mode konfigurasi. Gunakan tombol panah atas/bawah keyboard untuk memilih Quick setup โ provider, model & messaging (recommended) (Konfigurasi cepat, direkomendasikan), lalu tekan Enter untuk mengonfirmasi.
Selanjutnya, wizard akan menampilkan daftar penyedia model (Provider) yang mencakup semua penyedia layanan model yang didukung oleh Hermes Agent.
Gunakan tombol panah atas/bawah untuk menggulir daftar, pilih More providers... dan tekan Enter.

Temukan dan pilih MiniMax (China), lalu tekan Enter untuk mengonfirmasi pilihan.

Penjelasan: MiniMax dan MiniMax (China) adalah dua opsi yang berbeda. MiniMax (China) sesuai dengan situs domestik MiniMax. Jika Anda menggunakannya di dalam China dan memperoleh kunci API dari situs MiniMax China, silakan pilih opsi ini.
Setelah memilih penyedia, wizard akan meminta Anda memasukkan kunci API MiniMax China:
MiniMax CN API key:
Tempel kunci API yang Anda salin di langkah dua di sini (untuk menempel di terminal: klik kanan, atau tekan Ctrl+Shift+V), lalu tekan Enter untuk mengonfirmasi.
Catatan: Untuk keamanan, tidak ada karakter (termasuk asterisk) yang akan ditampilkan di layar saat memasukkan kunci. Ini normal. Langsung tempel dan tekan Enter.

Setelah berhasil dimasukkan, terminal akan menampilkan informasi konfirmasi yang mirip dengan berikut:
API Key Saved.

Pada titik ini, informasi Base URL juga akan ditampilkan. Tekan Enter saja:

Setelah kunci API berhasil disimpan, wizard akan menampilkan daftar model yang didukung oleh MiniMax China:
-> MiniMax-M2
MiniMax-M2.5
MiniMax-M2.7
MiniMax-M2.7-highspeed
MiniMax-M2.1
MiniMax-M2.5-highspeed
Enter custom model name
Skip (keep current)
Gunakan tombol panah atas/bawah untuk memilih model yang ingin Anda gunakan. Disarankan untuk memilih MiniMax-M2.7 (versi terbaru, kemampuan terkuat), lalu tekan Enter untuk mengonfirmasi.

Setelah dikonfirmasi, wizard akan menampilkan informasi konfirmasi yang mirip dengan:
โ Default model set to: MiniMax-M2.7
Setelah konfigurasi model selesai, wizard akan menanyakan apakah Anda ingin menghubungkan platform perpesanan:
Connect a messaging platform? (Telegram, Discord, etc.)
โ Set up messaging now (recommended)
โ Skip โ set up later with 'hermes setup gateway'
Di sini kita pilih Skip โ set up later with 'hermes setup gateway' (konfigurasi nanti), dan tekan Enter untuk melewati.
PS: Kami akan mengonfigurasi WeChat Work melalui baris perintah di langkah selanjutnya.

Wizard akan menampilkan ringkasan penyelesaian konfigurasi dan menanyakan apakah akan segera menghubungkan Hermes untuk percakapan:

Kami lanjutkan dengan langkah berikutnya.
Sebelum melanjutkan mengonfigurasi WeChat Work, kita dapat terlebih dahulu memverifikasi apakah model dikonfigurasi dengan benar melalui baris perintah. Hermes Agent menyediakan antarmuka chat baris perintah bawaan (TUI) yang memungkinkan percakapan langsung dengan Agent di terminal.
Di sini kita masukkan Y di baris perintah, lalu tekan Enter.

Atau nanti Anda dapat langsung menjalankan di terminal:
hermes
Jika model dikonfigurasi dengan benar, Anda akan melihat antarmuka sambutan Hermes Agent, dan bagian bawah akan menampilkan informasi model yang sedang digunakan (misalnya, MiniMax-M2.7 via minimax-cn).


Masukkan pesan sederhana di kotak input untuk menguji, misalnya:
Halo, tolong perkenalkan diri Anda

Tekan Enter untuk mengirim. Jika semuanya normal, Hermes Agent akan menghasilkan respons melalui model MiniMax dan menampilkannya di terminal.

Jika Anda mengalami pesan kesalahan (seperti API key invalid atau waktu tunggu koneksi), harap periksa:
hermes doctor untuk diagnosis)Setelah verifikasi berhasil, masukkan /quit dan tekan Enter untuk keluar dari antarmuka TUI dan kembali ke baris perintah.
/quit

Sistem gateway Hermes Agent mendukung integrasi dengan 15+ platform perpesanan utama, termasuk WeCom (WeChat Work), DingTalk, Feishu (Lark) yang umum digunakan di dalam negeri, serta platform luar negeri seperti Telegram, Discord, Slack, WhatsApp, dll. Satu proses latar belakang dapat secara bersamaan terhubung ke semua platform yang dikonfigurasi. Perbandingan fitur setiap platform adalah sebagai berikut:
| Platform | Suara | Gambar | File | Thread | Output Streaming |
|---|---|---|---|---|---|
| CLI (Baris Perintah) | โ | โ | โ | โ | โ |
| WeCom (WeChat Work) | โ | โ | โ | โ | โ |
| DingTalk | โ | โ | โ | โ | โ |
| Feishu/Lark | โ | โ | โ | โ | โ |
| Telegram | โ | โ | โ | โ | โ |
| Discord | โ | โ | โ | โ | โ |
| Slack | โ | โ | โ | โ | โ |
| โ | โ | โ | โ | โ | |
| Signal | โ | โ | โ | โ | โ |
| โ | โ | โ | โ | โ |
Di bawah ini, kita akan menggunakan Telegram sebagai contoh untuk mendemonstrasikan cara mengonfigurasi gateway langkah demi langkah.
Berdasarkan semua materi yang dicari dan konten tangkapan layar sebelumnya, berikut adalah konten tutorial Markdown yang disiapkan untuk bagian Sambungkan Telegram:
WeCom adalah salah satu alat pesan instan tingkat perusahaan yang paling umum digunakan di China. Hermes Agent secara native mendukung koneksi ke WeCom melalui WebSocket, tidak memerlukan alamat IP publik, tidak memerlukan alamat callback Webhook, dengan konfigurasi sederhana.
Setelah verifikasi model berhasil, kita perlu mengonfigurasi WeCom sebagai saluran chat, sehingga Anda dapat berbicara dengan Hermes Agent seperti mengirim pesan WeChat.
Buka Konsol Manajemen WeCom di browser Anda.
Masuk menggunakan pemindaian kode QR WeCom (Anda perlu memiliki izin administrator untuk organisasi WeCom).
Tip: Jika Anda belum memiliki organisasi WeCom, Anda dapat mendaftar satu secara gratis. Kunjungi Situs Web Resmi WeCom, klik "Daftar Sekarang", dan ikuti proses untuk membuat organisasi.

Setelah masuk ke konsol manajemen, temukan dan klik Keamanan & Manajemen di bilah menu kiri.

Klik Alat Manajemen, lalu pilih Robot Cerdas di Zona Cerdas.

Pada halaman pembuatan, klik tombol Buat Robot.

Di jendela pop-up, pilih Pembuatan Manual.

Pada halaman Buat Robot Cerdas, klik tombol edit, dan di jendela pop-up berikutnya, isi avatar robot, nama (misalnya, "Hermes"), dan informasi deskripsi secara berurutan.

Gulir ke kanan bawah halaman, pilih Pembuatan Mode API.

Di halaman berikutnya, konfigurasi cakupan terlihat sesuai kebutuhan.

Dalam konfigurasi API, temukan Secret, dan klik tombol Klik untuk Mendapatkan di sebelahnya:

Dalam izin yang tersedia, pilih Pesan (izin lain dapat diberikan sesuai kebutuhan):

Setelah pemberian izin selesai, kembali ke halaman dan klik tombol Simpan.

Setelah pembuatan selesai, masuk ke halaman detail robot tersebut, Anda akan melihat dua informasi kunci berikut:
Harap salin dan simpan kedua nilai ini dengan aman, karena akan diperlukan nanti saat mengonfigurasi Hermes Agent.

Tip Keamanan: Secret setara dengan kata sandi robot. Harap jangan bocorkan kepada orang lain.
Kembali ke terminal server. Kita perlu mengonfigurasi WeCom Bot ID dan Secret yang baru saja diperoleh ke dalam Hermes Agent.
Semua informasi sensitif untuk Hermes Agent (seperti kunci API, kredensial Bot, dll.) disimpan dalam file ~/.hermes/.env. Kita dapat menggunakan perintah berikut untuk menulis kredensial WeCom satu per satu.
Jalankan perintah berikut di terminal (ganti your-bot-id dengan Bot ID sebenarnya yang Anda salin di langkah 5.3):
hermes config set WECOM_BOT_ID your-bot-id
Misalnya, jika Bot ID Anda adalah bot_abc123xyz, perintahnya adalah:
hermes config set WECOM_BOT_ID bot_abc123xyz
Jalankan perintah berikut (ganti your-secret dengan Secret sebenarnya yang Anda salin di langkah 5.3):
hermes config set WECOM_SECRET your-secret

Anda dapat membatasi pengguna mana yang dapat mengirim pesan pribadi ke Hermes Agent dengan mengatur WECOM_DM_POLICY. Di sini, atur ke pairing.
Dengan cara ini, ketika pengguna yang tidak sah mengirim pesan pribadi ke Bot Anda, itu tidak akan langsung membuka percakapan tetapi akan memicu proses verifikasi kode pairingโBot akan mengirim kode pairing satu kali ke pihak lain, dan Anda perlu mengonfirmasinya di sisi server sebelum dapat lolos.
hermes config set WECOM_DM_POLICY pairing

Anda dapat membatasi pengguna WeCom mana yang dapat berbicara dengan Hermes Agent dengan mengatur WECOM_ALLOWED_USERS:
hermes config set WECOM_ALLOWED_USERS your_user_id
Jika mengizinkan beberapa pengguna, pisahkan dengan koma bahasa Inggris:
hermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2
Cara mendapatkan ID pengguna WeCom: Di Konsol Manajemen WeCom โ Kontak โ Klik pada anggota โ Lihat bidang "Akun", yang merupakan ID pengguna.
Jika Anda tidak memerlukan pembatasan akses untuk sementara (hanya untuk pengujian pribadi), Anda dapat melewatkan langkah ini. Secara default, semua anggota WeCom yang dapat menghubungi Bot ini dapat berbicara dengannya (memerlukan pairing).
Tip: Jika Anda ingin semua pengguna WeCom dapat berinteraksi dengan Bot, Anda dapat mengeksekusi
hermes config set GATEWAY_ALLOW_ALL_USERS true. Jika hanya ingin mengizinkan pengguna tertentu untuk mengakses, Anda dapat mengatur daftar putih melaluihermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2.
Setelah semua konfigurasi selesai, kita perlu memulai gateway pesan Hermes Agent, yang bertanggung jawab untuk menerima dan mengirim pesan WeCom.
Agar Hermes Agent berjalan terus menerus di latar belakang dan mulai secara otomatis setelah reboot server, disarankan untuk menginstal gateway sebagai layanan sistem:
hermes gateway install

Setelah instalasi selesai, mulai layanan:
hermes gateway start

Anda dapat memeriksa status berjalan layanan gateway kapan saja dengan perintah berikut:
hermes gateway status

Saat ini, Hermes Agent Anda sepenuhnya dikonfigurasi dan berjalan di latar belakang.
Sekarang kita kembali ke backend WeCom. Kita dapat memperoleh dan memindai kode QR robot untuk menambahkannya ke dialog chat:

Setelah mengirim pesan apa pun di WeCom, Anda akan melihat pesan pairing:

Salin perintah terakhir dari pesan pairing, kembali ke baris perintah server, tempel, dan tekan Enter. Setelah melihat informasi berikut, ini menunjukkan pairing selesai.

Sekarang kembali ke WeCom, dan Anda dapat mulai bercakap-cakap dengan Hermes Agent!

Jika Anda mengalami pesan serupa dengan ๐ฌ No home channel is set for Wecom. A home channel is where Hermes delivers cron job results and cross-platform messages., Anda dapat langsung mengirim /sethome di dialog chat untuk menyelesaikannya.
Tip Keamanan: WebUI Hermes Agent tidak menyediakan kemampuan otentikasi. Siapa pun yang mengetahui alamat akses dapat langsung mengoperasikan Agent Anda. Kami sangat tidak merekomendasikan mengaktifkan WebUI sendiri dan mengaksesnya melalui jaringan publik.
Anda dapat lebih lanjut mengonfigurasi kebijakan akses WeCom di ~/.hermes/config.yaml, seperti membatasi grup mana yang dapat menggunakan Bot, mengatur daftar putih pengguna dalam grup, dll.:
platforms:
wecom:
enabled: true
extra:
dm_policy: "open" # Kebijakan chat pribadi: open/allowlist/disabled
group_policy: "allowlist" # Kebijakan chat grup: open/allowlist
group_allow_from: # Daftar ID grup yang diizinkan
- "group_id_1"
Gejala: Setelah menjalankan perintah pairing yang disediakan dalam pesan WeCom di terminal server, pesan muncul:
Code 'XXXXXXXX' not found or expired for platform 'wecom'.
Run 'hermes pairing list' to see pending codes.
Penyebab: Kode pairing memiliki periode validitas (1 jam). Mungkin telah kedaluwarsa atau berubah saat Anda menyalin perintah.
Solusi:
hermes pairing list
XXXXXXXX):Pending Pairing Requests (1):
Platform Code User ID Name Age
-------- ---- ------- ---- ---
wecom XXXXXXXX JIAYU JIAYU 1m ago
hermes pairing approve wecom XXXXXXXX
Ganti XXXXXXXX dengan kode pairing aktual yang Anda lihat di daftar.
Setelah menyelesaikan konfigurasi di atas, Anda mungkin memerlukan perintah berikut untuk mengelola Hermes Agent:
| Perintah | Deskripsi |
|---|---|
hermes |
Langsung chat dengan Hermes Agent di terminal (antarmuka TUI) |
hermes gateway |
Mulai gateway pesan di latar depan |
hermes gateway start |
Mulai layanan gateway latar belakang |
hermes gateway stop |
Hentikan layanan gateway latar belakang |
hermes gateway status |
Periksa status layanan gateway |
hermes setup |
Jalankan ulang wizard konfigurasi |
hermes setup model |
Hanya konfigurasi ulang model/penyedia |
hermes setup gateway |
Hanya konfigurasi ulang platform chat |
hermes model |
Ganti model |
hermes doctor |
Diagnosa masalah konfigurasi |
hermes update |
Perbarui ke versi terbaru |
hermes config |
Lihat konfigurasi saat ini |
Setelah konfigurasi selesai, gunakan perintah berikut untuk mengelola layanan gateway:
# Jalankan di latar depan (cocok untuk debugging)
hermes gateway
# Mulai di latar belakang
hermes gateway start
# Periksa status berjalan
hermes gateway status
# Hentikan gateway
hermes gateway stop
Tip: Satu proses gateway dapat secara bersamaan terhubung ke semua platform yang dikonfigurasi (WeCom, Telegram, Discord, dll.), tidak perlu memulai layanan terpisah untuk setiap platform.
Discord telah dibuat, dan semua orang dipersilakan untuk bergabung dan menjelajahi cara-cara canggih menggunakan Hermes Agent bersama-sama!

Buka tips lanjutan di Discord
Klik untuk bergabung dengan komunitas
Catatan: Setelah bergabung, Anda dapat mendapatkan template plugin terbaru dan playbook deployment
Bergabung dengan WhatsApp / WeCom untuk dukungan teknis khusus
| Channel | Scan / Klik untuk bergabung |
|---|---|
| Channel WhatsApp | ![]() |
| WeCom (Enterprise WeChat) | ![]() |