1. OpenRouter vorbereiten
OpenRouter-Account anlegen, 10-20 EUR bzw. USD-Gegenwert laden und API-Key bereithalten.
AI-PA Hermes Workshop - Stand 02.07.2026
OpenRouter vorbereiten. Hermes Desktop App installieren. Agent im Kurs steuern.
Für diesen Workshop ist die Hermes Desktop App wichtig. Hermes Agent ist das Agenten-System im Hintergrund. Die Desktop App ist der gewünschte Einstieg, weil sie Oberfläche, Agent, CLI und zentrale Abhängigkeiten in einem Setup bündelt.
Zielbild: Ein eigener Arbeits-Cockpit-Agent auf dem Laptop, später bequem steuerbar vom Smartphone.
Kursziel: Erst OpenRouter vorbereiten, dann die Hermes Desktop App installieren und den API-Key direkt beim ersten Setup eintragen. Danach verbinden wir Telegram als Handy-Fernbedienung.
Danach bist du startklar
- ✓Du hast ein OpenRouter-Konto mit Guthaben und deinen persönlichen API-Key kopiert bereitliegen
- ✓Die Hermes Desktop App ist auf deinem Laptop installiert und startet
- ✓Telegram ist auf deinem Handy installiert — die Fernbedienung für deinen Agenten
- ✓Du weißt, was Agent, Modell, API-Key und Gateway bedeuten — genug, um im Kurs mitzureden
Überblick
Was ist zu tun?
Drei Dinge bereitest du vor dem Kurs vor (gelb markiert). Der Rest ist zum Verstehen und Nachschlagen. Klick dich direkt zum passenden Abschnitt.
01Was ist ein KI-Agent?Grundlagen & Begriffe
02Was vor dem Kurs wichtig istÜberblick & Voraussetzungen
03Agent vs. Desktop AppWas ist der Unterschied?
04Schritt 1: OpenRouter vorherKonto, Guthaben, API-Key
05Schritt 2: Desktop App vorherHermes installieren
06Beim ersten StartWas Hermes dich fragt
07Schritt 3: Telegram vorherHandy als Fernbedienung
08Was wir im Kurs machenDer Ablauf am Kurstag
09Hilfe & StolperstellenWenn etwas hakt
10Ready-CheckBist du startklar?
11Alle LinksDirekt anklickbar
Für alle, die neu sind
Was ist ein KI-Agent?
In einem Satz: Ein KI-Agent ist wie ein digitaler Assistent, der nicht nur Fragen beantwortet (wie ein Chatbot), sondern eigenständig Aufgaben auf deinem Computer erledigt — zum Beispiel recherchieren, Texte schreiben, Dateien anlegen oder Abläufe automatisieren. Du sagst, WAS du willst — der Agent überlegt die einzelnen Schritte und führt sie aus. Hermes ist so ein Agent, den wir im Workshop gemeinsam auf deinem eigenen Laptop einrichten. Du brauchst keinerlei Programmierkenntnisse. Stell dir Hermes wie einen fleißigen Praktikanten vor, der auf deinem Rechner sitzt und den du einfach per Chat beauftragst.
Keine Sorge, das schaffst du
Du brauchst keine Programmierkenntnisse und kannst nichts kaputt machen. Diese Seite führt dich in drei ruhigen Schritten durch die Vorbereitung. Wenn ein Schritt nicht klappt: kein Problem — wir richten alles am Kurstag gemeinsam ein. Wichtig ist nur, dass du es einmal in Ruhe versuchst und mit Laptop und Handy in den Workshop kommst. Wer nichts vorbereiten konnte, ist trotzdem herzlich willkommen.
Oft gehört — klargestellt
Oft gehört
„Für so etwas bin ich zu alt — Technik ist nichts für mich."
Tatsächlich
Du schreibst mit Hermes ganz normale deutsche Sätze — wie beim Chatten. Nichts wird auswendig gelernt, nichts kann kaputtgehen, und jeder Schritt lässt sich wiederholen.
Besser so
Sieh diese Seite als ruhiges Aufwärmen: einmal in Ruhe durchklicken reicht — den Rest richten wir am Kurstag gemeinsam ein.
Kurz erklärt: die wichtigsten Begriffe
- Agent: ein digitaler Assistent, der selbstständig Aufgaben auf deinem Rechner erledigt (das ist Hermes).
- Modell / LLM: das KI-„Gehirn", das Texte versteht und schreibt.
- Provider: der Anbieter eines solchen Modells (z.B. OpenAI, Google, Anthropic).
- OpenRouter: ein Sammel-Zugang zu vielen Modellen — wie eine Prepaid-Karte fürs KI-Denken.
- API-Key: dein persönlicher, geheimer Zugangsschlüssel — wie ein Passwort.
- Credits: dein aufgeladenes Guthaben bei OpenRouter.
- CLI / Terminal / Kommandozeile: ein Textfenster, in das man Befehle tippt statt zu klicken — die Desktop App nimmt dir das weitgehend ab.
- Gateway: die Brücke auf deinem Laptop, die z.B. Telegram-Nachrichten an Hermes weiterleitet.
- Token: das Passwort deines Telegram-Bots.
- MCP: Erweiterungen, mit denen Hermes zusätzliche Werkzeuge nutzen kann — für den Einstieg unwichtig.
Kurz geprüft — verstehst du die Begriffe?
Das brauchst du
Bevor du startest, lege bereit: einen Laptop (macOS 12 oder neuer bzw. Windows 10 oder 11 — deine Version findest du unter Apple-Menü > Über diesen Mac bzw. Windows-Einstellungen > System > Info), eine stabile Internetverbindung, dein Smartphone, eine E-Mail-Adresse und eine Kreditkarte (für die 10-20 EUR OpenRouter-Guthaben). Halte außerdem etwas freien Speicherplatz für die App frei.
Aufwand und Kosten auf einen Blick
Zeit: Plane für die Vorbereitung etwa 30 bis 45 Minuten in Ruhe (Account anlegen, Guthaben laden, App installieren, Telegram einrichten). Kosten: einmalig 10-20 EUR Guthaben bei OpenRouter, bezahlt per Kreditkarte. Das ist Guthaben, kein Abo — es wird nur langsam pro Nutzung abgebaut und reicht für den Workshop und viele weitere Übungen locker. Alles andere (Hermes und Telegram) ist kostenlos.
Firmen-Laptop? Bitte zuerst lesen.
Zum Installieren von Programmen brauchst du sogenannte Adminrechte (die Erlaubnis, neue Software zu installieren). Auf privaten Laptops hast du die meist automatisch. Auf Firmen-Laptops ist das oft von der IT gesperrt. So prüfst du es: Versuche testweise, ein beliebiges kleines Programm zu installieren — erscheint eine Passwort- oder Administrator-Abfrage, die du nicht kennst, fehlen dir die Rechte. Dann bitte VOR dem Workshop kurz bei deiner IT-Abteilung nachfragen (Stichwort: Installation von Hermes Desktop für macOS bzw. Windows). Alternativ nimm nach Möglichkeit einen privaten Laptop mit. Und falls beides nicht klappt: trotzdem kommen — wir finden im Kurs eine Lösung.
Für Anfänger auf einen Blick
Was vor dem Kurs wichtig ist
Diese Seite soll nicht alles vorwegnehmen. Sie soll dafür sorgen, dass alle mit einem startfähigen Laptop, einem vorbereiteten Modellzugang und Telegram auf dem Handy in den Workshop kommen.
2. Desktop App installieren
Hermes Desktop App auf macOS oder Windows installieren. Linux-Teilnehmende nutzen die Terminal-Installation.
3. Handy vorbereiten
Telegram auf dem Smartphone installieren und einloggen. Den Bot richten wir im Kurs gemeinsam ein.
4. Geheimnisse schützen
Bot-Token und OpenRouter-API-Key niemals öffentlich teilen. Beides funktioniert wie ein Passwort.
OK
Vorher erledigen: OpenRouter vorbereiten, App installieren, Telegram installieren.
Kurs
Im Workshop: Modell verbinden, Bot anlegen, User-ID eintragen, Gateway testen.
Nein
Nicht nötig vorher: BotFather komplett alleine durchkonfigurieren. Das machen wir Schritt für Schritt.
Begriffsklärung
Hermes Agent vs. Hermes Desktop App
Der Unterschied soll für Teilnehmende glasklar sein, weil wir im Kurs nicht nur eine Kommandozeile testen, sondern eine nutzbare Arbeitsumgebung aufbauen.
Hermes Agent
Das ist das eigentliche Agenten-System: Runtime, CLI-Befehl hermes, Modellkonfiguration, Tools, Gateway, Skills, Speicher und Automatisierung.
- Läuft auch im Terminal.
- Stellt Befehle wie hermes model und hermes gateway bereit.
- Ist die technische Grundlage für Desktop App, Telegram-Gateway und Automatisierungen.
Hermes Desktop App
Das ist die App, die wir im Workshop bevorzugen: eine visuelle Oberfläche plus einfacher Installer, der die Arbeitsumgebung vollständig vorbereitet.
- Für macOS und Windows der wichtigste Installationsweg.
- Hilft Teilnehmenden, schneller in Sessions, Einstellungen und Werkzeuge zu kommen.
- Senkt Setup-Reibung, weil App und CLI zusammen gedacht sind.
Warum OpenRouter, Credits und ein API-Key?
Hermes selbst ist nur die Steuerung. Das eigentliche Denken übernimmt ein KI-Modell (das „Gehirn", z.B. von OpenAI, Google oder Anthropic). Diese Modelle kosten pro Nutzung ein paar Cent. OpenRouter ist eine Art Sammel-Zugang zu vielen dieser Modelle — wie eine Prepaid-Karte: Du lädst einmal Guthaben (Credits) auf und kannst damit verschiedene Modelle nutzen. Der API-Key ist dein persönlicher Zugangsschlüssel zu diesem Guthaben — du trägst ihn einmal in Hermes ein, dann weiß Hermes, welches Konto es nutzen darf. Deshalb bereiten wir zuerst OpenRouter vor und installieren erst danach Hermes.
Was passiert mit meinen Daten?
Wenn Hermes eine KI-Antwort erzeugt, wird deine Anfrage über OpenRouter an den jeweiligen Modellanbieter geschickt (dessen Server stehen häufig in den USA). Für den Workshop und zum Üben ist das unkritisch. Faustregel: Gib zum Testen keine echten vertraulichen oder personenbezogenen Kunden- oder Firmendaten ein — nimm erfundene Beispiele oder unkritische eigene Texte. Der Agent selbst läuft auf deinem Laptop; nur der eigentliche Denk-Schritt (die KI-Antwort) passiert online. Wie du Hermes später datenschutzkonform für echte Arbeit einsetzt, besprechen wir im Kurs.
Schritt 1
OpenRouter vorbereiten
OpenRouter ist unser gemeinsamer Starter-Modellzugang. Die Teilnehmenden brauchen zuerst ein Konto, Guthaben und einen API-Key. Dann kann der Key beim ersten Hermes-Setup direkt eingetragen werden. Empfehlung für den Workshop: 10-20 EUR bzw. der angezeigte USD-Gegenwert.
Wichtig für Erfahrene: Wenn du bereits Codex, Claude, ChatGPT, Gemini oder andere LLM-Subscriptions bzw. API-Zugänge nutzt, kannst du diese grundsätzlich ebenfalls verwenden. Für den Starterkurs arbeiten wir aber gemeinsam mit OpenRouter, weil es einfacher zu erklären ist und wir sonst zehn unterschiedliche LLM-Setups mit zehn unterschiedlichen Ergebnissen im Raum hätten.
1
Konto erstellen
Öffne openrouter.ai und melde dich an. Nutze am besten denselben Laptop, auf dem später Hermes läuft.
2
Credits laden
Öffne direkt die Credits-Seite. Lade 10-20 EUR bzw. den angezeigten USD-Gegenwert auf. OpenRouter zeigt Gebühren und Zahlungsoptionen vor dem Kauf an.
3
API-Key erzeugen
Öffne API Keys, erstelle einen neuen Key und kopiere ihn nur in deine lokale Einrichtung. Optional kannst du ein Kreditlimit setzen.
4
Für Hermes bereitlegen
Den API-Key nicht öffentlich speichern oder posten. Lege ihn nur so ab, dass du ihn beim Start der Hermes Desktop App direkt in das OpenRouter-Feld kopieren kannst.
API-Keys sind Geheimnisse. Nicht in öffentliche Chats posten, nicht in Screenshots zeigen, nicht in geteilte Dokumente kopieren.
Hinweis für Linux
Hinweis für Linux: Damit der Befehl hermes desktop die Oberfläche bauen kann, muss auf Linux vorher der Compiler g++ (Paket build-essential unter Debian/Ubuntu) installiert sein — sonst schlägt der Desktop-Aufbau fehl. Auf normalem Mac oder Windows ist das nicht nötig.
Schritt 2
Hermes Desktop App installieren
Bitte erledige diesen Schritt möglichst vor dem Workshop. Wichtig: OpenRouter sollte vorher vorbereitet sein, damit du den API-Key beim ersten Hermes-Setup direkt eintragen kannst.
macOS 12+
Offiziellen DMG-Installer laden, öffnen und Hermes wie gewohnt in die Programme ziehen bzw. starten.
Windows 10/11
Offiziellen EXE-Installer laden und ausführen. Danach Hermes Desktop App öffnen und die erste Einrichtung starten.
Linux / WSL2 / Termux
Linux ist terminal-first. Danach prüfen wir, ob die Desktop-Oberfläche gestartet werden kann.
So öffnest du das Terminal
Die Befehle unten tippst du in ein Textfenster, das „Terminal" (Mac) bzw. „PowerShell" (Windows) heißt. So findest du es:
- Mac: Cmd + Leertaste drücken, „Terminal" tippen, Enter.
- Windows: Start-Menü öffnen, „PowerShell" tippen, Enter.
Terminal-Installation für macOS, Linux, WSL2, Termux
Nur verwenden, wenn du bewusst über Terminal installierst oder auf Linux arbeitest.
macOS / Linux / WSL2 / Termux
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Terminal-Installation für Windows PowerShell
Für Windows ist die Desktop App weiterhin der bevorzugte Weg. PowerShell ist der Fallback.
Windows PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Nach der Installation prüfen
- Hermes Desktop App lässt sich öffnen.
- Ein Terminalbefehl hermes ist verfügbar oder wird von der App eingerichtet.
- OpenRouter-API-Key liegt bereit und kann beim Modell-Setup direkt eingefügt werden.
- hermes model kann gestartet werden, falls die Modellverbindung nachträglich geprüft werden soll.
- Wenn du über CLI installiert hast: hermes desktop testen.
Direkt nach der Installation
Was fragt Hermes beim ersten Start?
Je nach Desktop App, Terminal-Installation und Version erscheinen die Punkte leicht anders. Für den Kurs ist wichtig: Niemand muss alles allein entscheiden. Diese Übersicht zeigt, was die Fragen bedeuten und was wir im Workshop typischerweise wählen.
Unser Kursweg
OpenRouter-Key bereithalten, Hermes Desktop App starten und den Key direkt beim Modellzugang eintragen.
Nicht erschrecken
Setup-Fragen sind normal. Sie bedeuten nicht, dass etwas kaputt ist.
Geheim halten
OpenRouter-Key und Telegram Bot-Token sind Passwörter.
Telegram später
Bot, User-ID und Gateway richten wir gemeinsam im Kurs ein.
1
Setup-Modus wählen
Hermes kann nach einem schnellen Setup, einem vollständigen Setup oder einem leeren Start fragen. Für diesen Kurs ist der manuelle Weg mit OpenRouter wichtig. Wenn du unsicher bist: nichts wild konfigurieren, im Kurs machen wir es gemeinsam.
2
Provider / Modell auswählen
Der Provider ist der Modellanbieter. Im Starterkurs nutzen wir OpenRouter, weil dadurch alle denselben Weg sehen und wir Ergebnisse besser vergleichen können. Erfahrene Teilnehmende mit bestehenden Codex- oder anderen LLM-Zugängen können diese später ebenfalls anbinden; im Kurs bleiben wir zunächst beim gemeinsamen OpenRouter-Setup.
3
API-Key oder Login eintragen
Bei OpenRouter wird ein API-Key abgefragt. Das ist der geheime Zugang zu deinem Guthaben. Nur lokal in Hermes eintragen, nicht in Chat, Folien, Screenshots oder Gruppen posten.
4
Werkzeuge und Sicherheit
Hermes kann nach Tools, Terminal, Dateien, Browser oder Sicherheitsoptionen fragen. Für Anfänger gilt: Standardwerte nicht hektisch ändern. Im Kurs erklären wir, welche Werkzeuge sinnvoll sind und wo Hermes arbeiten darf.
5
Ersten Chat testen
Nach dem Modell-Setup sollte Hermes auf eine einfache Testfrage antworten. Erfolg heißt: Provider und Modell werden angezeigt, Hermes antwortet ohne Fehlermeldung und eine zweite Nachfrage funktioniert auch.
6
Messaging / Gateway später verbinden
Wenn Hermes nach Messaging-Plattformen fragt, ist das der Bereich für Telegram, Discord, Slack und andere Kanäle. Für unseren Workshop wählen wir später Telegram und tragen Bot-Token plus erlaubte User-ID ein.
1. Startbildschirm nach der Installation
So sieht Hermes aus, wenn die Desktop App startbereit ist. Wichtig fuer Anfaenger: OpenRouter ist dann schon vorbereitet, damit der API-Key direkt beim ersten Modell-Setup eingefuegt werden kann.
2. Skills & Tools
Hier erkennt man spaeter, welche Werkzeuge Hermes nutzen kann. Im Kurs bleibt das noch einfach: Wir pruefen den vorbereiteten OpenRouter-Key, verbinden Hermes mit einem Modell und schalten danach Telegram frei.
3. Messaging / Telegram
In diesem Bereich wird Telegram als Fernbedienung eingerichtet. Dafuer brauchen wir im Kurs den Bot-Token aus BotFather und deine numerische Telegram User-ID.
4. Keys, MCP & Gateway
Hier prueft man spaeter Zugänge, Schluessel und Gateway-Status. Das ist vor allem wichtig, wenn Hermes nicht nur lokal arbeitet, sondern ueber Chat-Befehle erreichbar sein soll.
Quelle für diese Übersicht: Die offizielle Hermes-Dokumentation beschreibt den Installer, die Setup-Modi, hermes model, hermes setup und hermes gateway setup. Direktlinks: Installation und Quickstart.
Schritt 3
Telegram als Handy-Fernbedienung
Für Anfänger wichtig: Wir bauen keine komplizierte App. Wir erstellen einen Telegram-Chat, der als Eingang zu deinem Hermes Agent dient. Du schreibst dem Chat eine Nachricht, Hermes bekommt die Aufgabe auf deinem Rechner und antwortet wieder in Telegram.
Mentales Modell
Du steuerst keinen fremden Cloud-Agenten, sondern deinen eigenen Hermes auf dem Rechner.
- Telegram ist der Chat-Kanal auf dem Handy.
- Der Bot ist der Kontakt, an den du schreibst.
- Das Gateway verbindet Telegram mit Hermes auf deinem Laptop.
- OpenRouter liefert die KI-Modelle, die Hermes verwendet.
Erst verstehen, dann einrichten
Was passiert hier eigentlich?
Hermes läuft auf deinem Laptop. Telegram läuft auf deinem Handy. Damit dein Handy mit Hermes sprechen kann, brauchen wir einen Telegram-Bot. Dieser Bot ist kein eigener neuer KI-Dienst, sondern der Chat-Kanal, über den deine Nachrichten zu Hermes weitergereicht werden.
1. Du schreibst im Chat
Du öffnest Telegram und schreibst deinem Hermes-Bot zum Beispiel: “Fasse diese Notizen zusammen.”
2. Telegram nimmt die Nachricht an
Telegram behandelt den Bot wie einen normalen Chatkontakt, nur dass dahinter kein Mensch sitzt.
3. Hermes Gateway leitet weiter
Das Gateway ist die Brücke auf deinem Rechner. Es holt die Telegram-Nachricht ab und gibt sie an Hermes Agent.
4. Hermes antwortet zurück
Hermes erledigt die Aufgabe auf dem Laptop und schickt das Ergebnis wieder in denselben Telegram-Chat.
Was ist ein Bot?
Ein Bot ist ein Chatkontakt, der automatisch reagieren kann. In unserem Fall ist der Bot die Fernbedienung für Hermes. Du schreibst ihm wie einem Kontakt, aber die Arbeit macht Hermes auf deinem Rechner.
Was ist BotFather?
BotFather ist der offizielle Telegram-Assistent zum Erstellen von Bots. Er gibt uns den Bot-Namen und den geheimen Bot-Token.
Was ist ein Bot-Token?
Der Token ist das Passwort deines Bots. Hermes braucht ihn, damit es Nachrichten dieses Bots lesen und beantworten darf.
Was ist die User-ID?
Die User-ID ist deine feste Telegram-Nummer. Hermes nutzt sie als Zugangsliste, damit nicht jeder fremde Mensch deinem Bot Befehle geben kann.
Wer nachlesen möchte: Die offizielle Hermes-Dokumentation beschreibt dieselben Schritte unter Telegram Setup.
Nachschlagen
Offizielle Doku als Referenz
Für die exakten Hermes-Felder zu Bot-Token, User-ID, Privacy Mode und Gateway-Konfiguration ist die Hermes-Telegram-Dokumentation die Referenz.
Gruppenmodus
Privacy Mode beachten
Telegram-Bots sehen in Gruppen standardmäßig nicht jede Nachricht. Für Gruppentests schalten wir Privacy Mode passend um oder machen den Bot zum Admin.
Warum es lohnt
Hermes vom Handy starten
Hermes läuft auf dem Rechner, aber du kannst Aufgaben vom Smartphone anstoßen: Recherche, Datei erzeugen, Status prüfen oder Agentenläufe auslösen.
1
Telegram installieren und testen
Installiere Telegram auf dem Handy und logge dich ein. Das ist die App, in der du später deinem Hermes-Bot schreibst. Optional kannst du Telegram zusätzlich auf dem Laptop installieren, damit du Links und Tokens leichter kopieren kannst.
- Handy-App öffnen und anmelden.
- Eine Testnachricht an dich selbst oder einen Kontakt senden.
- Für den Kurs bereithalten: Handy entsperrt, Telegram geöffnet.
2
BotFather verstehen und Bot erstellen
@BotFather ist der offizielle Telegram-Bot zum Erstellen und Verwalten eigener Bots. Man kann ihn sich wie die Bot-Verwaltung von Telegram vorstellen. Im Kurs schreiben wir BotFather an und erzeugen einen persönlichen Hermes-Bot.
- Telegram öffnen und @BotFather suchen oder den Button unten nutzen.
- /newbot senden. Dieser Befehl bedeutet: “Ich möchte einen neuen Bot erstellen.”
- Display-Name vergeben, z.B. Mein Hermes Agent. Dieser Name ist frei wählbar.
- Username vergeben. Das ist der technische Telegram-Name. Wichtig: Er muss eindeutig sein und mit bot enden, z.B. holger_hermes_bot.
- BotFather sendet danach einen Bot-Token. Diesen Token kopieren wir später in Hermes, aber wir behandeln ihn wie ein Passwort.
Nicht öffentlich teilen: Der Bot-Token erlaubt Zugriff auf deinen Telegram-Bot. Nicht in Screenshots, Chatgruppen oder öffentliche Dokumente kopieren.
3
Eigene Telegram User-ID finden
Jetzt klären wir, wer dem Bot überhaupt Befehle geben darf. Dafür nutzt Hermes nicht deinen sichtbaren Telegram-Namen, sondern deine numerische User-ID. Das ist wichtig: Usernames können sich ändern, User-IDs sind stabiler.
- @userinfobot öffnen und starten. Der Bot antwortet mit deiner numerischen ID.
- Alternativ @get_id_bot nutzen.
- Die Zahl lokal notieren. Beispiel-Format: 123456789.
- Diese ID tragen wir im Kurs bei allowed users ein. Das bedeutet: Nur diese Telegram-User dürfen den Hermes-Bot steuern.
In der offiziellen Hermes-Telegram-Doku ist dieser Schritt als Zugriffsschutz beschrieben. Dort wird auch erklärt, wie mehrere User-IDs eingetragen werden können.
4
Hermes Gateway konfigurieren und starten
Das Gateway ist die Brücke zwischen Telegram und Hermes. Ohne Gateway bleibt Telegram nur ein Chat. Mit Gateway kommt die Nachricht bei Hermes Agent auf deinem Laptop an.
Einrichtung im Kurs
hermes gateway setup
Gateway starten
hermes gateway
- Bei der Einrichtung wählen wir Telegram als Plattform.
- Dann tragen wir Bot-Token und erlaubte User-ID ein.
- Nach dem Start senden wir dem eigenen Bot in Telegram eine Testnachricht.
- Wenn der Bot antwortet, ist die Handy-Steuerung aktiv: Telegram-Chat rein, Hermes-Ergebnis zurück.
- Wenn nichts passiert: Token, User-ID und laufendes Gateway prüfen.
So ähnlich sieht der Telegram-Bereich in Hermes aus: Bot-Token eintragen, erlaubte User-ID setzen, Gateway starten.
Workshop-Ablauf
Was wir konkret machen
Der Kurs ist praktisch aufgebaut. Wir prüfen keine Theorie-Checkliste ab, sondern bauen eine arbeitsfähige Agenten-Umgebung auf.
OpenRouter prüfen
Konto, Credits und API-Key kontrollieren, damit der Modellzugang direkt bereit ist.
Hermes Setup abschließen
Desktop App starten, API-Key eintragen, Modell wählen, CLI prüfen und erste Session erzeugen.
Telegram steuern
Bot anlegen, User erlauben, Gateway starten, Handy-Test senden.
Agenten nutzen
Aufgaben ausführen, Dateien erzeugen, Ergebnisse bewerten und Grenzen definieren.
Du kommst vorher nicht weiter?
Das ist völlig okay. Schreib uns einfach kurz vor dem Kurs an dein Kursteam (per E-Mail) und beschreibe, wo du hängst (gern mit Screenshot — aber ohne API-Key oder Bot-Token darauf!). Wir helfen dir vorab oder klären es gleich zu Beginn des Workshops. Niemand muss allein feststecken.
Wenn etwas hakt
Typische Anfänger-Stolperstellen
Diese Punkte sind keine Fehler im Kurs. Sie sind normale Setup-Themen. Wenn etwas davon passiert, bringen wir es im Workshop gemeinsam in Ordnung.
1Hermes App startet nicht
macOS oder Windows können neue Apps blockieren. Bitte die offizielle Hermes-Seite verwenden, App neu öffnen und mögliche Sicherheitsabfrage bestätigen. Im Kurs prüfen wir auch, ob der Befehl hermes verfügbar ist.
2OpenRouter ist noch leer
Ohne Credits oder API-Key kann Hermes kein Modell nutzen. Wichtig sind: Konto, Guthaben, API-Key. Den Key tragen wir im Kurs in Hermes ein.
3Bot antwortet nicht
Meist fehlt einer von drei Bausteinen: Bot-Token, erlaubte User-ID oder laufendes Gateway. Deshalb richten wir Telegram im Kurs bewusst langsam und gemeinsam ein.
4Token oder Key sichtbar?
Wenn ein Bot-Token oder API-Key versehentlich geteilt wurde, bitte neu erzeugen. Beide Werte sind wie Passwörter und gehören nicht in Screenshots oder Gruppen-Chats.
Installationsbezeichnung
AI-PA HERMES DESKTOP READY
Diese Bezeichnung verwenden wir im Kurs als Status: OpenRouter ist vorbereitet, Hermes Desktop App ist installiert, Telegram ist installiert.
AI-PA
HERMES
DESKTOP
READY
HERMES
DESKTOP
READY
OpenRouter-Konto ist vorhanden.
10-20 EUR bzw. USD-Gegenwert sind als Credits geladen.
OpenRouter-API-Key ist erzeugt und geheim gespeichert.
Hermes Desktop App ist installiert und startet.
Falls über CLI installiert: hermes und hermes desktop sind testbar.
Telegram ist auf dem Handy installiert und eingeloggt.
BotFather kann in Telegram geöffnet werden.
Laptop, Strom, Browser und Adminrechte sind für den Workshop bereit.
Direkte Links
Alles anklickbar an einem Ort
Diese Links sind bewusst direkt eingebaut, damit Teilnehmende aus der Webseite heraus installieren und vorbereiten können.
OpenRouter
Hermes Desktop App
Telegram
Das nimmst du mit
- 1Reihenfolge merken: erst OpenRouter (Konto, Guthaben, API-Key), dann Hermes installieren, dann Telegram.
- 2Du brauchst keine Programmierkenntnisse — deutsche Sätze reichen, und kaputt machen kannst du nichts.
- 3Komm mit Laptop und Handy in den Kurs. Was nicht klappt, richten wir gemeinsam ein.
Weiter — Kurs starten→
Startklar? Dann geht es im Lernpfad weiter — Schritt für Schritt durch den Workshop.