トラブルシューティング
画面に見えている症状から始めます。Android、ネットワーク、Hermes ホストの どこに問題があるかをすばやく切り分けられます。
- 赤い表示または接続なし
- 「No reachable endpoint」
- Chat がストリーミングしない
- Manage または Voice がログインを求める
- セッションが表示されない
- 起動時にアプリがクラッシュする
接続できない
- ホストで
hermes gatewayが動作していることを確認します。 - スマートフォンから
http://<host>:8642/healthを開きます。 API_SERVER_ENABLED=trueとファイアウォール設定を確認します。- スマートフォンで
localhostや127.0.0.1を使用しないでください。これらはスマートフォン自身を示します。
到達可能なエンドポイントがない
保存済みの LAN、Tailscale、公開ルートをすべて確認しましたが、応答がありません。 LAN アドレスは同じ Wi-Fi 内でのみ動作します。Tailscale ではスマートフォンと サーバーの両方が接続済みである必要があります。
Chat がストリーミングしない
- API URL と API キーを確認します。
- エラーが表示された場合は Retry を 1 回タップします。
- Hermes サーバーのログを確認します。
- ローカルモデルは数分かかる場合があります。Android がバックグラウンド接続を切断しても、再接続時に完了済みの応答を取得します。
Manage と Voice
Manage と標準 Voice は API_SERVER_KEY ではなくダッシュボードセッションを 使用します。Manage から一度ログインし、スマートフォンからダッシュボードへ 到達できることを確認してください。
セッションが表示されない
セッション切り替え時にはサーバーへ接続できる必要があります。大きな セッションでは読み込みに時間がかかるため、進行表示を待ってください。
起動時のクラッシュ
Android の 設定 → アプリ → Hermes-Relay → ストレージ でアプリデータを 削除し、API URL とキーを再設定します。
Relay の問題には、読み取り専用診断の hermes relay doctor を使用できます。