Πλήρης οδηγός εγκατάστασης του Hermes Agent για αρχάριους

Το Hermes Agent δεν είναι απλώς άλλο ένα chat παράθυρο. Είναι harness: το κομμάτι που μπαίνει ανάμεσα σε εσένα και στο μοντέλο, και κάνει την όλη ιστορία χρήσιμη. Τρέχει εντολές, κρατά state, θυμάται πράγματα, συνδέεται με Telegram ή Slack και σου δίνει ένα πραγματικό περιβάλλον δουλειάς, όχι απλώς απαντήσεις σε κενό.

Αυτό το άρθρο είναι ο πιο απλός τρόπος να το στήσεις από την αρχή. Όχι για να κάνεις επίδειξη. Για να μείνει ανοιχτό, να δουλεύει όταν εσύ δεν είσαι μπροστά και να μη σου χαλάει το βράδυ επειδή το laptop έπεσε σε sleep.

Γιατί να το βάλεις σε VPS

Η σύντομη απάντηση είναι ότι το Hermes Agent θέλεις να το τρέχεις 24/7. Όχι δεμένο στο μηχάνημα που χρησιμοποιείς για άλλα πράγματα. Ένα VPS σου δίνει αυτή τη σταθερότητα και, πρακτικά, αρκετή ισχύ για το harness χωρίς να πληρώνεις για GPU που δεν χρειάζεσαι.

Για το setup που περιγράφω εδώ, ένα μικρό VPS με Ubuntu 24.04 είναι αρκετό. Το μοντέλο δεν τρέχει τοπικά, οπότε δεν χρειάζεσαι τέρας σε resources. Στην πράξη θα σηκώνεις έναν agent process, ένα messaging gateway και τη βάση του.

Τι χρειάζεσαι πριν ξεκινήσεις

Πριν ανοίξεις terminal, βεβαιώσου ότι έχεις:

• ένα VPS με Ubuntu 24.04
• SSH πρόσβαση στο μηχάνημα
• ένα API key από provider, όπως OpenRouter ή Nous Portal
• αν θες Telegram bot, ένα token από το BotFather και το Telegram user ID σου

Αν έχεις αυτά, είσαι ήδη στο 80%.

Βήμα 1: Μπες στο VPS και κάνε το βασικό update

Σύνδεση:

ssh root@your-server-ip

Αν είναι φρέσκο VPS, συνήθως το root password το έχεις ήδη ορίσει στο provisioning. Μετά, κάνε update τα πάντα:

apt update && apt upgrade -y

Και εδώ κάνε ένα πράγμα που πολλοί το παραλείπουν, μέχρι να τους το θυμίσει ο πόνος: φτιάξε ξεχωριστό non-root user.

adduser --gecos "" hermes
usermod -aG sudo hermes
su - hermes

Μην εγκαθιστάς Hermes ως root. Δεν έχει νόημα και αργότερα θα σε δυσκολέψει περισσότερο απ’ όσο νομίζεις.

Βήμα 2: Εγκατέστησε το Hermes Agent

Η εγκατάσταση γίνεται με ένα μόνο command:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Μετά φόρτωσε ξανά το shell:

source ~/.bashrc

Και τσέκαρε ότι όλα πέρασαν σωστά:

hermes --version
hermes doctor

Αν το hermes doctor βγει καθαρό, κέρδισες χρόνο. Αν βρει σφάλματα, καλύτερα τώρα παρά αφού έχεις ρυθμίσει τρία άλλα πράγματα και ψάχνεις ποιο από όλα είναι το πρόβλημα.

Βήμα 3: Τρέξε το setup wizard

Τώρα άνοιξε τον οδηγό ρύθμισης:

hermes setup

Αυτό είναι το σημείο που περνάς από το “έχω εγκαταστήσει κάτι” στο “έχω πράγμα που δουλεύει”. Ο wizard θα σε ρωτήσει, με σειρά, για provider, model, toolsets, memory, terminal backend και gateway επιλογές.

Τι θα δεις συνήθως:

• επιλογή provider, όπως OpenRouter, Nous Portal, OpenAI ή Anthropic
• επιλογή default model
• ενεργοποίηση εργαλείων, όπως terminal, web, file system και browser automation
• persistent memory
• terminal backend, όπου για VPS βγάζει νόημα το Docker
• gateway setup για Telegram ή άλλες πλατφόρμες

Αν δεν ξέρεις τι να διαλέξεις στο model, μην το κάνεις μεγαλύτερο δράμα απ’ όσο είναι. Διάλεξε κάτι αξιόπιστο, δες αν δουλεύει, και μετά το αλλάζεις με hermes model.

Το σημαντικό εδώ είναι να μη γεμίσεις το setup με επιλογές που δεν χρειάζεσαι ακόμα. Πρώτα να μιλήσει ο agent. Μετά τα υπόλοιπα.

Βήμα 4: Δοκίμασέ το τοπικά

Πριν μπλέξεις Telegram, systemd και οτιδήποτε άλλο, άνοιξε ένα απλό session:

hermes

Πες του κάτι απλό. Ζήτα του να δει αρχεία, να τρέξει μια μικρή εντολή ή να σου πει τι βλέπει. Αν απαντά και εκτελεί εργαλεία, έχεις το βασικό πέρασμα.

Αν θες, βγες με:

/exit

Βήμα 5: Σύνδεσε το Telegram gateway

Εδώ αρχίζει να γίνεται πραγματικά χρήσιμο.

Πρώτα φτιάξε bot στο Telegram:

1. Άνοιξε το Telegram και βρες το @BotFather
2. Στείλε /newbot
3. Δώσε όνομα και username
4. Κράτα το bot token

Μετά, ρύθμισε το Hermes gateway:

hermes gateway setup

Διάλεξε Telegram και δώσε το bot token μαζί με το user ID σου. Το user ID είναι εκεί για να μην μπορεί να μιλήσει ο καθένας στο bot. Αν δεν το ξέρεις, στείλε μήνυμα στο @userinfobot.

Για χειροκίνητο test:

hermes gateway start

Στείλε ένα μήνυμα στο bot από το κινητό σου. Αν απαντήσει, είσαι σωστός.

Βήμα 6: Κράτησέ το ανοιχτό με systemd

Αν το αφήσεις μόνο σε SSH session, κάποια στιγμή θα το χάσεις. Θες service.

Η εγκατάσταση του gateway ως service γίνεται έτσι:

hermes gateway install

Μετά ενεργοποίησε lingering, αλλιώς το systemd θα σκοτώνει τα user services μόλις κλείνεις session:

loginctl enable-linger hermes

Και μετά:

systemctl --user enable --now hermes-gateway

Για status:

systemctl --user status hermes-gateway

Για logs:

journalctl --user -u hermes-gateway -f

Αυτό είναι το σημείο που πολλοί χάνουν χρόνο, επειδή το bot δουλεύει όσο είναι ανοιχτό το SSH και μετά εξαφανίζεται. Δεν έσπασε ο agent. Απλώς δεν του έδωσες σωστό service layer.

Βήμα 7: Κλείδωσε λίγο το μηχάνημα

Μην αφήσεις το VPS σαν να είναι demo environment.

Καλό βασικό minimum:

• SSH key authentication
• απενεργοποίηση password login
• απενεργοποίηση root login
• firewall με ufw

Ενδεικτικά:

ssh-keygen -t ed25519
ssh-copy-id hermes@your-server-ip

Στο sshd_config:

PasswordAuthentication no
PermitRootLogin no

Και firewall:

sudo apt install ufw -y
sudo ufw allow OpenSSH
sudo ufw --force enable

Δεν χρειάζεσαι να ανοίξεις τυχαίες θύρες. Το Telegram gateway μιλάει outbound.

Αν έρχεσαι από OpenClaw

Το Hermes έχει migration tool. Αν έχεις ήδη SOUL.md, memories ή ρυθμίσεις από OpenClaw, δεν χρειάζεται να τα ξαναφτιάξεις από το μηδέν.

hermes claw migrate

Αν θες πρώτα δοκιμή χωρίς να γράψει τίποτα:

hermes claw migrate --dry-run

Αν θέλεις να κρατήσεις κάποια πράγματα και να περάσεις τα υπόλοιπα χειροκίνητα, μπορείς να το κάνεις κι έτσι. Δεν υπάρχει λόγος να παριστάνεις ότι το “clean slate” είναι πάντα η καλύτερη λύση. Μερικές φορές η μεταφορά σε γλιτώνει από ένα ολόκληρο Σαββατοκύριακο.

Μικρά προβλήματα που θα συναντήσεις σχεδόν σίγουρα

• hermes: command not found μετά το install: τρέξε source ~/.bashrc
• το Telegram bot δεν απαντά: έλεγξε token και service status
• το service πέφτει όταν κλείνεις SSH: μάλλον ξέχασες το loginctl enable-linger hermes
• provider error: ξανατσέκαρε model, API key και balance
• κάτι γενικά δεν δουλεύει: πρώτα hermes doctor, μετά πανικός

Τι αξίζει να κρατήσεις

Το πιο μεγάλο λάθος δεν είναι η κακή εντολή. Είναι να προσπαθήσεις να στήσεις τα πάντα ταυτόχρονα.

Κάνε το με τη σωστή σειρά: εγκατάσταση, ένα καθαρό local chat, μετά gateway, μετά service, μετά ασφάλεια. Αν βιαστείς, θα νομίσεις ότι “το Hermes είναι δύσκολο”, ενώ στην πραγματικότητα απλώς το φόρτωσες με τέσσερα layer πριν καν μιλήσει.

Πηγές και χρήσιμα links

• Hermes Agent Quickstart: https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• Configuring Models: https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models
• Original English guide: https://dreamsaicanbuy.com/blog/setup-hermes-agent-hostinger-vps