realvco Docs

URL 與 Token 地圖

這份文件是給客服 / 工程師除錯時用的參考資料。 一般客戶日常操作只需要看 開箱指南：信 → 帳戶頁 → 主機儀表板按鈕，系統自動處理 URL + Token，你不需要記任何網址結構。

主機背後實際的 URL 結構是這樣：你的主機有 4 組網址 + 對應的容器 Token，以下是除錯時可能要查的對照表。

你會收到的 4 組 URL

所有網址都是 https://{你的前綴}-XX.realvco.com/ 這個模式，差別在 -XX：

前綴尾用途對應容器對應預裝軟體
-00管理儀表板（Admin Panel）主機本身N/A
-1Rose 的 OpenClaw UI（對話）oc-1OpenClaw
-2Ada 的 Hermes UI（對話）hm-2Hermes-Agent
-3Vi 的 Hermes UI（對話）hm-3Hermes-Agent

舉例： 如果你的前綴是 26kkrvv，你的 4 組網址是：

  • https://26kkrvv-00.realvco.com/ — 管理儀表板
  • https://26kkrvv-1.realvco.com/ — Rose
  • https://26kkrvv-2.realvco.com/ — Ada
  • https://26kkrvv-3.realvco.com/ — Vi

Magic Token 規則

每組 URL 都搭配一組專屬 Magic Token（64 字元隨機字串）。

完整格式

https://26kkrvv-00.realvco.com/#token=a1b2c3d4e5f6...
                                 ^^^^^^^^^^^^^^^^^^^^^
                                 首次使用時的 Magic Token

Token 生命週期

① 安裝完成信收到原始 Token
         ↓
② 你點連結，瀏覽器讀取 Token
         ↓
③ 主機驗證 Token → 發 Cookie（30 天有效）
         ↓
④ URL 裡的 Token 被清掉，Cookie 成為後續驗證依據
         ↓
⑤ 30 天內持續登入 → Cookie 自動續期
         ↓
⑥ 超過 30 天未登入 → Cookie 過期 → 需要重新用原始連結登入

重點規則

  • 1 組 URL = 1 組 Token：管理儀表板 的 Token 只能開 管理儀表板，不能開 Rose 的 OpenClaw UI
  • 跨裝置共用：同一台裝置的不同瀏覽器各自驗證；不同裝置要各自用原始 Token 登入一次
  • Token 不會過期：原始 Token 永久有效（除非你手動重置）。過期的只是 Cookie
  • 重置方式：在 管理儀表板 → MAIN 分頁 → Security → Regenerate Token
管理儀表板 MAIN 分頁，含 Regenerate Token 入口 管理儀表板 MAIN 分頁，含 Regenerate Token 入口
MAIN 分頁顯示主機資訊、AI Agent 列表、操作按鈕；右下方 Security 區可重置 Token

我該記哪個 URL？

實用建議：

  1. 管理儀表板 URL（-00）— 加書籤，日常都從這裡進
  2. Rose / Ada / Vi 的 URL（-1 / -2 / -3）— 不用記，從 管理儀表板 裡面點按鈕就會開：Rose 點「OpenClaw UI」、Ada / Vi 點「Hermes UI」

管理儀表板 左上切換 Rose/Ada/Vi Dashboard → 點右上 OpenClaw UI（Rose）/ Hermes UI（Ada / Vi） → 自動帶著登入狀態開對話視窗。不需要手動複製各個 Token。

常見問題

Q: 我的 Rose 和 Ada 為什麼是 -1 和 -2，但 Vi 是 -3，不是 hm-3？

URL 的編號和容器代號是兩個不同系統：

  • URL 編號：-1 / -2 / -3 — 給人記的順序編號
  • 容器代號：oc-1 / hm-2 / hm-3 — 給系統用的技術名稱

URL 不含預裝軟體前綴是故意的，方便你記。

Q: 我想把 Rose 接到自訂網域可以嗎？

目前不支援。所有 URL 都固定在 {前綴}-XX.realvco.com 底下。這是為了讓 Cloudflare Tunnel 自動運作。

Q: Token 被別人看到怎麼辦？

立刻重置：

  1. 管理儀表板 → MAIN 分頁 → Security → Regenerate Token
  2. 舊 Token 和舊 Cookie 會立刻失效
  3. 你會拿到新 Token，要用新連結重新登入
  4. 會收到一封 Email 告知新的 4 組連結

📷 截圖待補（Regenerate Token 確認視窗目前未拍攝，操作流程已在文字描述中）

Q: 換了手機怎麼繼續用？

新手機第一次開 管理儀表板 時，要再用一次原始 Magic Token 連結登入。回 Email 找原本的連結即可。

會存，但無痕結束時 Cookie 會被清除。下次開還要再用原始 Token 登入。

相關文件