Hermes Agent auf Saplo installieren (KI-Agent für Messenger)

Bevor wir anfangen, gleich vorab eine Sache: Der Hermes Agent hat kein Web-Panel. Es gibt keinen Anmeldebildschirm, kein Dashboard mit Diagrammen, nichts, was im Browser angezeigt wird, wenn du die Domain besuchst. Die gesamte Konfiguration, vom Schlüssel zum Sprachmodell bis zur Anbindung des Bots an Telegram, erfolgt im Terminal. Wenn du einen fertigen Chatbot mit einer klickbaren Oberfläche suchst, ist das nicht die richtige Anwendung. Im Saplo App-Katalog findest du andere Tools, die besser passen. Der Hermes Agent ist für jemand anderen gedacht: für einen Entwickler oder eine Agentur, die ihren eigenen KI-Agenten an Messaging-Dienste anbinden möchte, ohne die API-Integration des Modells von Grund auf neu zu schreiben und ohne monatliche Abonnements für eine SaaS-Plattform zu zahlen, die intern ohnehin dasselbe tut. Wenn das deine Situation beschreibt, findest du unten eine Schritt-für-Schritt-Anleitung, wie du den Hermes Agent auf Saplo einrichtest.

Für wen ist der Hermes Agent?

Bevor du den Hermes Agent installierst, solltest du prüfen, ob er wirklich zu deinen Anforderungen passt:

• Du entwickelst einen Bot, der für dich auf Telegram, Discord oder Slack antworten soll? Der Hermes Agent verbindet sich mit dem ausgewählten Messenger und unterhält sich im Namen deines Unternehmens mit den Nutzern, wobei er das Sprachmodell verwendet, das du selbst angibst.
• Du möchtest keine eigene Integration in die API des Modells schreiben? Die Unterstützung für Webhooks, Nachrichtenwarteschlangen und die Aufrechterhaltung der Verbindung zum Messenger ist bereits im Docker-Image enthalten, du gibst nur die Schlüssel ein.
• Du bevorzugst es, einmalig für die Box zu zahlen, anstatt monatlich für eine SaaS-Plattform? Der Hermes Agent ist Open Source und hat kein separates Abonnement. Du zahlst nur für die Box, auf der er läuft.
• Du hast keine Probleme mit der Konfiguration über das Terminal? Wenn du einen Browser-basierten Assistenten erwartest, wird dich diese Anwendung enttäuschen, hier läuft alles über SSH.

Wenn du auf der Suche nach einem fertigen Kundenservice-Chatbot mit Admin-Panel bist, schau dir andere Anwendungen im App-Katalog an. Dort findest du Tools mit einer Web-Oberfläche.

Anforderungen

Um den Hermes Agent auf Saplo zu installieren, benötigst du:

• Eine Box im Tarif L oder höher, da die erste Konfiguration SSH-Zugriff über das Online-Terminal erfordert und niedrigere Tarife diesen nicht bieten.
• Mindestens 1,5 GB freien RAM und 8 GB Festplattenspeicher.
• Eine Domain oder Subdomain *.saploapp.pl zum Preis jedes Tarifs, unter der die Informationsseite gehostet wird (Hermes ist headless, daher siehst du unter der Domain nur Anweisungen, kein Panel).
• Einen API-Schlüssel für das Sprachmodell, den du während der Konfiguration im Terminal angibst, und einen Bot-Token für den Messenger, mit dem sich Hermes verbinden soll.
• Eine separate Datenbank benötigst du NICHT, die gesamte Konfiguration und der Gesprächsverlauf werden in einem benannten Docker-Volume gespeichert.

Schritt-für-Schritt-Installation

1. Gehe im Saplo-Panel zum App-Katalog und wähle Hermes Agent (Kategorie "AI-Anwendungen").
2. Wähle eine Box im Plan Box L oder höher mit mindestens 1,5 GB freiem RAM und eine Domain oder Subdomain, unter der die Informationsseite bereitgestellt werden soll.
3. Bestätige die Installation. Die Engine installiert Docker CE, falls es noch nicht auf der Box vorhanden ist, lädt das offizielle Image nousresearch/hermes-agent (ca. 900 MB) herunter und startet den Container ohne einen freigelegten HTTP-Port. Der gesamte Traffic bleibt innerhalb des Containers.
4. Nach dem Start überprüft die Engine, ob der Container tatsächlich läuft und nicht in eine Neustartschleife geraten ist, anstatt sich nur auf docker compose up ohne Überprüfung zu verlassen.
5. Unter der angegebenen Domain erscheint eine statische Seite mit Konfigurationsanweisungen, da Hermes keine eigene Weboberfläche bereitstellt.

Erste Konfiguration

1. Gehe im Saplo-Panel zum Online-Terminal für die Box, auf der Hermes läuft (erfordert Plan L oder höher).
2. Starte den Konfigurationsassistenten mit dem Befehl docker exec -it hermes-<slug> hermes setup, wobei <slug> der Name deiner Installation ist, der im Panel sichtbar ist.
3. Gib im interaktiven Assistenten den API-Schlüssel für das Sprachmodell und den Bot-Token für den ausgewählten Messenger (Telegram, Discord oder Slack) ein.
4. Nach Abschluss des Assistenten verbindet sich der Agent automatisch mit dem Messenger, ohne dass ein zusätzlicher Container-Neustart erforderlich ist.
5. Eine Live-Vorschau der Agentenaktivität erhältst du mit dem Befehl docker logs -f hermes-<slug> im selben Online-Terminal.

Hermes Agent auf Saplo vs. Alternativen

Häufig gestellte Fragen

Hat Hermes Agent ein Webinterface? Nein, die Anwendung ist headless. Unter der Domain, die du bei der Installation angibst, siehst du nur eine statische Seite mit Konfigurationsanweisungen. Der Agent selbst läuft in einem Docker-Container und stellt keine Schnittstelle im Browser bereit.

Warum erfordert die Installation den Box L Plan und keinen niedrigeren? Die Erstkonfiguration erfolgt über das Online-Terminal, d.h. SSH-Zugang zum Container, und dieser ist erst ab dem Box L Plan verfügbar. Mit niedrigeren Plänen kannst du den Container aufsetzen, aber den Agenten nicht konfigurieren.

Welches Sprachmodell kann Hermes Agent verwenden? Du gibst während der Konfiguration im hermes setup-Assistenten deinen eigenen API-Schlüssel an, die Modellwahl hängt also davon ab, zu welchem Anbieter du Zugang hast. Saplo schreibt keinen bestimmten Anbieter vor und erhebt keine Gebühr für Modellabfragen.

Wo wird der Gesprächsverlauf des Agenten gespeichert? In einem benannten Docker-Volume auf deiner Box. Dasselbe Volume übersteht die Bereinigung des App-Katalogs, sodass Konfiguration und Verlauf bei normalen Box-Operationen nicht verschwinden.

Kann ich Hermes Agent mit mehr als einem Messenger gleichzeitig verbinden? Der hermes setup-Assistent führt dich Schritt für Schritt durch die Konfiguration des Messengers. Wenn du mehr als einen Kanal bedienen möchtest, startest du den Assistenten erneut und fügst eine weitere Verbindung im selben Container hinzu.

Wenn du einen eigenen KI-Agenten auf Telegram, Discord oder Slack haben möchtest, ohne die Integration von Grund auf neu zu schreiben und ohne SaaS-Abonnement, und das Terminal dich nicht abschreckt, kannst du Hermes Agent auf Saplo in wenigen Minuten einrichten. Schreibe uns, wenn du Hilfe bei der ersten Konfiguration benötigst.