最も一般的なのは、サービスが完全にフリーズしているのに URLが/v1に欠けている、Hermesの8642が稼働していない、または ホストがDockerでlocalhostとして書かれている場合です。 公式のOpen WebUIドキュメントにはこれら3点が直接トラブルシューティングエリアに記載されているので、ここから最速で確認しましょう。
最小限のトラブルシューティングシーケンス
- Open WebUIの接続アドレスが
http://host.docker.internal:8642/v1か、単なる:8642ではないか確認してください。 curl http://localhost:8642/healthをネイティブで実行して、Hermes API Serverが稼働しているか確認してください。curl http://localhost:8642/v1/modelsした後は、hermes-agentやプロフィール名が普通に見えるはずです。- Open WebUIがDocker上で動作する場合は、Hermesアドレスをコンテナ内の
localhostとして書かず、host.docker.internal、--network=host、またはブリッジIPを使いましょう。
ここで簡単に詰まってしまいます
Open WebUIの接続テストは合格できるからといって、モデルリストが引き出されるわけではありません。 接続テストは「このアドレスがAPIに見えるか」という感じで、モデルのドロップダウンも正しい内容を返すために/v1/modelsに依存しています。
一言で言えば、モデルのドロップダウンボックスが空いているので、Open WebUIを再インストールしないでください。 /v1、Hermes 8642が聞いているかどうか、そしてコンテナがホストのアドレスにどのようにアクセスしているかを優先的に確認してください。
公式オープンソースアドレス:https://github.com/NousResearch/hermes-agent; 公式文書の記録:https://hermes-agent.nousresearch.com/。
