版本升級

每個 AI 夥伴的 設定 子分頁最上方有 版本升級 區塊。可以選新版本然後升級。

升級期間 AI 夥伴會離線 5-10 分鐘，前一版會自動保留 5 天，這 5 天內可以一鍵回滾。

---

在哪裡找

OC-1（或 OC-2、HM-3）分頁 → 設定 子分頁 → 最上方 版本升級 區塊

你會看到三個元素：

下方說明文字：「選擇版本後執行升級。升級期間 AI 夥伴會離線約 5-10 分鐘。前一版會自動保留供回滾。」

---

升級前的安全準備

必做：先看更新紀錄，確認沒有 Breaking Changes

升級通常沒問題，但有時新版會改變 API、廢除舊功能。動手前先看：

• OC-1 / OC-2（OpenClaw）→ OpenClaw 更新紀錄
• HM-3（Hermes）→ Hermes-Agent 更新紀錄

找到你要升的目標版本，看「Breaking Changes」段落。

強烈建議：先備份

升級雖然會自動保留前一版（5 天內可一鍵回），但保險起見：

1. 點 立即備份 立即備份對話與設定
2. 如果是大版號跳躍（例如 4.15 → 4.27 跨多版），考慮先 建立主機還原點

---

怎麼升級

第一步：選版本

點版本下拉 → 選你要升的版本。預設會是系統建議的最新穩定版。

第二步：點 執行升級

按下去後，admin-panel 會：

1. 顯示「升級中」進度
2. 該 AI 夥伴立即離線（無法對話、Telegram bot 也會暫停）
3. 後端拉新版 image、停舊容器、起新容器
4. 通常 5-10 分鐘完成

期間 admin-panel 主畫面仍然可瀏覽，但別關掉瀏覽器（雖然關了升級也會繼續，但有畫面才看得到進度）。

第三步：等完成

完成後會看到：

• AI 夥伴狀態回到綠燈
• 設定 → 版本升級 顯示新版本號
• 本機備份版本 區塊出現「還原至本機備份 [舊版本]（剩 5 天）」

第四步：測試

立刻打開 OpenClaw UI（或 Hermes UI），發一句話確認 AI 夥伴正常回應。

---

升級失敗或回應異常 → 5 天內可一鍵回滾

升級後 5 天內，設定 頁會看到「↶ 還原至本機備份 [舊版本]（剩 X 天）」。

詳見 本機備份版本。

---

規則注意

---

三個 AI 夥伴可以分開升級

OC-1 / OC-2（OpenClaw）跟 HM-3（Hermes）是獨立的引擎，版本各自管。

• OC-1 跟 OC-2 用同一個 OpenClaw 版本池（建議一起升比較穩定，但分開也可以）
• HM-3 用獨立的 Hermes 版本池（跟 OC 完全解耦）

升級順序建議：

1. 先 OC-1（管理核心）
2. 等 OC-1 完全啟動且測試正常
3. 再 OC-2
4. 再 HM-3

每次升完間隔至少 30 秒。

---

相關文件

• 立即備份 — 升級前的安全網
• 本機備份版本 — 升級失敗時 5 天內可一鍵回滾
• 建立主機還原點 — 整台主機層級的快照
• OpenClaw 更新紀錄
• Hermes-Agent 更新紀錄