Hermes-Agent-Konfigurationsdatei

Nach der Installation werden alle Konfigurationen und Daten gespeichert in~/.hermes/Unten:

~/.hermes/
├── config.yaml      # 主配置文件(模型、工具、终端后端等)
├── .env             # API 密钥和 Secret(不提交到版本库)
├── auth.json        # OAuth 凭据(Nous Portal 等)
├── SOUL.md          # Agent 人格设定文件
├── memories/        # 持久记忆(MEMORY.md、USER.md)
├── skills/          # 技能文件(Agent 自动创建和管理)
├── cron/            # 定时任务配置
├── sessions/        # 网关会话记录
└── logs/            # 日志(API 密钥自动脱敏)

Wichtige Prinzipien:

  • Secrets (API-Schlüssel, Token, Passwörter)→ Speichern.env
  • Allgemeine Konfiguration (Modelle, Tools, Terminal-Backends usw.)→ Speichernconfig.yaml
  • Nutzunghermes config set KEY VALUEBefehle werden automatisch an die richtige Datei weitergeleitet

Modellanbieter auswählen

Führen Sie den folgenden Befehl aus, um die interaktive Auswahl aufzurufen:

hermes model

Empfohlener Pfad: Nous Portal (am einfachsten)

Ein Abonnement deckt 300+ Modelle + Tool Gateway (Websuche, Bildgenerierung, TTS, Cloud-Browser) ab, keine Notwendigkeit, mehrere API-Schlüssel separat zu beantragen:

hermes setup

Nach der Ausführung melden Sie sich per OAuth an, und die Anbieterkonfiguration sowie die Aktivierung des Tool Gateway werden automatisch abgeschlossen.

Übersicht gängiger Anbieter

Anbieter Funktionen Konfigurationsmethode
Nous Portal Abonnementbasiert, 300+ Modelle, Tool Gateway hermes setup --portalOAuth-Login
Anthropic Claude-Serie, Max-Abonnement unterstützt OAuth ANTHROPIC_API_KEYoder OAuth
OpenAI Codex ChatGPT OAuth, Codex-Modell hermes model→ OAuth-Gerätecode
OpenRouter Multi-Provider-Routing, 200+ Modelle OPENROUTER_API_KEY
xAI Grok OAuth SuperGrok / Premium+-Abonnement, kein API-Schlüssel erforderlich hermes model → xAI Grok OAuth
GitHub Copilot Copilot-Abonnement (GPT, Claude, Gemini) hermes model → OAuth
Google AI Studio Gemini-Serie GOOGLE_API_KEY
DeepSeek DeepSeek-Serie DEEPSEEK_API_KEY
Lokale Modelle (Ollama) Vollständig lokal, keine Kosten Benutzerdefinierte Basis-URL festlegen

Anforderungen an das Kontextfenster des Modells: Hermes erfordert, dass das Modell mindestens64,000 TokenKontext unterstützt. Bei der Verwendung lokaler Modelle stellen Sie sicher, dass eine ausreichende Kontextgröße in den Startparametern festgelegt ist (z. B.--ctx-size 65536)。

Anbieter wechseln

Sie können jederzeit wechseln, ohne Code zu ändern:

hermes model

Drei Setup-Modi

Erster Starthermes setupAn diesem Punkt werden Sie aufgefordert, einen Initialisierungsmodus auszuwählen:

Modus 1: Schnell-Setup (Nous Portal)

Kostenloser OAuth-Login, konfiguriert automatisch Modelle + Tool Gateway (Websuche, Bildgenerierung, TTS, Browser).Empfohlen für neue Benutzer.

Modus 2: Vollständige Einrichtung

Provider, Tool-Sets, Messaging-Plattformen usw. manuell nacheinander konfigurieren. Geeignet für Nutzer mit klaren Anforderungen und eigenen API-Schlüsseln.

Modus 3: Unbeschriebenes Blatt (Leerer Ausgangspunkt)

Nur das minimale Laufzeit-Set behalten (Provider, Datei-Tools, Terminal-Tools), alles andere ist aus. Geeignet für fortgeschrittene Nutzer, die präzise Kontrolle über die Fähigkeitsgrenzen des Agenten benötigen. Der Blank-Modus schreibt die Konfiguration explizit, um zu verhindernhermes updatedass danach automatisch neue Funktionen aktiviert werden.


Erste Konversation starten

Nach Abschluss der Konfiguration Hermes starten:

hermes          # 经典 CLI 模式
hermes --tui    # 现代 TUI 模式(推荐,支持鼠标、弹窗等)

Nach dem Start wird ein Willkommensbanner angezeigt, das das aktuelle Modell, die verfügbaren Tools und die geladenen Skills anzeigt.

Überprüfen, ob alles normal funktioniert

Mit einem einfachen, aber spezifischen Prompt testen:

Check my current directory, tell me what files are in it, and identify the main project entry file.

Erfolgsindikator:

  • Das Banner zeigt korrekt das von Ihnen ausgewählte Modell/den ausgewählten Provider an
  • Der Agent antwortet normal, ohne Fehlermeldungen
  • Kann bei Bedarf Tools aufrufen (Terminal, Dateilesen usw.)
  • Konversationen können über mehr als eine Runde fortgesetzt werden

Sitzungswiederherstellung überprüfen

Bestätigen, dass sitzungsübergreifende Kontinuität korrekt funktioniert:

Check my current directory, tell me what files are in it, and identify the main project entry file.

Grundlegende Bedienung der TUI-Oberfläche

Führen Siehermes --tuiNach dem Wechsel in den modernen TUI-Modus, gängige Operationen:

Aktion Tastenkürzel
Nachricht senden Enter
Zeilenumbruch für mehrzeilige Eingabe Alt+EnteroderCtrl+J
Die aktuelle Aufgabe des Agenten unterbrechen Nach direktem Eingeben einer neuen NachrichtEnter
Erzwungene Unterbrechung Ctrl+C
Alle Befehle anzeigen Eingabe/Autovervollständigung auslösen

Kern-Slash-Befehle

Befehl Funktion
/help Alle verfügbaren Befehle anzeigen
/tools Aktuell aktivierte Tools auflisten
/model Modelle zur Laufzeit wechseln
/memory Agent-Speicher anzeigen und verwalten
/skills Fähigkeiten anzeigen und verwalten
/save Aktuelle Unterhaltung speichern
/new Neue Sitzung starten (aktuelle Einstellungen beibehalten)
/verbose Ausführlichkeitsstufe der Tool-Aufruf-Ausgabe umschalten
/voice on Spracheingabemodus aktivieren

Konfiguration des Terminal-Ausführungs-Backends

Hermes unterstützt sechs Terminal-Ausführungsumgebungen, die bestimmen, wo die Shell-Befehle des Agenten ausgeführt werden:

Backend Wo Befehle ausgeführt werden Isolationsstufe Anwendbare Szenarien
local(Standard) Direkt auf dem lokalen Rechner ausführen Keine Entwicklung, persönliche Nutzung
docker In einem Docker-Container Vollständige Isolation Sichere Sandbox, CI/CD
ssh Remote-Server Netzwerkgrenzen Remote-Entwicklung, Hochleistungsrechner
modal Modal-Cloud-Sandbox Vollständig (Cloud-VM) Temporäres Cloud-Computing, Evaluierung
daytona Daytona-Arbeitsbereich Vollständig (Cloud-Container) Verwaltete Cloud-Entwicklungsumgebung
singularity Singularity-Container Namespace-Isolation HPC-Cluster, gemeinsam genutzte Maschinen

Zum Docker-Backend wechseln (empfohlen für die Produktion)

hermes config set terminal.backend docker

Oder direkt bearbeiten~/.hermes/config.yaml:

terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"

Sicherheitshinweise: StandardlocalDas Backend gibt dem Agenten dieselben Dateisystemberechtigungen wie Ihnen. Wenn Sie den Umfang der Operationen des Agenten einschränken möchten, wechseln Sie zudockerDas Backend ist der einfachste und effektivste Weg.


Toolset-Verwaltung

Hermes gruppiert über 70 integrierte Tools in 28 Toolsets, die nach Bedarf aktiviert oder deaktiviert werden können:

hermes tools    # 打开可视化工具集管理界面(curses UI)

Haupt-Toolsets

Toolset Enthaltene Funktionen
filesystem Datei lesen/schreiben, Verzeichnisoperationen
terminal Ausführung von Shell-Befehlen
web Websuche, Inhaltsextraktion
browser Vollständige Browser-Automatisierung (erfordert Playwright)
code Codeausführung (execute_codeTool)
vision Bildanalyse
audio Sprach-zu-Text, TTS
memory Werkzeuge zur Speicherverwaltung
skills Skill-Management-Tools
mcp MCP-Server-Toolset (dynamisch)

Ein bestimmtes Toolset deaktivieren: Dieses Toolset verschwindet vollständig aus dem System-Prompt, nicht nur deaktiviert – das spart Tokens und verhindert, dass der Agent Tools missbraucht, die er nicht verwenden sollte.


Gängige Befehle zur Konfigurationsverwaltung

# 查看当前完整配置
hermes config

# 用编辑器打开 config.yaml
hermes config edit

# 设置单个配置值(自动路由到正确文件)
hermes config set model anthropic/claude-sonnet-4-6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # 自动存入 .env

# 检查是否有新版本引入的配置项未填写
hermes config check

# 交互式补全缺失配置
hermes config migrate

# 诊断所有配置问题
hermes doctor

# 更新到最新版本
hermes update

Häufige Fehlerbehebung

Frage 1:hermes: command not found

# 刷新 Shell 配置
source ~/.bashrc   # 或 source ~/.zshrc

# 如果仍然找不到,检查 PATH
echo $PATH
# 确保 ~/.local/bin 在其中
export PATH="$HOME/.local/bin:$PATH"

Frage 2:API key not set/ Modell reagiert nicht

# 重新配置提供商
hermes model

# 或直接设置 API Key
hermes config set OPENROUTER_API_KEY sk-or-...

Problem 3: Leere oder unverständliche Antworten

Dies kann an einer falschen Provider-Authentifizierung oder Modellauswahl liegen:

# 重新选择模型
hermes model

# 全面诊断
hermes doctor

Problem 4: Fehler wegen unzureichendem Kontextfenster

Hermes erfordert, dass das Modell mindestens 64K-Token-Kontext unterstützt. Wechseln Sie zu einem Modell mit einem größeren Kontext oder erhöhen Sie den Kontextparameter bei der Verwendung lokaler Modelle (z. B. Ollama:OLLAMA_NUM_CTX=65536)。

Frage 5:hermes --continueAlte Konversationen können nicht gefunden werden

# 查看所有会话
hermes sessions list

# 确认当前 Profile
hermes profile list

Universelles Wiederherstellungs-Toolkit

Wenn du auf seltsame Probleme stößt, folge den untenstehenden Schritten in der angegebenen Reihenfolge:

hermes doctor           # 1. 诊断
hermes model            # 2. 检查模型配置
hermes setup            # 3. 重新向导配置
hermes sessions list    # 4. 查看会话状态
hermes --continue       # 5. 尝试恢复会话
hermes gateway status   # 6. 检查网关状态(如已启用)

Vorschau der erweiterten Konfiguration

Nach Abschluss der Basisinstallation können die folgenden Funktionen nach Bedarf aktiviert werden (detailliert in den nachfolgenden Kapiteln):

Mit Messaging-Plattform verbinden

hermes gateway setup    # 交互式配置 Telegram、Discord、Slack 等
hermes gateway          # 启动消息网关

Sprachmodus aktivieren

# 安装语音依赖
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"

# 在 CLI 中启用
/voice on
# 按 Ctrl+B 开始录音

MCP-Server verbinden

In~/.hermes/config.yamlHinzufügen in:

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
hermes mcp    # 交互式管理 MCP 服务器

Editor-Integration (ACP)

hermes acp    # 启动编辑器 Agent 模式(VS Code / Zed / JetBrains)

Schnellreferenz für Befehle

Befehl Beschreibung
hermes CLI-Konversation starten
hermes --tui TUI-Konversation starten (empfohlen)
hermes desktop Desktop-App starten
hermes model LLM-Anbieter und Modell auswählen/wechseln
hermes setup Vollständiger Setup-Assistent
hermes setup --portal Schnellkonfiguration von Nous Portal
hermes tools Toolset konfigurieren
hermes doctor Konfigurationsprobleme diagnostizieren
hermes update Auf die neueste Version aktualisieren
hermes gateway Nachrichten-Gateway starten
hermes gateway setup Messaging-Plattform konfigurieren
hermes --continue Letzte Unterhaltung fortsetzen
hermes config set KEY VAL Konfigurationselemente festlegen
hermes sessions list Unterhaltungsverlauf anzeigen
hermes profile list Agentenprofil anzeigen
Weitere Erweiterungen