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.)→ Speichern
config.yaml - Nutzung
hermes 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: Standard
localDas 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 |