主機急救手冊

主機出狀況時你最不想做的事是「翻一堆文件」。這篇按症狀列救援步驟，最快 30 秒就能找到對的處置。

---

症狀 1：admin-panel 完全打不開

你看到什麼

• 瀏覽器顯示「無法連線」「連線逾時」「DNS 找不到」
• 開了好幾分鐘還在轉圈
• 用過 Magic Link 連結也沒用

1 分鐘排查

處置

• 2 跟 3 都 OK 但還是打不開 → 主機本身可能掛了。提交 緊急工單，標題加「主機完全沒回應」，realvco 客服會看主機健康狀態
• 2 連不上但 google 可以 → realvco 服務全站異常，等待修復或看 realvco 公告
• 網路完全壞 → 修你自己的網路

---

症狀 2：admin-panel 載入後 AI 夥伴顯示紅燈

你看到什麼

• admin-panel 主機分頁打開了
• 但 AI Agent 清單三個夥伴都是紅燈 / 灰燈
• 點進 OC-1 / OC-2 / HM-3 顯示「容器未啟動」

1 分鐘排查

到 主機操作 看：

• 連續運作時間是不是很短（< 5 分鐘）？→ 主機剛重啟，等容器自動拉起（5-10 分鐘）
• 是不是很久（> 30 天）？→ 可能是漸進性異常

處置

⚠️ 不要重啟到第三次 — 三次以上都失敗就是真的有問題，提交工單比較快。

---

症狀 3：某一個 AI 夥伴單獨無回應（其他兩個正常）

你看到什麼

• OC-1 (Rose) 打 Telegram 有回 ✅
• OC-2 (Ada) 打 Telegram 沒回 ❌
• HM-3 (Vi) 也正常

只有 1 個夥伴壞 — 不必動主機，重啟單一 AI 就好。

處置

1. 進 admin-panel → 該 AI 夥伴分頁（例 OC-2）→ 主頁
2. 點 暫停 按鈕 → 等 5 秒
3. 點 繼續 按鈕
4. 等 30 秒讓容器啟動
5. 在 Telegram 重新發訊息測試

90% 單一 AI 卡住用「暫停 → 繼續」就解了。

如果「暫停 → 繼續」還壞：

• 看 活動子分頁 找錯誤 log
• 看 用量子分頁 確認沒有突然爆量（可能 token 用完）

---

症狀 4：升級後 AI 行為異常 / 失憶

你看到什麼

• 剛升級 OC-1 版本
• AI 不認得自己（人格設定好像跑掉）
• 或 AI 記憶斷裂（不記得之前的對話）

處置 — 5 天內可一鍵回滾

1. 進該 AI 夥伴 → 設定 → 本機備份版本
2. 點「↶ 還原至本機備份 [舊版本]（剩 X 天）」
3. 等 5-10 分鐘，AI 回到舊版

詳見 本機備份版本。

⚠️ 超過 5 天本機備份會自動清除，升級失敗別拖。

---

症狀 5：儲存空間爆滿（CPU / RAM / 磁碟 100%）

你看到什麼

• admin-panel 載入很慢
• AI 回應很慢
• 主機資訊區塊顯示磁碟 > 95%

處置

優先順序由低風險到高風險：

90% 的「磁碟爆滿」用 釋放空間 就解了 — Docker 累積的舊映像檔最佔空間。

---

症狀 6：所有正常但 token 突然爆量

你看到什麼

• 平常一天 X token，今天用了 5X
• 但你沒做特別的事
• AI 看起來還在正常回應

1 分鐘排查

到該 AI 夥伴 → 活動子分頁 過濾「執行中」「失敗」：

• 有沒有重複很多次的相同任務？→ 可能 cron 排程在 retry loop
• 有沒有很長的對話？→ 可能某個客戶在跟 AI 拗、消耗 context
• 有沒有陌生的對話來源？→ 可能 token 外洩，有人盜用 AI

處置

---

症狀 7：完全不知道該幹嘛

---

預防勝於救援

---

還沒救活？

最後手段：提交工單。

工單請附：

• ☐ 主機名稱（例 cattle42）
• ☐ 症狀（盡量具體：「OC-1 點 OpenClaw UI 出 404」勝過「Rose 壞了」）
• ☐ 何時開始
• ☐ 你已試過什麼（用本頁編號回報，例如「症狀 2 + 已試過暫停繼續 3 次」）
• ☐ 急迫程度（生意正在等 / 可以等明天）

realvco 客服通常 1-2 小時內回應。

---

相關文件

• 主機操作（建立還原點 / 重啟）
• 本機備份版本（升級回滾）
• 活動子分頁（debug log）
• 提交工單