Hermes Relay — Hubungkan Instance | Easy Understand Hermes Agent

Bayangkan Hermes Relay seperti telepon umum yang menghubungi Anda kembali — Anda tidak perlu memberikan alamat rumah, Anda cukup menelepon sekali, dan pihak lain dapat menghubungi Anda kapan saja melalui saluran yang sama.

Apa Itu Hermes Relay?

Hermes Relay adalah sistem konektor untuk gateway Hermes Agent. Ini memungkinkan gateway Anda berbicara dengan platform perpesanan seperti Discord, Telegram, atau Slack tanpa menyimpan token bot atau kata sandi mereka.

Sebagai gantinya, layanan terpisah (yaitu “konektor”) yang memiliki kredensial tersebut. Gateway Anda cukup melakukan panggilan keluar ke konektor melalui satu koneksi WebSocket yang aman — dan kemudian semua pesan mengalir bolak-balik melalui satu saluran terbuka tersebut.

Mengapa Ini Berguna?

Berikut keuntungan utamanya, dalam bahasa yang sederhana:

Tidak perlu port terbuka. Gateway Anda tetap berfungsi bahkan di belakang router rumah atau firewall cloud. Gateway hanya membuat koneksi keluar, jadi Anda tidak perlu mengekspos apa pun ke internet.
Tidak ada rahasia bot di mesin Anda. Konektor menyimpan semua token platform. Jika gateway Anda dicuri, penyerang tidak mendapatkan apa pun yang berguna.
Satu gateway, banyak platform. Konektor memberi tahu gateway Anda tentang kemampuannya (panjang pesan, markdown, pengeditan, thread, dll.) saat mereka terhubung. Tidak ada aturan yang dikodekan secara permanen — semuanya beradaptasi.

Kapan menggunakannya: Jika Anda menjalankan bot sendiri secara langsung, lewati Relay dan gunakan adaptor bawaan (Telegram, Discord). Relay ditujukan untuk pengaturan di mana konektor bersama atau yang dihosting mengelola sisi platform — seperti hosting multi-penyewa atau ketika Anda tidak ingin menyimpan token di mesin Anda.

Cara Mendaftarkan Gateway Anda

Pendaftaran adalah pengaturan satu kali. Anda menjalankan satu perintah, dan Hermes mengurus sisanya.

Pertama, pastikan Anda memiliki token pendaftaran (dibuat oleh penyedia konektor Anda). Kemudian jalankan:

hermes gateway enroll \
  --token <enrollment-token> \
  --connector-url wss://connector.example.com/relay

Berikut yang terjadi langkah demi langkah:

Hermes memeriksa login Anda yang ada (~/.hermes/auth.json) untuk membuktikan organisasi Anda.
Jika Anda telah menyiapkan penyedia identitas sendiri (untuk pengaturan air-gapped atau self-hosted), itu akan digunakan sebagai gantinya.
Hermes mengirim token pendaftaran ke endpoint /relay/enroll konektor melalui TLS.
Konektor memverifikasi bahwa token valid, hanya bisa digunakan sekali, dan sesuai dengan penyewa Anda.
Konektor kemudian membuat secret khusus gateway dan kunci pengiriman — dan mengembalikannya satu kali.
Hermes menyimpannya ke ~/.hermes/.env:

GATEWAY_RELAY_ID
GATEWAY_RELAY_SECRET
GATEWAY_RELAY_DELIVERY_KEY

Selesai. Gateway Anda sekarang “terdaftar” dan dapat melakukan panggilan keluar ke konektor kapan pun diperlukan.

Apa yang Terjadi Selanjutnya?

Setelah terdaftar, gateway Anda akan:

Melakukan panggilan keluar ke URL konektor yang Anda berikan
Menerima deskripsi kemampuan (apa yang dapat dilakukan platform di depannya)
Mulai bertukar pesan dan tindakan yang dinormalisasi melalui soket yang sama

Tanpa port masuk, tanpa kredensial tambahan, tanpa kode khusus platform.

Ringkasan & Tips Praktis

Ringkasan: Hermes Relay adalah cara yang bersih untuk menghubungkan gateway Anda ke platform perpesanan tanpa memiliki kredensial mereka atau membuka port apa pun. Ini sempurna untuk hosting bersama, lingkungan NAT, atau pengaturan apa pun di mana Anda ingin menjaga rahasia tetap aman dari mesin utama Anda.

Tips praktis: Selalu jaga token pendaftaran Anda hanya sekali pakai dan berumur pendek. Jika Anda perlu memutar kredensial, cukup jalankan ulang perintah enroll dengan token baru — dan ingat untuk menghapus GATEWAY_RELAY_SECRET lama dari file .env Anda sebelum memperbaruinya. Sedikit kebersihan akan sangat membantu.