Πώς να συνδέσετε το Hermes Agent στο Telegram και να διαχειρίζεστε εργασίες από το τηλέφωνό σας

Μπορείτε να στέλνετε μηνύματα στο Hermes Agent ή να του υπαγορεύετε εργασίες στο Telegram από το τηλέφωνό σας όταν βρίσκεστε μακριά από τον υπολογιστή σας και να λαμβάνετε το αποτέλεσμα στην ίδια συνομιλία. Τα αποτελέσματα των προγραμματισμένων εργασιών φτάνουν μία φορά στη συνομιλία που ορίζετε ως συνομιλία σας.

Αν δεν έχετε ακόμη το Hermes, ξεκινήστε με τον οδηγό για το τι είναι αυτός ο agent και πώς να τον εγκαταστήσετε και μετά επιστρέψτε για να συνδέσετε το Telegram.

Πρόσθετες οδηγίες είναι διαθέσιμες στην τεκμηρίωση του Ailoot.

Τι χρειάζεστε για να συνδέσετε το Hermes Agent στο Telegram;#

Η εντολή hermes doctor ελέγχει την εγκατάσταση του Hermes και τη σύνδεση με το μοντέλο. Θα δημιουργήσουμε το bot στην εφαρμογή Telegram και θα χρειαστείτε έναν υπολογιστή για να εκτελέσετε εντολές στο τερματικό.

Πώς δημιουργείτε ένα bot μέσω του BotFather;#

Κάθε bot του Telegram έχει ένα token — ένα μυστικό κλειδί για τον έλεγχο του bot. Το εκδίδει το επίσημο bot του Telegram, το @BotFather.

1. Ανοίξτε το @BotFather

   Αναζητήστε το @BotFather στο Telegram ή ανοίξτε το t.me/BotFather. Το πραγματικό BotFather έχει μπλε σήμα επαλήθευσης. Ξεκινήστε τη συνομιλία πατώντας «Έναρξη».

2. Στείλτε την εντολή /newbot

   Το BotFather θα ζητήσει δύο ονόματα. Το πρώτο είναι το εμφανιζόμενο όνομα· μπορεί να είναι οτιδήποτε, για παράδειγμα «Ο agent μου». Το δεύτερο είναι το όνομα χρήστη: πρέπει να είναι μοναδικό και να τελειώνει σε bot, για παράδειγμα moy_agent_bot.

3. Λάβετε το token

   Το BotFather θα στείλει ένα συγχαρητήριο μήνυμα και μια μεγάλη συμβολοσειρά της μορφής 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Αυτό είναι το token του bot. Αντιγράψτε ολόκληρη τη συμβολοσειρά.

Υπάρχει και ένας γρήγορος τρόπος που δεν απαιτεί χειροκίνητη συνομιλία με το BotFather. Στον διαδικτυακό πίνακα ελέγχου του Hermes (hermes dashboard) και στην εφαρμογή για υπολογιστή, στη σελίδα «Messaging → Telegram», υπάρχει ένα κουμπί «Create with QR»: σαρώστε τον κωδικό με το τηλέφωνό σας και το Hermes θα δημιουργήσει ένα bot, θα εντοπίσει το ID σας, θα αποθηκεύσει το token στις ρυθμίσεις και θα επανεκκινήσει το gateway. Τα παρακάτω βήματα καλύπτουν τη χειροκίνητη μέθοδο· αν επιλέξατε QR, προχωρήστε απευθείας στον έλεγχο της σύνδεσης.

Πώς βρίσκετε το Telegram ID σας και γιατί το χρειάζεστε;#

Ένας λογαριασμός Telegram έχει δύο αναγνωριστικά: ένα δημόσιο όνομα χρήστη με το σύμβολο @ και ένα εσωτερικό αριθμητικό ID. Το Hermes χρησιμοποιεί τον αριθμό.

Η γρήγορη μέθοδος «Δημιουργία με QR» που περιγράφηκε παραπάνω εντοπίζει αυτόματα το ID σας. Σημειώστε το δίπλα στο token σας.

Πώς δίνετε το token στο Hermes Agent και ξεκινάτε το gateway;#

1. Εκτελέστε τον οδηγό ρύθμισης

   hermes gateway setup
   

   Εκτελέστε την εντολή στο μηχάνημα όπου είναι εγκατεστημένο το Hermes. Ο οδηγός θα εμφανίσει μια λίστα εφαρμογών ανταλλαγής μηνυμάτων.

2. Επιλέξτε Telegram και εισαγάγετε τα στοιχεία σας

   Ο οδηγός θα ζητήσει το token του bot και τα επιτρεπόμενα ID (μπορείτε να εισαγάγετε αρκετά, χωρισμένα με κόμματα) και θα τα αποθηκεύσει στις ίδιες τις ρυθμίσεις.

3. Ξεκινήστε το gateway

   hermes gateway
   

   Το gateway θα ξεκινήσει και θα συνδεθεί στο Telegram. Μετά από λίγα δευτερόλεπτα, στείλτε οποιοδήποτε μήνυμα στο bot σας από την εφαρμογή: αν απαντήσει το Hermes, η σύνδεση είναι έτοιμη.

Η χειροκίνητη μέθοδος αντί για τον οδηγό ρύθμισης είναι η εξής: ανοίξτε το αρχείο ~/.hermes/.env και προσθέστε δύο γραμμές, αντικαθιστώντας το token από το BotFather και το αριθμητικό σας ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Η δεύτερη γραμμή εξουσιοδοτεί αυτά τα άτομα σε ιδιωτικές συνομιλίες και ομάδες· ξεχωριστή εξουσιοδότηση ομαδικής συνομιλίας μπορεί επίσης να δίνει πρόσβαση. Χωρίστε τα πολλά άτομα με κόμματα. Αφού αποθηκεύσετε το αρχείο, ξεκινήστε το gateway με την ίδια εντολή hermes gateway.

Αν το bot παραμένει σιωπηλό ακόμη και σε ιδιωτική συνομιλία, ελέγξτε τα αρχεία καταγραφής του gateway στο ίδιο τερματικό και επαληθεύστε πρώτα το token και το ID σας στη λίστα πρόσβασης· άλλα σφάλματα καλύπτονται στον πίνακα στο τέλος του άρθρου.

Τι μπορεί να κάνει το bot του Telegram στο τηλέφωνό σας;#

Υπάρχουν πέντε δυνατότητες που θα χρειαστείτε συχνότερα στο τηλέφωνό σας.

Μηνύματα κειμένου και φωνής. Γράψτε μια εργασία με λόγια ή υπαγορεύστε ένα φωνητικό μήνυμα — με ρυθμισμένη αναγνώριση ομιλίας, το Hermes θα το μεταγράψει και θα το κατανοήσει. Με έναν τοπικό πάροχο δεν χρειάζονται κλειδιά· όλα υποβάλλονται σε επεξεργασία στο μηχάνημα όπου εκτελείται ο agent.

Αρχεία και εικόνες. Μπορείτε να προωθήσετε ένα έγγραφο, ένα υπολογιστικό φύλλο ή ένα στιγμιότυπο οθόνης στο bot — ο agent θα το λάβει ως συνημμένο. Μπορεί επίσης να στείλει πίσω αρχεία που δημιουργεί: ζητήστε μια αναφορά και θα τη στείλει ως αρχείο στη συνομιλία.

Επιβεβαιώσεις για επικίνδυνες ενέργειες. Όταν ο agent πρόκειται να κάνει κάτι επικίνδυνο, όπως να διαγράψει αρχεία, ρωτά πρώτα στη συνομιλία: απαντήστε «yes» ή «y» και θα το κάνει· απαντήστε «no» ή «n» και θα ακυρώσει.

Κουμπιά αντί να πληκτρολογείτε απάντηση. Όταν ο agent χρειάζεται διευκρίνιση, στέλνει μια ερώτηση με ενσωματωμένα κουμπιά επιλογών — πατήστε μια επιλογή και ο agent συνεχίζει την εργασία. Η εντολή /model χωρίς ορίσματα εμφανίζει μενού επιλογής μοντέλου με παρόμοια κουμπιά.

Αθόρυβες ειδοποιήσεις. Από προεπιλογή, το τηλέφωνό σας χτυπά μόνο για τελικές απαντήσεις, αιτήματα επιβεβαίωσης και επιβεβαιώσεις εντολών. Οι ειδοποιήσεις υπηρεσίας, όπως «κλήση εργαλείου» και «συμπίεση περιβάλλοντος», φτάνουν αθόρυβα, ώστε το τηλέφωνό σας να μην χτυπά σε κάθε βήμα. Αν θέλετε ηχητικές ειδοποιήσεις σε κάθε βήμα, αλλάξτε τη λειτουργία στις ρυθμίσεις.

Πώς λαμβάνετε αποτελέσματα εργασιών παρασκηνίου στη συνομιλία;#

Συνομιλία οικίας για προγραμματισμένες εργασίες. Το Hermes υποστηρίζει προγραμματισμένες εργασίες: «κάθε πρωί στις 7:43, ετοίμασε μου μια σύνοψη». Στέλνει τα αποτελέσματα στη συνομιλία οικίας, την οποία ορίζετε μία φορά στέλνοντας την εντολή /sethome απευθείας στη συνομιλία με το bot. Όσο λειτουργεί το gateway, οι συνόψεις φτάνουν αυτόματα.

Εργασίες παρασκηνίου. Μπορείτε να στείλετε μια μεγάλη εργασία για εκτέλεση στο παρασκήνιο και να συνεχίσετε τη μέρα σας: το bot θα σας στείλει μήνυμα όταν είναι έτοιμο. Μια εργασία που ξεκίνησε από ένα θέμα θα επιστρέψει την απάντησή της στο ίδιο θέμα, ώστε να μη χαθεί τίποτα.

Σημαντικός περιορισμός: το bot απαντά μόνο όσο λειτουργεί το gateway. Αν απενεργοποιήσετε τον υπολογιστή που εκτελεί το Hermes ή τον θέσετε σε αναστολή λειτουργίας, το bot δεν θα απαντήσει μέχρι να λειτουργήσει ξανά το μηχάνημα. Για να διατηρείτε το bot συνεχώς συνδεδεμένο, μεταφέρετε τον agent σε διακομιστή: έχουμε ξεχωριστό οδηγό για το πώς να διατηρείτε το Hermes Agent σε λειτουργία όλο το εικοσιτετράωρο. Από προεπιλογή, το gateway ελέγχει το Telegram για νέα μηνύματα· για πλατφόρμες cloud που τίθενται σε αναστολή χωρίς εισερχόμενη κίνηση, η τεκμηρίωση προσφέρει λειτουργία webhook, η οποία αντιστρέφει την κατεύθυνση της σύνδεσης ώστε το ίδιο το Telegram να στέλνει αιτήματα στο bot.

Πώς κρατάτε τους αγνώστους έξω από το bot;#

Το bot σας μπορεί να βρεθεί στην αναζήτηση του Telegram μέσω του ονόματος χρήστη του, επομένως η προστασία βασίζεται σε δύο πράγματα: στη λίστα πρόσβασης και στη διατήρηση του token ως μυστικού.

Ρυθμίστε πρώτα πρόσβαση αποστολέων με TELEGRAM_ALLOWED_USERS. Για ομάδες, εξετάστε επίσης το TELEGRAM_GROUP_ALLOWED_CHATS: η καταχώριση μιας συνομιλίας εκεί επιτρέπει οποιοδήποτε μέλος της, ακόμη κι αν το ID αποστολέα λείπει από την προσωπική λίστα. Επομένως μια κενή προσωπική λίστα μόνη της δεν αποδεικνύει ότι όλες οι ομάδες είναι κλειστές.

Δεύτερο, υπάρχει το token. Δεν πρέπει να εμφανιστεί σε στιγμιότυπα οθόνης, προωθημένα μηνύματα ή αποθετήρια. Αν διαρρεύσει το token, ανακαλέστε το με την εντολή /revoke στο BotFather. Έπειτα, εισαγάγετε το νέο token στις ρυθμίσεις και επανεκκινήστε το gateway.

Μια ξεχωριστή σημείωση για ομάδες: η εξουσιοδότηση αποστολέα και συνομιλίας είναι διαφορετικά πράγματα. Μέλος ομάδας που επιτρέπεται μέσω TELEGRAM_GROUP_ALLOWED_CHATS μπορεί να χρησιμοποιεί το bot ακόμη κι αν το ID του δεν βρίσκεται στο TELEGRAM_ALLOWED_USERS. Αν η πρόσβαση πρέπει να παραμείνει ατομική, μη δίνετε πρόσβαση σε ολόκληρη την ομάδα· ρυθμίστε και επαληθεύστε περιορισμούς αποστολέων για την εγκατεστημένη έκδοση. Αν θέλετε το bot να απαντά σε μια ομάδα μόνο όταν το καλούν, υπάρχει η ρύθμιση telegram.require_mention — τότε απαντά σε μια αναφορά @, σε απάντηση στο μήνυμά του, σε εντολή όπως /command@yourbot και σε αντιστοιχίσεις με τα μοτίβα σας στο telegram.mention_patterns, ενώ αγνοεί τα συνηθισμένα μηνύματα της ομάδας.

Γιατί σιωπά το bot σε μια ομάδα και πώς το διορθώνετε;#

Τα νέα bot του Telegram έχουν ενεργοποιημένη από προεπιλογή τη λειτουργία απορρήτου· η τεκμηρίωση του Hermes την περιγράφει ως τη συχνότερη πηγή σύγχυσης με τα bot στις ομάδες. Σε αυτήν τη λειτουργία, το bot λαμβάνει μόνο μηνύματα που αρχίζουν με εντολή /, απαντήσεις στα δικά του μηνύματα και ειδοποιήσεις υπηρεσίας. Απλώς δεν λαμβάνει τα συνηθισμένα μηνύματα της ομάδας — το Telegram δεν του τα στέλνει και καμία ρύθμιση του agent δεν μπορεί να το διορθώσει.

Πώς να το διορθώσετε:

1. Ανοίξτε το @BotFather και στείλτε /mybots.
2. Επιλέξτε το bot σας.
3. Ανοίξτε «Bot Settings» → «Group Privacy» → «Turn off».
4. Αφαιρέστε το bot από την ομάδα και προσθέστε το ξανά.

Είναι εύκολο να παραλείψετε το τέταρτο βήμα και τότε το bot «εξακολουθεί να σιωπά». Το Telegram θυμάται τη ρύθμιση απορρήτου που ίσχυε όταν το bot μπήκε στην ομάδα και δεν την ενημερώνει μέχρι να αφαιρεθεί το bot από την ομάδα και να προστεθεί ξανά.

Αν δεν θέλετε να απενεργοποιήσετε συνολικά τη λειτουργία απορρήτου, υπάρχει δεύτερη επιλογή: ορίστε το bot ως διαχειριστή της ομάδας. Τα bot-διαχειριστές λαμβάνουν όλα τα μηνύματα σε οποιαδήποτε λειτουργία απορρήτου.

Συνηθισμένα σφάλματα σύνδεσης και τι να κάνετε#

Τι άλλο ρωτούν για το Hermes Agent στο Telegram;#

Όταν είστε έτοιμοι, γνωρίστε το Ailoot.