預裝 API 額度與 OpenRouter 設定

結帳第 2 步會問你要不要加購「預裝 API 額度」（$0 / $5 / $10）。這篇講清楚這東西是幹嘛的、為什麼這樣設計、怎麼用它把你的主機真正設定起來。

---

為什麼要設計這東西

如果你自己從零裝 OpenClaw 或 Hermes，第一個關卡會是這樣：

1. 你要先到 OpenAI / Anthropic / Google 各家註冊帳號、申請 API key、加值
2. 改 OpenClaw 或 Hermes 的設定檔，把 key 餵進去
3. AI 才能開始跟你對話
4. 然後再去設定 Telegram / WhatsApp / LINE 等通訊平台
5. 整個前置過程「AI 啞巴」幫不上你忙

realvco 的安排不一樣：

1. 結帳時可選 $0 / $5 / $10 預裝額度
2. 主機建好的當下，AI 已經有一筆額度可用
3. 你登入 admin panel，AI 就在那等你對話
4. 你跟 Rose 說「幫我裝 OpenAI API key 給你自己用」 → AI 全程協助你註冊、申請、改設定
5. 等正式 key 接好之後，AI 就用你自己的 key 跑、預裝額度的階段性任務也差不多了

這個設計的目標：把「裝機階段 AI 啞巴」這個痛點解掉。

---

三選一決策表

---

你買了什麼

選 $5 / $10 後，結帳完成的當下 realvco 會幫你做這些事：

1. 跟 OpenRouter 開一把子金鑰（你的專屬）
2. 設定額度上限 = 你買的金額
3. 設定 90 天有效期
4. 寫進你的客戶資料
5. 主機建立時自動注入到 3 個 AI 容器（oc-1 Rose / hm-2 Ada / hm-3 Vi 共用同一把 key）
6. Rose（OpenClaw）預設配 4 款模型，可以馬上開始對話

完整預設模型清單 + 怎麼用快速別名（gm / ds / hk / gf）切換，見 預設模型清單。

Ada / Vi（Hermes-Agent）拿到同一把 key 但沒預設模型清單 — 第一次用 Ada / Vi 時要在 admin-panel 的 設定 子分頁挑模型，詳見 從網頁終端機進 Vi 的 TUI。

---

推薦使用流程（$5 / $10 的客戶）

預裝額度的正確用法是「讓 AI 幫你接力裝完正式設定」：

步驟 1：登入後直接跟 Rose 講話

主機建好登入 admin panel，Rose 已經能對話。第一句話可以是：

「Rose，幫我設定一把你自己的正式 OpenAI API key — 我會跟著你做」

Rose 會引導你註冊帳號、申請 key、把 key 寫進她自己的設定檔。

步驟 2：用已經接好正式 key 的 Rose 接力

Rose 接好正式 key 之後，這時候 Rose 跑的是你自己的 key、不再消耗預裝額度。你可以繼續用 Rose 幫忙裝 Ada 跟 Vi：

「Rose，請你幫我把 Ada 也接上正式 API key」
「Rose，順便幫我把 Vi 也設定好」

步驟 3：接通訊平台

3 個 AI 夥伴都接好正式 key 之後，再讓 AI 幫你接 Telegram / WhatsApp / LINE / Microsoft Teams 等：

「Ada，幫我把你接上 Telegram，我等下要在手機上跟你對話」

步驟 4：預裝額度功成身退

到這個階段，3 個夥伴都跑你自己的正式 key，預裝額度可能還剩一點當備援，也可能差不多花完了——都沒關係，因為你已經自立了。

---

用完了怎麼辦

預裝額度用完，3 個夥伴會「跑著但不回應」。但這不一定是壞事——通常你已經接好至少一個夥伴的正式 key 了：

90 天到期也是同樣邏輯：金鑰失效，但跑你自己 key 的夥伴完全不受影響。

---

自己重新申請 OpenRouter key 接續用（如果你想繼續走 OpenRouter）

預裝額度過期、不想換到 OpenAI / Anthropic 直連、想繼續用 OpenRouter？路徑很簡單：

1. 自己到 openrouter.ai 開帳號
2. 在 openrouter.ai/keys 新建一把 key
3. 加值（Pre-paid 模式，最低 $10）
4. SSH 進主機，編輯 /opt/openclaw/.tokens 改 OPENROUTER_API_KEY
5. 重啟 3 個容器

Rose 的預設模型 alias 全部沿用 — 你自己的新 key 同樣可以打這些 alias，不用重設。完整 alias 表見 預設模型清單。

完整 OpenRouter 帳號 / 計費 / 安全設定教學請看 OpenRouter 官方文件。

---

自備其他 provider key（OpenAI / Anthropic 直接接）

也可以不走 OpenRouter，直接接 OpenAI 或 Anthropic 自己的 API。這通常是大量正式運營的客戶會做的選擇：

---

常見問題

Q: 預裝額度過期後我的對話歷史會不會消失？

不會。對話、人格設定、自動備份全部保留。只有「跑預裝 key 的那部分對話」會停 — 跑你自己正式 key 的對話完全不受影響。

Q: $5 真的夠嗎？

夠不夠主要看你裝機過程有多依賴 AI 來對話協助。一般客戶 $5 可以裝完 Rose / Ada / Vi 三家正式 LLM API + 主要通訊平台。如果你想 AI 多解釋幾次、跑比較複雜的推理（用 Haiku 4.5 而不是 GPT-5.4 Mini），可能要 $10。

裝機完成之後就轉到你自己的正式 key 了，預裝額度本來就不是要長期用的。

Q: 為什麼設計成 90 天到期、只能在訂閱新主機時購買一次？

這個機制不是 LLM 訂閱方案，是「裝機助手」。如果允許持續加購，客戶可能誤把它當主用 LLM 跑業務 — 但 OpenRouter 抽手續費、無法享受各家直連的企業優惠，長期不划算。設計成有時限、訂閱新主機時一次性加購，是讓客戶自然轉到正式架構。

Q: 我能用預裝 key 直接跑客服機器人嗎？

技術上可以，實務上不建議：

1. 90 天會到期，到期那天你的客服會突然斷線
2. $5 / $10 額度撐不起商業量
3. 系統設計初衷不是商業用途、後續沒延長路徑

建議裝機階段過了就把 3 個夥伴接上你自己的正式 key（OpenAI / Anthropic / 自己的 OpenRouter 帳號）跑。

Q: 三個 AI 夥伴是不是各自有獨立金鑰？

不是。3 個容器（Rose / Ada / Vi）共用同一把預裝金鑰，所以額度是合計的。不過接好正式 key 之後，每個夥伴可以各自設定不同 provider（例如 Rose 接 OpenAI、Ada 接 Anthropic、Vi 接 Google），完全獨立計費。

Q: 升級 / 降級主機方案後預裝額度會不會被砍？

不會。預裝額度是獨立加購、獨立計算的，跟主機方案不綁定。

Q: 我有自己的 OpenAI API key（或 ChatGPT 訂閱），能用嗎？

自己的 OpenAI API key：能用。要 SSH 進主機改 OpenClaw 的 openclaw.json，把 model URL 從 openrouter/openai/gpt-... 改成直接打 OpenAI API。詳見 OpenAI 官方文件 與 docs.openclaw.ai。

如果你選 $0 + 自備 OpenAI API key，等於完全不走 OpenRouter，這是合理的進階路徑。

⚠️ OpenAI 訂閱 ≠ OpenAI API key

很多人會混淆這兩個：

• ChatGPT Plus / Pro / Team / Enterprise 訂閱：給你在 chatgpt.com 網頁/手機 App 用 ChatGPT 對話的服務
• OpenAI API key：給程式（例如你的 AI agent）呼叫 GPT 模型用的憑證

這兩個是不同產品、各自計費。你訂閱的 ChatGPT Plus 額度不能拿來餵 AI agent。要讓 AI agent 跑 OpenAI 模型，得另外去 platform.openai.com 開 API key 加值，跟你的 ChatGPT 訂閱無關。

---

相關文件

• 訂閱管理 — 整體結帳流程說明
• OpenClaw 概況（Rose 預裝）+ 預設模型別名
• 預設模型清單（價格 + alias）
• 從網頁終端機進 Vi 的 TUI
• Token 計價原理
• OpenRouter 官方文件