So installieren Sie Hermes Agent: Einsteiger-Setup-Anleitung

Hermes Agent ist ein Open-Source-KI-Agent von Nous Research, der über Ihr Terminal läuft, sich mit verschiedenen Modellanbietern verbindet, nützlichen Kontext über mehrere Sitzungen hinweg speichert und sich mit Tools, Skills, Messaging-Gateways und Automatisierung erweitern lässt. Dieser Leitfaden hilft Ihnen bei der Installation von Hermes. Für den Standard-Installer unter macOS oder Windows müssen Sie Python oder Node.js nicht manuell installieren, da der offizielle Installer die wichtigsten Abhängigkeiten für Sie übernimmt.

Vor der Installation von Hermes Agent

Hermes Agent ist terminalorientierte Software, daher installieren Sie es über die Kommandozeile. Wählen Sie den Abschnitt, der zu Ihrem Computer passt:

• macOS: Öffnen Sie das Terminal über Programme > Dienstprogramme > Terminal, oder drücken Sie Cmd + Leertaste und suchen Sie nach „Terminal“.

• Windows: Installieren Sie zuerst WSL2, öffnen Sie das Terminal Ihrer Linux-Distribution und folgen Sie dann dem Linux-Befehl.

Sie benötigen außerdem Git. Prüfen Sie, ob Git installiert ist:

Erwartete Ausgabe:

Wenn git: command not found angezeigt wird, installieren Sie zuerst Git:

Wenn Sie Homebrew unter macOS nicht installiert haben, installieren Sie Git über die Apple Command Line Tools mit folgendem Befehl:

Schritt 1: Hermes Agent unter macOS oder Windows installieren

Kopieren Sie in Ihrem Terminal den offiziellen Installer-Befehl und fügen Sie ihn ein:

Der Installer lädt Hermes Agent herunter, richtet die Python-Umgebung ein, installiert die erforderlichen Abhängigkeiten und fügt den Befehl hermes zu Ihrem Shell-Pfad hinzu. Bei einer normalen Benutzerinstallation werden die Hermes-Daten unter ~/.hermes/ gespeichert.

Wenn der Befehl abgeschlossen ist, laden Sie Ihre Shell neu:

Wenn Sie Zsh verwenden, was unter macOS üblich ist, führen Sie Folgendes aus:

Erwartetes Ergebnis:

Bestätigen Sie nun, dass der Hermes-Agent-Befehl verfügbar ist:

Erwartetes Ergebnis:

Die genaue Versionsnummer kann sich mit Updates von Hermes Agent ändern.

Schritt 2: Ihren Modellanbieter konfigurieren

Hermes Agent benötigt einen Modellanbieter, bevor es antworten oder Tools verwenden kann. Die einfachste Einrichtung für Einsteiger ist interaktiv:

Der Assistent lässt Sie einen Anbieter wie Kimi/Moonshot auswählen. Konfigurieren Sie Routing, Fallback, Gateway oder Cron erst, wenn ein einfacher Chat funktioniert.

Wählen Sie das Standardmodell aus. kimi-k2.6 ist Kimis bisher fortschrittlichstes Modell.

Wenn Sie den gewünschten Wert bereits kennen, können Sie hermes config set verwenden. Zum Beispiel:

Wenn Sie keinen API-Schlüssel haben, könnte Kimi eine gute Wahl sein.

Schritt 1: Aktivieren Sie Ihre Kimi API

Bevor Sie die Kimi API mit Hermes Agent nutzen, aktivieren Sie Ihren Kimi-API-Schlüssel in der Kimi Offenen Plattform. Wir empfehlen mindestens 20 $, um Tier-2-Zugang freizuschalten, der die Latenz reduziert und eine stabilere Leistung bei komplexen, mehrstufigen Aufgaben unterstützt

Schritt 2: Erstellen Sie Ihren Kimi-API-Schlüssel

Gehen Sie zum Abschnitt API-Schlüssel in der Kimi Offenen Plattform und klicken Sie auf API-Schlüssel erstellen. Denken Sie daran, Ihren API-Schlüssel zu kopieren und sicher aufzubewahren, da er bei der Erstellung nur einmal angezeigt wird.

Schritt 3: Geben Sie Ihren API-Schlüssel ein

Fügen Sie Ihren Kimi-API-Schlüssel ein und verbinden Sie Hermes Agent.

Schritt 3: Hermes Agent starten

Sobald das Modell konfiguriert ist, starten Sie die klassische CLI:

Oder probieren Sie die neuere Terminal-UI aus:

Sie sollten einen Willkommensbildschirm oder eine Eingabeaufforderung sehen, die Ihren ausgewählten Anbieter bzw. Ihr Modell anzeigt. Testen Sie es mit einer einfachen Anfrage:

So sieht Erfolg aus:

Wenn Hermes Agent startet, aber mit Modell- oder Authentifizierungsfehlern antwortet, führen Sie aus:

Wählen Sie dann Ihren Anbieter erneut aus und überprüfen Sie den API-Schlüssel oder die OAuth-Anmeldung.

Schritt 4: Hermes Agent in einen Bot verwandeln

Wie OpenClaw kann auch Hermes Agent als Bot fungieren und sich mit Ihren Chat-Apps verbinden:

Nach der Einrichtung prüfen Sie den Gateway-Status:

Nutzen Sie das Gateway erst, wenn Ihr Modellanbieter im Terminal funktioniert. Kann die CLI keinen einfachen Chat abschließen, schlägt der Bot in der Regel aus demselben Grund fehl.

Häufige Installationsprobleme bei Hermes Agent

hermes: command not found

Ursache: Ihr Terminal hat die PATH-Änderung noch nicht neu geladen.

Lösung:

Oder:

Versuchen Sie dann:

git: command not found

Ursache: Git ist nicht installiert.

Lösung für Ubuntu, Debian oder WSL2:

Lösung für macOS mit Homebrew:

API-Schlüssel nicht gesetzt

Ursache: Hermes Agent ist installiert, aber es ist kein Anbieterschlüssel oder Login konfiguriert.

Lösung:

Oder setzen Sie den Schlüssel manuell:

hermes doctor meldet fehlende oder veraltete Konfiguration

Ursache: Ihre Konfigurationsdatei ist nach einem Update möglicherweise unvollständig.

Lösung:

Benutzerdefinierter Endpunkt verbindet sich, liefert aber fehlerhafte Antworten

Ursache: Die Basis-URL, der Modellname oder die Kontextlänge sind falsch.

Lösung: Testen Sie den Endpunkt zunächst in einem separaten Client, bestätigen Sie, dass er OpenAI-kompatibel ist, und stellen Sie sicher, dass das Modell für normale Hermes-Agent-Workflows mindestens 64K Kontext unterstützt.

Kurzübersicht der Befehle

Fazit

Der einfachste Weg, Hermes Agent zu installieren, ist die Nutzung des offiziellen Ein-Zeilen-Installers, das Neuladen Ihrer Shell, das Ausführen von hermes model und die Überprüfung der Einrichtung mit einem echten Chat sowie hermes doctor. Halten Sie Ihre erste Einrichtung einfach: eine Maschine, ein Anbieter, eine funktionierende Konversation. Sobald der grundlegende Hermes-Agent-Assistent stabil läuft, können Sie sicher darauf aufbauen – mit Docker-Isolation, Gateway-Bots, Skills, geplanten Automatisierungen und benutzerdefinierten Modellanbietern.