用户：配置完了，但是
助手：別急，這個錯誤**不代表配置錯**，是 gateway 在重啟時跟 backend 通訊超時。常見原因 3 種，**按順序排查**：

---

## 🩺 第一步：看日誌（最重要）

```powershell
# 找出錯誤根因
Get-Content ~/.hermes/logs/gateway.log -Tail 50
```

> 95% 報這個錯的根因都在這幾行 — DNS、超時、SSL 證書、key 無效。看具體的 `Traceback`。

---

## 🔍 第二步：直接驗 LLM API 通不通

在**配置裡那台機器**（`10.182.47.161`）跑：

```powershell
# 1. DNS 解析測試
Resolve-DnsName llm-api-ai.eavarytech.com

# 2. 直接 curl API（繞過 Hermes）
curl -X POST https://llm-api-ai.eavarytech.com/v1/chat/completions `
  -H "Authorization: Bearer ***-SFtjcoodDVe88dUoxziUfg" `
  -H "Content-Type: application/json" `
  -d '{"model":"Chat","messages":[{"role":"user","content":"hi"}]}'
```

**如果 curl 也超時/失敗**：
- ❌ 公司內網防火牆擋 HTTPS 出網
- ❌ DNS 解析不到 `llm-api-ai.eavarytech.com`
- ❌ SSL 證書問題

→ 跟 IT/網管確認。

---

## 🔧 第三步：強制重啟 gateway

```powershell
# 完全 stop 再 start
hermes gateway stop
Get-Process | Where-Object {$_.ProcessName -like "*hermes*"} | Stop-Process -Force
hermes gateway start

# 或前台跑看即時輸出
hermes gateway run
```

> `gateway run` 直接前台會打 print 出確切錯誤，比從 Web UI 重啟有信息量。

---

## 🎯 最常見的原因（按概率排）

| 原因 | 徵兆 | 解決 |
|------|------|------|
| **DNS 解析慢/失敗** | curl 也卡 | IT 加 `llm-api-ai.eavarytech.com` 到內網 DNS |
| **HTTPS 出網被擋** | curl `Connection timed out` | IT 開白名單 |
| **SSL 證書不被信任** | curl `unable to verify` | `pip install --upgrade certifi` 或關閉 SSL verify（debug only） |
| **provider.openai 配置被新 Hermes 忽略** | doctor 說 ok 但跑不動 | 把 `providers.openai` 去掉，**只用 `model:` 段** |
| **gateway 在等 webhook 健康檢查** | log 顯示 `polling loop` | 15s 超時正常，**重點看 log** |

---

## 🚨 如果是新版 Hermes 對 `providers:` 段的解析問題

新版本 Hermes 對 `providers: openai:` 段的處理可能不一致 — 有些版本**只讀 `model:`**，忽略 `providers:`。

**最穩寫法（只填 `model:`，刪 `providers.openai`）**：

```yaml
model:
  default: Chat
  provider: openai
  base_url: https://llm-api-ai.eavarytech.com/v1
  api_key: "***-SFtjcoodDVe88dUoxziUfg"
  context_length: 32768

providers: {}    # ← 留空
```

把 `providers:` 整段從 `openai: {...}` 改回 `providers: {}`，先試這個版本。

---

把 `gateway.log -Tail 50` 的輸出貼給我，我直接看出根因。

**最壞情況**：用 `git checkout HEAD -- config.yaml` 退回上次能用的版本（如果你有備份或 git init 的話）。