Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Hermes-Bereitstellungsanleitung

Für terminalbasierte KI-Agenten: Installation der Umgebung, Modellkonfiguration und Fehlerbehebung.

Geeignete Einsatzszenarien: Hermes Agent ist ein quelloffener Terminal-Agent von Nous Research. Er eignet sich für lokale Kommandozeilenarbeit, Dateioperationen, Web-, Bild- und Sprachtools, persistente Erinnerungen und Messaging-Gateways. Diese Anleitung behandelt nacheinander die Systemvorbereitung, die Installation von Hermes, die Modellkonfiguration über das LLM API Gateway, den Start von Chat und Gateway sowie die Fehlerbehebung.

KonfigurationselementEmpfohlener WertHinweis
ProviderMore Provider / Custom / OpenAI CompatibleDie Bezeichnung unterscheidet sich je nach Version. Wählen Sie eine Option, bei der Sie eine eigene URL eintragen können.
Base URLhttps://api.llm-token.cn/v1Verwenden Sie zunächst den Basispfad mit /v1. Falls er nicht funktioniert, versuchen Sie https://api.llm-token.cn.
API-Keysk-xxxxxxxxEs ist normal, dass das Terminal beim Einfügen keinen Klartext anzeigt.
Empfohlenes Modellclaude-sonnet-4-6Reagiert schnell und unterstützt Agentenfunktionen, Bildverständnis und ein großes Kontextfenster. Sie können auch ein anderes Modell aus der Modellliste verwenden.

1. Was ist Hermes?

Hermes Agent kann im Terminal chatten, Befehle ausführen, Dateien lesen, schreiben und durchsuchen sowie Web- und Multimodaltools aufrufen. Persistente Erinnerungen speichern langfristige Präferenzen. Damit eignet sich Hermes als kontinuierlich arbeitender KI-Agent auf einem lokalen Rechner oder Server.

Empfehlung für Einsteiger: Bringen Sie zuerst den Chat in der Kommandozeile zum Laufen und richten Sie danach Messaging-Kanäle wie Telegram, Discord oder WeChat ein. Eine funktionierende Minimalkonfiguration erleichtert die spätere Fehlerbehebung erheblich.

2. Installationsmethode auswählen

SystemEmpfohlene MethodeBefehl / Hinweis
Windows / macOS, normale NutzungHermes DesktopVerwenden Sie vorzugsweise den Desktop-Installer.
Linux / macOS / WSL2 / TermuxOffizielles Installationsskript
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Natives Windows PowerShellOffizielles PowerShell-Skript
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Robuste Windows-VarianteWSL2 + UbuntuWechseln Sie zu WSL2, falls die native Windows-Installation Probleme bereitet.

3. WSL2 unter Windows installieren

  1. Öffnen Sie die PowerShell als Administrator.
  2. Führen Sie den WSL-Installationsbefehl aus.
wsl --install

Wenn die Installation bei 0 % feststeckt, können Sie stattdessen folgenden Befehl verwenden:

wsl --install --web-download -d Ubuntu
  1. Starten Sie den Computer nach Aufforderung neu.
  2. Legen Sie beim ersten Start von Ubuntu einen Linux-Benutzernamen und ein Passwort fest.
  3. Drücken Sie die Windows-Taste und suchen Sie nach WSL oder Ubuntu. Wenn der Eintrag angezeigt wird, ist die Installation verfügbar.

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

Überprüfen Sie, ob WSL erfolgreich installiert wurde:

wsl --version

4. Git und Hermes installieren

Führen Sie im WSL2/Ubuntu-Terminal aus:

sudo apt update
sudo apt install git -y
git --version

Installieren Sie anschließend Hermes:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Laden Sie nach der Installation die Shell-Konfiguration neu und prüfen Sie die Installation:

source ~/.bashrc
hermes version
hermes doctor

Screenshot zur Hermes-Installation mit dem Befehl hermes --version und dem angezeigten Pfad /home/omen/.hermes/hermes-agentScreenshot zur Hermes-Installation mit dem Befehl hermes --version und d…

Hinweis: hermes updata in einer älteren Anleitung ist ein Tippfehler. Der richtige Update-Befehl lautet hermes update.

5. Modell über das LLM API Gateway konfigurieren

  1. Führen Sie im Terminal, in dem Hermes installiert ist, folgenden Befehl aus:
hermes setup

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

  1. Wählen Sie die Schnell- oder Modellkonfiguration.
  2. Wählen Sie More Provider / Custom Provider.
  3. Wählen Sie OpenAI Compatible beziehungsweise eine Option für eine benutzerdefinierte URL.

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

Verwenden Sie zunächst diese URL:

https://api.llm-token.cn/v1

Falls die Validierung in Ihrer Version fehlschlägt, versuchen Sie stattdessen:

https://api.llm-token.cn

Screenshot zur Hermes-Endpunktkonfiguration mit den Adressen https://api.example.com/v1 und https://api.llm-token.cn/v1Screenshot zur Hermes-Endpunktkonfiguration mit den Adressen https://api…

  1. Fügen Sie den API-Key ein. Dass das Terminal dabei keinen Klartext anzeigt, ist normal; drücken Sie anschließend die Eingabetaste.
  2. Beginnen Sie den Test mit claude-sonnet-4-6.
  3. Wenn Hermes nach der Kontextlänge fragt, können Sie für claude-sonnet-4-6 ein großes Kontextfenster angeben. Bei strengen Clientgrenzen beginnen Sie mit 32000 und erhöhen den Wert erst nach einem erfolgreichen Test schrittweise.
  4. Überspringen Sie den Messaging-Kanal bei der ersten Einrichtung und konfigurieren Sie das Gateway erst, wenn der Terminalchat zuverlässig funktioniert.

Hermes-Modellauswahl mit der Base URL https://api.example.com/v1 sowie den Einträgen claude-sonnet-4-6 und claude-sonnet-4-6-thinking; Listenposition 1 ist claude-sonnet-4-6Hermes-Modellauswahl mit der Base URL https://api.example.com/v1 sowie d…

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

6. Chat und Gateway aktivieren

Nach Abschluss der Konfiguration können Sie direkt den Chat starten. Wenn Hermes fragt, ob der Chat geöffnet werden soll, geben Sie Y ein.

Screenshot zur Konfiguration von HermesScreenshot zur Konfiguration von Hermes

Falls ein konfigurierter Messaging-Kanal nicht reagiert, starten beziehungsweise prüfen Sie das Gateway:

hermes gateway
hermes gateway status

7. Kurzreferenz wichtiger Befehle

BefehlZweck
hermesStartet den Chat.
hermes setupÖffnet den vollständigen Konfigurationsassistenten erneut.
hermes modelWechselt Modell oder Anbieter.
hermes doctorPrüft Abhängigkeiten, Konfiguration und Dienststatus.
hermes updateAktualisiert Hermes.
hermes --continueSetzt die vorherige Sitzung fort.

8. Häufige Probleme

ProblemLösung
hermes: command not foundFühren Sie source ~/.bashrc aus oder öffnen Sie das Terminal erneut. Falls der Fehler bestehen bleibt, prüfen Sie PATH.
Modellvalidierung fehlgeschlagenPrüfen Sie URL, API-Key und Modell-ID. Verwenden Sie vorzugsweise https://api.llm-token.cn/v1.
Antwort bricht ab oder Kontextfenster ist zu kleinÖffnen Sie hermes setup erneut oder passen Sie die context length in der Konfigurationsdatei an. Stellen Sie zuerst eine funktionierende Verbindung her und erhöhen Sie dann den Wert.
WSL2 erreicht lokale Windows-Dienste nichtUnter Windows 11 können Sie WSL Mirrored Networking verwenden; unter Windows 10 kann die Standard-Gateway-IP von WSL anstelle von localhost verwendet werden.
Konfiguration fehlt nach einem UpdateFühren Sie hermes config check und hermes config migrate aus.
[wsl2]
networkingMode=mirrored
wsl --shutdown

Codex-Bereitstellungsanleitung

Installation des CLI-Tools, API-Anbindung und Konfiguration der Entwicklungsumgebung.

gpt-image-2: Konfigurationsanleitung

Anleitung zur Bildgenerierung mit Cherry Studio, Skill-Paketen und Skripten.

Abschnitte auf dieser Seite

1. Was ist Hermes?2. Installationsmethode auswählen3. WSL2 unter Windows installieren4. Git und Hermes installieren5. Modell über das LLM API Gateway konfigurieren6. Chat und Gateway aktivieren7. Kurzreferenz wichtiger Befehle8. Häufige Probleme