Hermes-Agent

In den letzten Jahren hat sich das Feld der KI-Agenten rasant entwickelt – von einfachen Chatbots hin zu Agenten, die tatsächlich Dinge tun können, über ein persistentes Gedächtnis verfügen und autonom wachsen.

Hermes Agent ist ein autonomes KI-Agenten-Framework, das von Nous Research als Open Source veröffentlicht wurde. Als autonomer KI-Agent, der über natürliche Sprache interagiert, kann er Terminalbefehle ausführen, einen Browser steuern, Dateien lesen und schreiben, im Internet suchen, Bilder generieren und Erinnerungen über Sitzungen hinweg bewahren.

• GitHub-Repository:https://github.com/nousresearch/hermes-agent
• Offizielle Website von Hermes Agent:https://hermes-agent.nousresearch.com/

Die offizielle Definition ist ganz einfach:

The agent that grows with you.
一个会随着使用不断成长的 Agent.

Es ist ein autonomer Agent, der umso leistungsfähiger wird, je länger er läuft.

Die Kernphilosophie von Hermes Agent ist:KI zu einem langfristig immer verfügbaren digitalen Mitarbeiter zu machen, nicht zu einem Wegwerf-Chatbot.

Hermes Agent ist einer der wenigen in der Brancheein KI-Agent mit einer nativ integrierten Lernschleife, der Fähigkeiten aus Ausführungserfahrung extrahieren, Fähigkeiten autonom optimieren, Wissen persistent speichern, historische Konversationen abrufen und das kognitive Modell des Nutzers über Sitzungen hinweg kontinuierlich verfeinern kann.

Unterschiede zu gewöhnlichen KI-Chat-Tools:

Dimension	Gewöhnlicher KI-Chat (z. B. ChatGPT)	Hermes-Agent
Gedächtnis	Jede Konversation beginnt von vorn	Persistentes Gedächtnis über Sitzungen hinweg; versteht dich besser, je mehr du es nutzt
Ausführungsfähigkeit	Kann nur Text generieren	Kann Terminalbefehle ausführen, Dateien manipulieren, Browser steuern
Ausführungsort	Cloud, Daten werden zum Dienstanbieter hochgeladen	Lokal oder auf deinem eigenen Server, Daten verlassen dich nie
Erweiterbarkeit	Geschlossenes Ökosystem	Offener Skill-Standard (agentskills.io), MCP-Ökosystem
Zugriffsmethoden	Web	CLI + Telegram/Discord/Slack/WhatsApp usw.
Modellbindung	Festes Modell	Unterstützt 300+ Modelle, jederzeit wechselbar, kein Lock-in

Kernfunktionen:

• Verbinden:Telegram, Discord, Slack, WhatsApp, Signal, Email, CLI—ein Agent, einheitliches Gedächtnis, alle Plattformen. Eine auf Telegram begonnene Konversation kann nahtlos im Terminal fortgesetzt werden.
• Erinnern:Hermes lernt deine Projekte, generiert automatisch Skills und vergisst nie die Probleme, die es gelöst hat. Nach jeder Sitzung werden wichtige Informationen in das persistente Gedächtnis geschrieben.
• Planen:Lege geplante Aufgaben in natürlicher Sprache fest—tägliche Berichte, Backups, Routineprüfungen, Morgenbriefings—die unbeaufsichtigt im Hintergrund laufen.
• Delegieren:Erzeuge isolierte Sub-Agenten mit unabhängigen Konversationskontexten, unabhängigen Terminals und Python-RPC-Skripten, die parallele Pipelines mit null Kontextkosten ermöglichen.
• Suche & Multimodal:Websuche, Browser-Automatisierung, visuelles Verständnis, Bildgenerierung, Text-to-Speech und Multi-Modell-Reasoning—alles integriert.

Hermes Agent unterstützt den freien Wechsel zwischen jedem wichtigen Modell, einschließlichNous Portal, OpenRouter (200+ Modelle), OpenAI, GLM, Kimi, MiniMaxusw., ausführenhermes modelum sofort zu wechseln, keine Codeänderungen, kein Vendor-Lock-in.

Provider	Beschreibung	Einrichtungsmethode
Nous Portal	Abonnementbasiert, keine Konfiguration	viahermes modelOAuth-Login
OpenAI Codex	ChatGPT OAuth, verwendet das Codex-Modell	viahermes modelGerätecode-Authentifizierung
Anthropic	Claude-Modell direkt verwenden	Über Claude Code-Authentifizierung oder Anthropic API-Schlüssel
OpenRouter	Multi-Provider-Routing	API-Schlüssel eingeben
DeepSeek	Direkter Zugriff auf die DeepSeek-API	EinrichtungDEEPSEEK_API_KEY
Hugging Face	Zugriff auf 20+ offene Modelle über einen einheitlichen Router	EinstellungenHF_TOKEN
Benutzerdefinierter Endpunkt	VLLM, SGLang, Ollama oder jede OpenAI-kompatible API	Basis-URL und API-Schlüssel festlegen

Natürlich ist der Kauf von etwas wie dem Coding Plan immer noch am kosteneffektivsten, da es sich um ein monatliches Abonnement handelt:

Funktionen	Funktionsbeschreibung
Native Terminal-Interaktion	Vollständige TUI-Oberfläche, unterstützt mehrzeilige Bearbeitung, Befehlsvervollständigung, Verlaufsabruf, Streaming-Ausgabe usw.
Plattformübergreifender Zugriff	Ein einziges Gateway, das CLI, Telegram, Discord, Slack, WhatsApp und andere Plattformen verbindet
Geschlossenes Lernsystem	Autonome Speicherverwaltung, Generierung und Optimierung von Fähigkeiten, sitzungsübergreifender Abruf, Benutzermodellierung
Geplante Automatisierung	Integrierter Cron-Planer, der 7×24-automatisierte Aufgaben wie Tagesberichte, Backups und Audits unterstützt
Parallele Aufgabenverarbeitung	Unterstützt die parallele Ausführung von Sub-Agenten, Aufteilung mehrerer Workflows und RPC-Tool-Aufrufe
Betrieb in mehreren Umgebungen	Unterstützt 6 Backends, darunter lokal, Docker, SSH, Daytona, Modal usw.
Fähigkeiten auf Forschungsniveau	Unterstützt Trajektoriengenerierung, Umgebungen für bestärkendes Lernen und Komprimierung von Trainingsdaten

Gesamtarchitektur

Gesamter Workflow:

Architekturdiagramm:

Modul	Funktion	Beispiel
Zugriffsschicht (Clients)	Empfängt Benutzeranfragen	Web, App, API, Feishu
Eingabeschicht (Input)	Verarbeitet verschiedene Eingabedaten	Text, Bilder, PDF, Excel
Scheduler (Agent-Orchestrator)	Versteht Aufgaben und zerlegt Ausführungs-Workflows	Anforderungen analysieren → Plan formulieren
Fähigkeitsschicht (Capabilities)	Bietet Ausführungsfähigkeiten	Dialog, Retrieval, Codeausführung
Speicherschicht (Memory)	Speichert Kontext und historische Informationen	Sitzungsspeicher, Langzeitspeicher
Wissensschicht (Knowledge)	Bietet Wissensabruf-Funktionen	RAG, Vektordatenbank
Modellschicht (Model Layer)	Bietet Reasoning-Fähigkeiten	GPT, Claude, lokale Modelle
Werkzeugschicht (Tools)	Ruft externe Tools auf, um Aufgaben zu erledigen	Suche, Datenbank, API
Externe Dienste	Integration mit Geschäftssystemen	ERP, CRM, Cloud-Dienste
Infrastrukturschicht (Infrastruktur)	Unterstützen den Betrieb des Systems.	Berechtigungen, Logs, Monitoring

---

Schnellinstallation

Die folgenden Installationsbefehle gelten für Linux-, macOS- und WSL2-Systeme:

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

Nach Abschluss der Installation die Shell neu laden:

bashsource ~/.bashrc   # 使用 bash
# oder 
source ~/.zshrc    # 使用 zsh

Native Windows-Installation (PowerShell):

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

Die native Windows-Unterstützung ist noch experimentell; es wird empfohlen, vorrangig WSL2 zu verwenden.

macOS-/Windows-Desktopversion (Desktop-App):Gehen Sie zuhermes-agent.nousresearch.comLaden Sie den Desktop-Installer für Ihre Plattform herunter; CLI und Desktop-App werden zusammen installiert.

Nach dem Herunterladen einfach doppelklicken, um zu installieren:

Installation überprüfen

hermes --version

Die Ausgabe der Versionsnummer zeigt eine erfolgreiche Installation an.

Der Installer verarbeitet automatisch alle Abhängigkeiten:

• uvSchneller Python-Paketmanager
• Python 3.11— Installation über uv, kein sudo erforderlich.
• Node.js v22— Für Browser-Automatisierung und WhatsApp-Bridging.
• ripgrepSchnelle Dateisuche
• ffmpegTTS-Audioformat-Konvertierung

Windows-Systemanweisungen: : Die native Windows-Umgebung wird nicht unterstützt. Bitte installieren Sie zuerst WSL2 und führen Sie dann den obigen Befehl im WSL2-Terminal aus.

Wenn Sie OpenClaw installiert haben, können Sie die Konfiguration auch direkt importieren:

Konfigurieren Sie dann den Dienstanbieter; Sie können Ihren vorhandenen API-Schlüssel festlegen. Wählen Sie hier den Coding Plan von Bailian: Legen Sie den Modellnamen fest, zum Beispiel MiniMax-M2.5.

Wählen Sie hier, nicht zu importieren; Eingabe.n, Modelleinstellungen aufrufen, die erste Schnelleinstellung auswählen:

Als Nächstes wählen wir den vorletzten Eintrag, More providers:

Hier können Sie weitere nationale oder internationale große Modelle auswählen:

Als Nächstes verwenden wir.Byte Ark Coding Plan, daher wirdKundenendpunkt ausgewähltDas heißt, die benutzerdefinierte API-Adresse und der API-Schlüssel.

Basis-URL konfiguriert das ByteDance Ark Tool, kompatibel mit dem OpenAI-Schnittstellenprotokoll:https://ark.cn-beijing.volces.com/api/coding/v3

Legen Sie den API-Schlüssel und die unterstützten großen Modelle fest, zum Beispielark-code-latest。

Führen Sie nach der Installation den folgenden Befehl aus:

source ~/.bashrc    # 重载shell配置（若使用zsh，执行：source ~/.zshrc）
hermes              # 开启智能体对话！

Schnellstart

hermes              # 交互式命令行界面 — 开启对话
hermes model        # 选择大语言模型服务商与对应模型
hermes tools        # 配置启用的工具集
hermes config set   # 设置单项配置项
hermes gateway      # 启动消息网关（支持Telegram、Discord等平台）
hermes setup        # 运行全量配置向导（一站式完成所有配置）
hermes claw migrate # 从OpenClaw迁移数据（适用于原OpenClaw用户）
hermes update       # 更新至最新版本
hermes doctor       # 诊断运行环境与配置问题

---

Manuelle Installation

Wenn Sie die volle Kontrolle über den Installationsprozess bevorzugen, folgen Sie diesen Schritten.

Schritt 1: Repository klonen

Verwenden Sie--recurse-submodulesum zu klonen und die erforderlichen Submodule abzurufen:

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Wenn Sie bereits geklont haben, aber ohne Submodule:

git submodule update --init --recursive

Schritt 2: uv installieren und eine virtuelle Umgebung erstellen

# 安装 uv（如果尚未安装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建 Python 3.11 的虚拟环境（uv 会在需要时下载，无需 sudo）
uv venv venv --python 3.11

Schritt 3: Python-Abhängigkeiten installieren

# 告诉 uv 要安装到哪个虚拟环境
export VIRTUAL_ENV="$(pwd)/venv"

# 安装所有扩展
uv pip install -e ".[all]"

Wenn Sie nur den Kern-Agenten möchten (ohne Telegram-/Discord-/Cron-Unterstützung):

uv pip install -e "."

Hinweise zu optionalen Erweiterungen:

Erweiterung	Merkmal	Installationsbefehl
all	Enthält alle folgenden Funktionen	uv pip install -e ".[all]"
messaging	Telegram- und Discord-Gateways	uv pip install -e ".[messaging]"
cron	Cron-Ausdruck-Parsing für geplante Aufgaben	uv pip install -e ".[cron]"
voice	CLI-Mikrofoneingabe und Audiowiedergabe	uv pip install -e ".[voice]"
mcp	Unterstützung für Model Context Protocol	uv pip install -e ".[mcp]"
honcho	KI-natives Gedächtnis (Honcho-Integration)	uv pip install -e ".[honcho]"

Wir können sie in Kombination verwenden:uv pip install -e ".[messaging,cron]"

Schritt 4: Konfigurationsverzeichnis erstellen

# 创建目录结构
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}

# 复制示例配置文件
cp cli-config.yaml.example ~/.hermes/config.yaml

# 创建空的 .env 文件用于存储 API 密钥
touch ~/.hermes/.env

Schritt 5: API-Schlüssel hinzufügen

Open~/.hermes/.envund fügen Sie mindestens einen LLM-Anbieter-Schlüssel hinzu:

# 必需 — 至少一个 LLM 提供商：
OPENROUTER_API_KEY=sk-or-v1-your-key-here

# 可选 — 启用其他工具：
FIRECRAWL_API_KEY=fc-your-key          # 网页搜索和抓取
FAL_KEY=your-fal-key                   # 图像生成（FLUX）

Oder legen Sie ihn über die CLI fest:

hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here

Schritt 6: hermes zum PATH hinzufügen

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

Wenn~/.local/binnicht im PATH ist, fügen Sie es bitte Ihrer Shell-Konfiguration hinzu:

# Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Schritt 7: Anbieter konfigurieren

hermes model       # 选择您的 LLM 提供商和模型

Schritt 8: Installation überprüfen

hermes version    # 检查命令是否可用
hermes doctor     # 运行诊断以验证一切正常
hermes status     # 检查您的配置
hermes chat -q "Hello! What tools do you have available?"

Fehlerbehebung

Problem	Lösung
hermes: command not found	Shell neu laden (source ~/.bashrc) oder PATH prüfen
API-Schlüssel nicht festgelegt	Führen Siehermes modelum den Anbieter zu konfigurieren, oderhermes config set OPENROUTER_API_KEY your_key
Konfiguration nach Update verloren	Führen Siehermes config checkdannhermes config migrate

Für weitere diagnostische Informationen führehermes doctor— es zeigt dir, was fehlt und wie du es behebst.

Hinweis:Du kannst jederzeit überhermes modelAnbieter wechseln — keine Codeänderungen, kein Lock-in.

---

Nachrichten-Gateway

Das Nachrichten-Gateway des Hermes Agent ermöglicht dir, mit dem Agenten über mehrere Plattformen hinweg zu interagieren — Telegram, Discord, Slack, WhatsApp, Signal, E-Mail, Home Assistant und mehr.

Unterstützte Plattformen

Plattform	Beschreibung	Status
Telegram	Die umfassendste Messaging-Plattform-Integration	✅ Unterstützt
Discord	Unterstützt Server und Sprachkanäle	✅ Unterstützt
Slack	Workspace-Integration	✅ Unterstützt
WhatsApp	Über WhatsApp Web	✅ Unterstützt
Signal	Private Nachrichten-App	✅ Unterstützt
Matrix	Dezentrale Kommunikation	✅ Unterstützt
Mattermost	Selbstgehostetes Messaging	✅ Unterstützt
E-Mail	SMTP-E-Mail	✅ Unterstützt
SMS	SMS-Versand	✅ Unterstützt
DingTalk	DingTalk	✅ Unterstützt
Feishu	Feishu	✅ Unterstützt
WeCom	WeCom	✅ Unterstützt
BlueBubbles	macOS iMessage	✅ Unterstützt
Home Assistant	Smart Home	✅ Unterstützt
Webhooks	Benutzerdefinierter HTTP-Callback	✅ Unterstützt

Einrichten der Messaging-Plattform

Interaktive Einrichtung:

hermes gateway setup

Dadurch wird ein interaktiver Konfigurationsassistent gestartet, der dich durch die Einrichtung jeder Plattform führt.

Manuelle Konfiguration:

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

Telegram:

# 在 ~/.hermes/.env 中
TELEGRAM_BOT_TOKEN=your-bot-token

# config.yaml
gateway:
  adapters:
    telegram:
      enabled: true

Discord:

# 在 ~/.hermes/.env 中
DISCORD_BOT_TOKEN=your-discord-token

# config.yaml
gateway:
  adapters:
    discord:
      enabled: true
      allowed_channels:
        - "123456789"

Slack:

# 在 ~/.hermes/.env 中
SLACK_BOT_TOKEN=xoxb-your-token
SLACK_SIGNING_SECRET=your-signing-secret

# config.yaml
gateway:
  adapters:
    slack:
      enabled: true

WhatsApp:

# WhatsApp 需要浏览器自动化
# 首次设置需要扫描二维码

# config.yaml
gateway:
  adapters:
    whatsapp:
      enabled: true
      session_dir: ~/.hermes/whatsapp/session

E-Mail (SMTP):

# 在 ~/.hermes/.env 中
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=your-app-password

# config.yaml
gateway:
  adapters:
    email:
      enabled: true
      from_email: [email protected]

Home Assistant:

# 在 ~/.hermes/.env 中
HA_URL=http://homeassistant.local:8123
HA_TOKEN=your-long-lived-access-token

# config.yaml
gateway:
  adapters:
    homeassistant:
      enabled: true

Starten des Gateways

Im Vordergrund ausführen:

hermes gateway

Im Hintergrund ausführen (empfohlen):

hermes gateway &
# 或使用 systemd
systemctl enable hermes-agent
systemctl start hermes-agent

Mit Docker ausführen:

docker run -d \
  --name hermes-gateway \
  -v ~/.hermes:/home/hermes/.hermes \
  ghcr.io/nousresearch/hermes-agent:latest \
  hermes gateway

Plattformspezifische Konfiguration

Telegram:

1. Erstelle einen neuen Bot über @BotFather
2. Bot-Token abrufen
3. Hermes konfigurieren und ausführen
4. Eine Nachricht an deinen Bot in Telegram senden/start

Discord:

1. Eine Anwendung im Discord Developer Portal erstellen
2. Den Bot zu einem Server hinzufügen
3. Bot-Token abrufen
4. Hermes konfigurieren und ausführen

Slack:

1. Eine neue App im Slack App Portal erstellen
2. Bot-Token-Scopes hinzufügen
3. Im Workspace installieren
4. Hermes konfigurieren und ausführen

Nachrichten senden:

Verwenden Siesend_messageTool zum Senden von Nachrichten über einen beliebigen konfigurierten Kanal:

send_message(
  platform="telegram",
  chat_id="123456789",
  message="Hello from Hermes!"
)

Oder automatisierte Nachrichten per Cron planen:

# 设置每日简报
hermes
❯ 每天早上9点检查 Hacker News 上的 AI 新闻，并通过 Telegram 给我发送摘要

Sprachunterstützung

Einige Plattformen unterstützen Sprachinteraktion:

• Telegram: Sprachnachrichten und Sprachanrufe
• Discord: Sprachkanäle und Sprachnachrichten
• CLI: Mikrofoneingabe und TTS

Weitere Details zu Sprachmodi finden Sie im Voice Mode Guide.

Sicherheitsaspekte

Fehlerbehebung

Problem	Lösung
Bot reagiert nicht	Prüfen, ob das Gateway läuft
Berechtigungsfehler	Bot-Token und Berechtigungen überprüfen
Nachrichten werden nicht gesendet	Kanal-ID und Konfiguration überprüfen
Verbindungszeitüberschreitung	Netzwerk- und Firewall-Einstellungen überprüfen

Tipp:Verwenden Siehermes gateway --verboseum detaillierte Protokolle zur Fehlersuche anzuzeigen.

Weitere Erweiterungen