疑難排解

無法登入 Admin Panel

症狀

  • 點擊 Magic Link 後顯示「Unauthorized」或「Token Invalid」
  • 網頁空白或無法載入

診斷步驟

  1. 檢查網址完整性

    ❌ https://xxx-00.realvco.com/?token=abc... （可能被截斷）
✅ https://xxx-00.realvco.com/?token=eyJhbG... （完整的長網址）
    • 確認複製了完整的網址
    • 檢查郵件中是否有「顯示完整網址」的選項

  2. 檢查 Token 是否過期

    • Magic Link 24 小時後過期
    • 如果使用過一次，Token 會立即失效
    • 解決：從郵件重新複製，或聯繫客服重新發送

  3. 清除瀏覽器快取

    • 按 Ctrl+Shift+R (Windows) 或 Cmd+Shift+R (Mac) 強制重新整理
    • 或開啟「無痕模式」測試

  4. 檢查網路連線

    • 確認可以造訪其他網站
    • 嘗試切換網路（例如手機熱點）

AI 夥伴無回應

症狀

  • 發送訊息後 AI 沒有回覆
  • 顯示「正在輸入」但一直沒有結果

診斷步驟

  1. 檢查容器狀態

    • 進入 Admin Panel
    • 查看該 AI 夥伴的狀態是否為「Running」
    • 如果不是，點擊「Start」啟動

  2. 檢查 Gateway 連線

    • 在 Admin Panel 查看 Gateway 狀態
    • 如果顯示「Disconnected」，可能是網路問題
    • 解決：等待自動重連，或重啟容器

  3. 檢查模型配置

    • 確認該容器有正確設定 AI 模型
    • 檢查 API Key 是否有效

  4. 查看日誌

    • 點擊容器的「Logs」按鈕
    • 尋找錯誤訊息（紅色文字）

通訊軟體連接失敗

症狀

  • QR Code 掃描後沒有反應
  • 顯示「配對失敗」或「Token Invalid」

依平台診斷

Telegram

  1. 檢查 Bot Token

    • 確認從 @BotFather 複製了完整的 Token
    • 格式應該是 123456789:ABCdefGHIjklMNOpqrSTUvwxyz

  2. 確認 Bot 沒有被刪除

    • 在 Telegram 搜尋你的 Bot
    • 如果找不到，需要重新建立

  3. 檢查 Webhook

    • 在 Admin Panel 確認 Telegram 設定正確
    • 嘗試重新設定 Webhook

WhatsApp

  1. 使用正確的配對方式

    • WhatsApp Business API 需要特別申請
    • 個人 WhatsApp 無法直接連接

  2. 檢查手機號碼

    • 確認輸入的號碼格式正確（包含國碼）
    • 例如：+886912345678

LINE

  1. 檢查 Channel Secret 和 Token

    • 從 LINE Developers Console 複製
    • 注意區分 Channel Secret（較短）和 Channel Access Token（較長）

  2. 確認 Webhook URL 設定

    • 在 LINE Console 設定正確的 Webhook URL
    • 格式：https://xxx-1.realvco.com/messaging/line/webhook

系統緩慢或卡頓

症狀

  • Admin Panel 載入很慢
  • AI 回覆時間過長（> 30 秒）
  • 容器操作（Start/Stop）反應慢

診斷步驟

  1. 檢查資源使用

    • 查看 Admin Panel System Bar 的資源圖表
    • 關注 CPU、記憶體、磁碟使用率

  2. 資源使用率過高時

    記憶體 > 90%：

    • 重啟容器釋放記憶體
    • 減少同時運行的任務數量

    CPU 持續 100%：

    • 檢查是否有異常程序（可能中挖礦程式）
    • 查看容器日誌找出高 CPU 程序

    磁碟 > 90%：

    • 執行「Docker Prune」清理未使用映像
    • 刪除不必要的檔案

  3. 檢查網路延遲

    • 使用 ping xxx-00.realvco.com 測試連線
    • 如果延遲很高，可能是 CDN 節點問題

容器無法啟動

症狀

  • 點擊「Start」後容器狀態仍是「Stopped」
  • 或一直卡在「Starting」

診斷步驟

  1. 查看日誌

    • 點擊「Logs」查看啟動錯誤
    • 常見錯誤：
      • port already in use → 端口被佔用，重啟整個系統
      • out of memory → 記憶體不足，釋放資源後重試

  2. 檢查磁碟空間

    • 如果磁碟滿了，容器無法寫入資料
    • 執行 Docker Prune 清理空間

  3. 重啟整個系統

    • 在 MAIN Tab 點擊「Reboot Server」
    • 等待 1-2 分鐘後再嘗試

資料遺失或異常

症狀

  • AI 夥伴似乎「忘記」了之前的設定
  • 對話歷史不見了
  • 檔案消失

可能原因與解決

  1. 容器被重建

    • 如果容器被刪除重建，資料會遺失
    • 預防：定期使用 Export Data 備份

  2. 磁碟滿了

    • 系統可能自動清理舊資料
    • 解決：清理磁碟空間，從備份還原

  3. 資料庫損壞

    • 極少數情況下可能發生
    • 解決：從備份還原，或重新設定

無法連接特定網站/API

症狀

  • AI 夥伴說無法造訪某個網站
  • API 呼叫失敗

可能原因

  1. DNS 問題

    • 嘗試在 Host Terminal 執行：nslookup example.com
    • 如果失敗，可能是 DNS 設定問題

  2. 防火牆阻擋

    • 目標網站可能阻擋了 Cloudflare IP
    • 嘗試使用不同的方式連接

  3. SSL 憑證問題

    • 某些舊版程式可能不接受新版 SSL
    • 更新相關套件或程式

聯繫客服前的檢查清單

在尋求協助前，請先確認以下資訊：

  • 具體的錯誤訊息：完整的錯誤文字或截圖
  • 發生時間：什麼時候開始出現問題？
  • 影響範圍：所有服務都壞了，還是只有特定功能？
  • 已嘗試的解決方法：你做過哪些嘗試？
  • 最近的變更：問題出現前，你做過什麼設定變更？

如何收集有用的日誌

  1. 容器日誌：

    # 在 Admin Panel 的 Terminal 中執行
docker logs oc-1 --tail 100

  2. 系統日誌：

    # 查看最近的系統訊息
journalctl -n 100

  3. 網路狀態：

    # 測試連線
ping -c 4 google.com
curl -I https://api.telegram.org

還是無法解決？請帶著以上資訊聯繫客服，我們會盡快協助！