Hermes Agent Telegram'a nasıl bağlanır

Kısa cevap. Telegram'da @BotFather ile bir bot oluştur (/newbot) ve token'ını kopyala. Hermes Agent'a token'ı ve sayısal Telegram kullanıcı ID'ni ver: onunla yalnızca izin listesindeki ID'ler ya da bir eşleştirme koduyla onayladığın kişiler konuşabilir; izin listesi yoksa yabancı biri, onaylaman gereken bir eşleştirme kodundan başka bir şey alamaz. Kendi makinende bu, ~/.hermes/.env içinde TELEGRAM_BOT_TOKEN ve TELEGRAM_ALLOWED_USERS ya da hermes gateway setup demektir. PlayNHost'ta token'ı ve ID'ni Ajan sayfasına yapıştırır ve yeniden başlatırsın.

7 Kasım 2026'da kontrol edildi, Hermes Agent v0.23.0 için doğru.

Bu rehber Hermes Agent'ın Telegram ve güvenlik belgelerini ve PlayNHost panelinin bugünkü işleyişini kullanır. Telegram desteği Hermes Agent'ın mesajlaşma ağ geçidinde yerleşik gelir: ekstra kurulacak bir şey yok.

1. Adım: botu oluştur ve token'ını kopyala

1. Telegram'da @BotFather ile bir sohbet aç (ya da t.me/BotFather). Kullanıcı adının tam olarak @BotFather olduğundan emin ol.
2. /newbot gönder, bir görünen ad seç, sonra bot ile biten bir kullanıcı adı seç.
3. BotFather token'la cevap verir; token şuna benzer: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Gizli tut: token'a sahip olan herkes botunu yönetebilir. Sızarsa BotFather'da /revoke ile iptal et.

Bot başına tek program. Hermes Agent'ın SSS'si, her sohbet platformunun bir bot token'ını tek başına kullanması gerektiğini söyler. Hermes Agent'ın eski bir kopyası ya da başka bir program hâlâ aynı token'ı kullanıyorsa önce onu durdur ya da yeni bir bot oluştur.

2. Adım: Telegram kullanıcı ID'ni bul

Hermes Agent'ın izin listesi sayısal kullanıcı ID'ni ister, yani 123456789 gibi bir sayıyı; @kullanıcıadı'nı değil. Almanın yolları:

• PlayNHost'ta, konsoldan. Henüz hiçbir ID girmeden botuna mesaj at: konsol ID'ni yazar. Ayrıntılar aşağıdaki 3. Adım'da.
• Hermes Agent'ın günlüğünden. Listede olmayan biri doğrudan mesaj attığında günlüğüne (~/.hermes/logs/gateway.log) "Unauthorized user" ile başlayan bir uyarı düşer ve gönderenin sayısal ID'sini içerir (yabancılar yok sayılacak şekilde ayarlıysa, PlayNHost'ta olduğu gibi, adının yanında parantez içinde).
• Üçüncü taraf bir bot. Hermes Agent'ın belgeleri @userinfobot veya @get_id_bot önerir; ikisi de ID'ni cevaplar.

PlayNHost'ta 3. Adım: token'ı ve ID'ni yapıştır

Aynı sayfada bir yapay zeka sağlayıcı anahtarına da ihtiyacın var. O olmadan Başlat şu cümleyle durur: "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token."

1. Sunucunu panel.playnhost.com adresinde aç, sonra Ajan sekmesine geç.
2. Yapay zeka sağlayıcısı altında, henüz yapmadıysan bir anahtar ayarla (bkz. Hermes Agent için hangi yapay zeka sağlayıcı anahtarı).
3. Sohbet uygulamaları altında Telegram bot token’ı satırında Ayarla'ya bas, BotFather'dan aldığın token'ı yapıştır ve Kaydet'e bas. Panel biçimine bakar; yanlış yapıştırırsan "That is not a valid telegram bot token." mesajını alırsın. Kaydedildikten sonra satır yalnızca son dört karakteri gösterir ve token bir daha gösterilmez.
4. ID'ni henüz bilmiyor musun? Telegram kullanıcı ID’leri alanını boş bırak ve Başlat'a bas. İlk başlatma Hermes Agent'ı kurar; testlerimizde yaklaşık 2,5 ila 4 dakika sürdü. Ajan ayağa kalkınca konsol şunu yazar:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: your Telegram user ID appears here in the console. Put it on the Agent page, then restart.

   Botuna Telegram'dan bir mesaj at. Cevap vermez, bir eşleştirme koduyla bile: PlayNHost'ta Hermes Agent listede olmayan herkesi yok sayar. Yaklaşık 20 saniye içinde (konsol Hermes Agent'ın günlüğünü her 20 saniyede bir kontrol eder) ID'ni gösterir:

   [PlayNHost] Telegram user 123456789 messaged your agent and was ignored. If that is you, add 123456789 to the Telegram user IDs on the Agent page, then restart.

5. Ona kim yazabilir altında sayıyı Telegram kullanıcı ID’leri alanına yaz ve Kaydet'e bas. Birden çok ID tek satıra, virgülle ya da boşlukla ayrılarak yazılır.
6. Sayfa şunu yazar: "Değişiklikler ajanınız bir sonraki başlatıldığında uygulanır." Şimdi yeniden başlat'a bas. Konsol bunu şöyle doğrular:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Botuna mesaj at. Ajanın cevap verir. Başka herhangi bir Telegram hesabından gelen mesajlar yok sayılır ve bota doğrudan mesaj atan her yeni gönderici her başlatmada konsolda bir kez görünür; böylece bir arkadaşını da aynı yolla ekleyebilirsin.

PlayNHost senin için neleri ayarlar

• Ajan sayfasındaki ID'ler Hermes Agent'a TELEGRAM_ALLOWED_USERS olarak ulaşır. İnsanları içeri almanın diğer tüm yolları (herkese izin anahtarları, başka izin listeleri, grup yetkileri, eşleştirme onayları) her başlatmada kapatılır ve çalışırken biri belirirse ajan durdurulur.
• Yabancılar, Hermes Agent'ın varsayılan eşleştirme kodunu almak yerine yok sayılır (unauthorized_dm_behavior: ignore), çünkü bir PlayNHost sunucusunda bir kodu onaylayacak komut satırı yoktur.
• Token, Hermes Agent'a TELEGRAM_BOT_TOKEN olarak ulaşır. .hermes/.env içine yazılmış bir kopyası bir sonraki başlatmada silinir; yani kullanılan, Ajan sayfasındaki token'dır.
• Yalnızca Telegram ve Discord açıktır. WhatsApp reddedilir: Hermes Agent'ın kendi belgeleri, WhatsApp köprüsünün bir WhatsApp Web oturumunu taklit ettiğini ve yasaklanma riski taşıdığını söyler.

Kendi makinende 3. Adım

1. Kurulum sihirbazını çalıştır ve Telegram'ı seç. Token'ı ve izin verilen kullanıcı ID'lerini sorar ve senin yerine yazar:

   hermes gateway setup

2. Ya da bunları elle ~/.hermes/.env dosyasına ekle:

   TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
   TELEGRAM_ALLOWED_USERS=123456789

   Birden çok ID virgülle ayrılır.
3. Ağ geçidini hermes gateway ile başlat ve botuna mesaj at. Oturumu kapattıktan sonra da çalışmasını sağlamak için bkz. Hermes Agent 7/24 nasıl çalıştırılır.

Hiçbir izin listesi yoksa Hermes Agent herkesi reddeder. Yabancılar için varsayılanı, hermes pairing approve telegram <code> ile onaylayacağın bir eşleştirme kodudur; kodlar bir saat sonra geçersiz olur. Hermes Agent'ın belgeleri ayrıca GATEWAY_ALLOW_ALL_USERS=true seçeneğini sunar ve komut çalıştırabilen bir bot için bunu önermez.

Cevap vermediğinde

PlayNHost'ta Hermes Agent'ın kendi günlüğü Files içindeki .hermes/logs/gateway.log dosyasıdır. Discord da mı istiyorsun? Bkz. Hermes Agent'ı Discord'a bağlama. Henüz kurmadın mı? Bir Hermes Agent sunucusu oluştur.

PlayNHost, Nous Research ile bağlantılı değildir. Hermes Agent, MIT lisansı altında açık kaynaklı bir yazılımdır.