Das häufigste Problem ist, dass der Dienst komplett hängt, aber die URL fehlt /v1, Hermes' 8642 nicht online ist oder der Host in Docker als localhost geschrieben ist. Die offizielle Open-WebUI-Dokumentation listet diese drei Punkte direkt im Bereich zur Fehlerbehebung auf, also schauen wir uns hier am schnellsten an.
Minimale Fehlerbehebungssequenz
- Überprüfe, ob die Open-WebUI-Verbindungsadresse
http://host.docker.internal:8642/v1ist und nicht nur ein:8642. - Führe die
curl http://localhost:8642/healthnativ aus, um zu bestätigen, dass der Hermes API Server aktiv ist. - Nach
curl http://localhost:8642/v1/modelssolltest du denhermes-agentoder Profilnamen normal sehen können. - Wenn Open WebUI in Docker läuft, schreibe die Hermes-Adresse nicht als
localhostim Container, sondern verwende einehost.docker.internal-,--network=host- oder Bridge-IP.
Warum ist es einfach, hier festzustecken.
Da der Verbindungstest von Open WebUI bestehen kann, bedeutet das nicht, dass die Modellliste abgerufen wird. Verbindungstests sind eher so etwas wie "Sieht diese Adresse wie eine API aus?", und das Modell-Dropdown-Menü verlässt sich auch darauf, dass /v1/models den korrekten Inhalt zurückgibt.
Kurz gesagt: Das Modell-Dropdown-Menü ist leer, also installieren Sie nicht zuerst die Open WebUI neu. Priorisieren solltest du prüfen, ob das /v1, Hermes 8642 mithört und wie der Container auf die Adresse des Hosts zugreift.
Offizielle Open-Source-Adresse: https://github.com/NousResearch/hermes-agent; Offizieller Dokumenteneintrag: https://hermes-agent.nousresearch.com/.