> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Installiere Hermes Agent, konfiguriere die BetterToken Base URL und API Key, wähle ein kompatibles Provider-Modell und behebe häufige Fehler.

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://www.bettertoken.ai/v1`                                                           |
| Model    | Eine aktuelle Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

## Voraussetzungen

* Die aktuelle Version des Tools ist installiert
* Ein BetterToken API Key: <a href={"https://bettertoken.ai/register"}>Registriere dich und erhalte einen</a>
* Eine Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>

### Zusätzliche Anforderungen

* Die ausgewählte Model ID stammt vom **unterstützten Provider**
* macOS, Linux oder Windows WSL2

## Installation

### Hermes Agent installieren

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows">
    Unter Windows solltest du zuerst WSL2 bevorzugen. Die native PowerShell-Unterstützung hängt von deiner aktuellen Hermes-Agent-Version ab. Wenn du natives Windows verwendest, folge den Installationsaufforderungen deiner installierten Version.
  </Tab>
</Tabs>

### 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. Befehls- und Umgebungsvariablen-Optionen bleiben als Alternativen verfügbar.

| Feld     | Wert                                                                                      |
| -------- | ----------------------------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                                       |
| Base URL | `https://www.bettertoken.ai/v1`                                                           |
| Model    | Eine aktuelle Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

### Einrichtung

<Tabs>
  <Tab title="Interactive setup">
    <Steps>
      <Step title="Modellauswahl ausführen">
        ```bash theme={null}
        hermes model
        ```
      </Step>

      <Step title="OpenAI- oder OpenAI-Compatible-Provider auswählen">
        Wähle **OpenAI** oder **OpenAI Compatible** aus der Provider-Liste.
      </Step>

      <Step title="BetterToken-Konfiguration ausfüllen">
        Gib Folgendes ein:

        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: dein BetterToken API Key
        * **Model**: eine **Model ID eines unterstützten Providers** aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>
      </Step>

      <Step title="Hermes Agent neu starten">
        Beende nach der Aktualisierung der Konfiguration die aktuelle Hermes-Agent-Sitzung und starte sie erneut.
      </Step>

      <Step title="Hermes Agent starten">
        ```bash theme={null}
        hermes
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI config">
    Wenn du Befehle lieber kopierst und einfügst, schreibe die Hermes-Agent-Konfiguration direkt.

    ```bash theme={null}
    hermes config set llm.provider openai
    hermes config set llm.base_url "https://www.bettertoken.ai/v1"
    hermes config set llm.api_key "YOUR_API_KEY"
    hermes config set llm.model "YOUR_MODEL_ID"
    ```

    Ersetze `YOUR_API_KEY` durch deinen BetterToken API Key und `YOUR_MODEL_ID` durch eine Model ID eines unterstützten Providers aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>.

    Starte anschließend Hermes Agent:

    ```bash theme={null}
    hermes
    ```
  </Tab>

  <Tab title="Environment variables">
    Wenn du den API Key nicht in der Hermes-Agent-Konfiguration speichern möchtest, exportiere ihn in der aktuellen Shell.

    ```bash theme={null}
    export OPENAI_API_BASE="https://www.bettertoken.ai/v1"
    export OPENAI_API_KEY="YOUR_API_KEY"
    export HERMES_MODEL="YOUR_MODEL_ID"
    hermes
    ```

    Diese Variablen gelten nur für die aktuelle Shell-Sitzung. Exportiere sie in einem neuen Terminal erneut oder füge sie deinem eigenen Shell-Profil hinzu.
  </Tab>
</Tabs>

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

```bash theme={null}
hermes claw migrate --dry-run
```

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

```bash theme={null}
hermes claw migrate
```

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

## Verbindung überprüfen

Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

## Modelle wechseln

Öffne die Modellauswahl oder ändere das Feld `Model` in der Konfiguration. Verwende die genaue Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> und starte dann die aktuelle Sitzung neu.

## 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://www.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 <a href={"https://bettertoken.ai/pricing"}>model plaza</a> 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.

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

### Verwandte FAQ

* [MCP, API Key und Base URL: Unterschiede](/de/faq/concepts/mcp-vs-api-key-base-url)
* [Was sind model\_provider, base\_url und wire\_api?](/de/faq/codex/model-provider-base-url-wire-api)
* [OpenAI-kompatible API in Cline konfigurieren](/de/faq/cline/openai-compatible-api)
* [BetterToken-Einrichtungsanleitung für OpenClaw](/de/ai-tools/openclaw)

## Advanced setup

## Unterstützte Provider

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

<Note>Die Statusangaben gelten für die auf dieser Seite beschriebene BetterToken-Konfiguration.</Note>

<Accordion title="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.
</Accordion>

## Technische Details

<Accordion title="Protokoll, Endpunkt und interne Provider-Felder">
  Diese Einrichtung verwendet `https://www.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.
</Accordion>