Coding Agents einrichten

Hermes Agent einrichten: API Key, Base URL und Modelle

Installiere Hermes Agent, konfiguriere die BetterToken Base URL und API Key, wähle ein verfügbares Modell und behebe typische Einrichtungsfehler.

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

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Zusätzliche Anforderungen

Kopieren Sie die genaue Model ID aus der model plaza.
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)

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

Linux / macOS / WSL2

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

Windows PowerShell

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

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

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 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.

Konfigurationsdateien

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 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 aus der model plaza 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 aus der model plaza ist.
Kopieren Sie die genaue Model ID aus der model plaza.
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.

Wenn ein Gateway zusätzliche Authentifizierungsheader erfordert, unterstützt Hermes extra_headers unter providers.<provider-name> in config.yaml. Folge der Anleitung zur Konfiguration benannter Provider, um die erforderlichen Header-Namen zu ermitteln. Halte Zugangsdaten vertraulich.

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.