Hermes Agent einrichten: Installation, API Key, Base URL und eigene Modelle

Um Hermes Agent mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

Voraussetzungen

Die aktuelle Version des Tools ist installiert
Ein BetterToken API Key: Registriere dich und erhalte einen
Eine Model ID aus der model plaza

Zusätzliche Anforderungen

Die ausgewählte Model ID stammt vom unterstützten Provider
macOS, Linux, Windows 10/11 oder WSL2
Ein Modell mit mindestens 64K Kontextfenster für die Tool-Nutzung

Installation

Hermes Agent installieren

Desktop (macOS / Windows)
Linux / macOS / WSL2
Windows PowerShell

Hermes empfiehlt den Desktop-Installer für macOS und Windows. Hermes Desktop herunterladen und den Installer für das eigene Betriebssystem ausführen.

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

Hermes Agent unterstützt Windows 10 und 11 nativ. Führe in PowerShell oder Windows Terminal Folgendes aus:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Administratorrechte sind nicht erforderlich. Öffne nach der Installation ein neues PowerShell-Fenster.

hermes --version
hermes doctor

WSL2 bleibt unterstützt, ist aber optional. Nutze es für eine Linux-Umgebung oder das eingebettete Terminal im Web Dashboard.

Schnelle Funktionsübersicht

Funktion	Zweck
Terminal UI	Direkt im Terminal mit dem Agent chatten
Skills	Wiederverwendbare Workflows für wiederkehrende Aufgaben speichern
MCP	Lokale oder entfernte Tool-Funktionen verbinden
Geplante Aufgaben	Zeitgesteuerte Jobs und wiederkehrende Workflows ausführen
Subagents	Komplexe Arbeit auf fokussierte Agents aufteilen
Message gateway	Den Agent mit weiteren Nachrichteneinstiegspunkten verbinden

Manuelle Einrichtung

Verwende die interaktive Hermes-Agent-Modell-Einrichtung als primären Weg. Bearbeite die Konfigurationsdateien nur dann direkt, wenn du eine manuelle Einrichtung benötigst.

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

Einrichtung

Interactive setup
Konfigurationsdateien

Modellauswahl ausführen

Wenn ein Hermes-Chat geöffnet ist, beende zuerst die Sitzung. Führe dann Folgendes aus:

hermes model

Custom endpoint auswählen

Wähle Custom endpoint (self-hosted / VLLM / etc.) aus der Provider-Liste.

BetterToken-Konfiguration ausfüllen

Gib Folgendes ein:

Base URL: https://bettertoken.ai/v1
API Key: dein BetterToken API Key
Model: eine Model ID eines unterstützten Providers aus der model plaza

Wenn Hermes nach dem API-Modus fragt, wähle Chat Completions. Verwende für Agent-Tools ein Modell mit mindestens 64K Kontext.

Hermes Agent starten

hermes --tui

Führe hermes aus, wenn du die klassische Terminal-Oberfläche bevorzugst.

Füge den Custom Provider in ~/.hermes/config.yaml hinzu:

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: "https://bettertoken.ai/v1"

Speichere den BetterToken API Key separat in ~/.hermes/.env:

OPENAI_API_KEY=YOUR_API_KEY

Ersetze YOUR_MODEL_ID durch eine Model ID eines unterstützten Providers aus der model plaza und YOUR_API_KEY durch deinen BetterToken API Key. Unter nativem Windows liegen diese Dateien in %LOCALAPPDATA%\hermes\.

Von OpenClaw migrieren

Wenn du bereits OpenClaw verwendest, prüfe zuerst, ob deine aktuelle Hermes-Agent-Version den Migrationsbefehl bereitstellt. Führe vor jeder Änderung einen Testlauf durch.

hermes claw migrate --dry-run

Führe nach Bestätigung der Ausgabe die Migration aus:

hermes claw migrate

Prüfe nach der Migration weiterhin die Hermes-Agent-Base URL, API Key und Model ID. Sie sollten https://bettertoken.ai/v1, deinem BetterToken API Key und einer Model ID eines unterstützten Providers entsprechen.

Verbindung überprüfen

Starte Hermes Agent und sende diese kurze Testanweisung: Reply with HERMES_OK only. Do not use tools. Wenn die Antwort genau HERMES_OK lautet, funktioniert die Verbindung.

Modelle wechseln

Führe außerhalb einer Sitzung hermes model aus. Verwende in einem aktiven Chat /model, um zwischen bereits konfigurierten Providern oder Modellen zu wechseln. Wähle die genaue Model ID aus der model plaza.

Häufige Fehler

Fehler	Prüfen
`401` oder `Unauthorized`	Prüfe den BetterToken API Key und entferne führende oder nachgestellte Leerzeichen.
`404`	Prüfe die Base URL und hänge keinen spezifischen Endpunktpfad an.
`model not found`	Kopiere eine aktuelle Model ID aus der model plaza.
Änderungen werden nicht angewendet	Speichere die Konfiguration und starte das Tool vollständig neu.

Fehlerbehebung

Wenn Requests fehlschlagen oder keine Antwort zurückgeben, bestätige, dass Base URL genau https://bettertoken.ai/v1 ist. Hänge in diesem Feld nicht /chat/completions an.
Wenn Hermes meldet, dass das Modell nicht existiert, bestätige, dass Model eine Model ID eines unterstützten Providers aus der model plaza ist.
Wenn die Authentifizierung fehlschlägt, prüfe auf kopierte Leerzeichen und bestätige, dass die ausgewählte Model ID vom unterstützten Provider stammt.
Wenn Hermes nach einer Änderung weiterhin das alte Modell verwendet, beende die aktuelle Hermes-Agent-Sitzung und führe hermes erneut aus.
BetterToken benötigt normalerweise keinen zusätzlichen User-Agent oder eigene Header. Füge Header nur hinzu, wenn dein eigenes Gateway, Tenant-Routing, deine Observability- oder Caching-Schicht sie ausdrücklich verlangt.

Committe keine echten API Keys in dein Repository. Bevorzuge für teamübergreifende Einrichtung Umgebungsvariablen oder lokale Konfiguration.

Advanced setup

Unterstützte Provider

Provider	Status
Claude	Nicht unterstützt
GPT	Manuelle Konfiguration
Kimi	Manuelle Konfiguration
GLM	Manuelle Konfiguration

Die Statusangaben gelten für die auf dieser Seite beschriebene BetterToken-Konfiguration.

Bedeutung der Einrichtungsmethoden

Manuelle Konfiguration: Gib API Key, Base URL und Model ein.
Nicht unterstützt: Derzeit gibt es keine verifizierte Methode für die direkte Verbindung.

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

Diese Einrichtung verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge /chat/completions oder /responses nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.

Erste Schritte

Coding Agents einrichten

KI-Anwendungsplattformen einrichten

Erweiterte Konfiguration

Hermes Agent einrichten: Installation, API Key, Base URL und eigene Modelle

Wichtige Einstellungen

Voraussetzungen

Zusätzliche Anforderungen

Installation

Hermes Agent installieren

Schnelle Funktionsübersicht

Manuelle Einrichtung

Einrichtung

Von OpenClaw migrieren

Verbindung überprüfen

Modelle wechseln

Häufige Fehler

Fehlerbehebung

Verwandte FAQ

Advanced setup

Unterstützte Provider

Technische Details

​Wichtige Einstellungen

​Voraussetzungen

​Zusätzliche Anforderungen

​Installation

​Hermes Agent installieren

​Schnelle Funktionsübersicht

​Manuelle Einrichtung

​Einrichtung

​Von OpenClaw migrieren

​Verbindung überprüfen

​Modelle wechseln

​Häufige Fehler

​Fehlerbehebung

​Verwandte FAQ

​Advanced setup

​Unterstützte Provider

​Technische Details

Wichtige Einstellungen

Voraussetzungen

Zusätzliche Anforderungen

Installation

Hermes Agent installieren

Schnelle Funktionsübersicht

Manuelle Einrichtung

Einrichtung

Von OpenClaw migrieren

Verbindung überprüfen

Modelle wechseln

Häufige Fehler

Fehlerbehebung

Verwandte FAQ

Advanced setup

Unterstützte Provider

Technische Details