解決「This version of Antigravity is no longer supported」：OpenClaw 更新與遷移檢查
WARNING資料查核日期：2026-07-13。 OpenClaw 已將舊
google-antigravity-auth視為移除的 legacy plugin；目前不應再把修改node_modules版本字串當成正式修復。OpenClaw 官方 Google 文件也警告，Gemini CLI OAuth 屬非官方整合，已有帳號受限回報，使用前要自行評估風險。
我在 2026-01-30 遇到的原始錯誤是：
This version of Antigravity is no longer supported.Please update to receive the latest features!當時把 pi-ai 內的 Antigravity user agent 從 1.11.5 改成 1.15.8，確實曾讓請求恢復。但這個方法只是在本機偽裝版本，會被更新覆蓋，也無法處理後來的 provider 移除與帳號風險。現在看到同一段錯誤，應先判斷自己是否還在使用舊 google-antigravity 設定，再走支援中的更新或遷移流程。
先確認是不是舊 Antigravity provider
先記錄版本與模型狀態，不要立刻修改套件檔案：
openclaw --versionopenclaw update statusopenclaw models statusopenclaw plugins list接著檢查設定裡是否還有舊名稱：
rg -n "google-antigravity|google-antigravity-auth" ~/.openclaw若系統沒有 rg，可改用：
grep -RIn "google-antigravity\|google-antigravity-auth" ~/.openclaw只要模型、fallback 或 plugin 設定仍出現 google-antigravity，就不能把問題只當成版本字串過期。OpenClaw 維護者已在官方 repository 的 Issue 回覆中說明，google-antigravity-auth 是有意移除的舊路徑。
目前支援的處理方向
處理順序是「備份、更新、移除舊參照、改用支援中的 provider、驗證」。不要先刪整個 ~/.openclaw，也不要從陌生來源下載舊 plugin。
1. 備份設定與狀態
cp -R ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d-%H%M%S)備份可能含 API Key 或 OAuth 資料，不要上傳到公開 repository。
2. 用官方更新流程升級 OpenClaw
先預覽，再執行更新：
openclaw update --dry-runopenclaw update官方更新指令會依安裝方式處理版本、執行 doctor 並重啟 Gateway。若更新核心成功但 plugin 收斂失敗，官方提供的回復命令是：
openclaw update repair3. 清除舊 provider 的設定參照
先用 openclaw config 或設定介面移除下列項目中的舊值：
agents.defaults.model.primary的google-antigravity/...agents.defaults.model.fallbacks內的google-antigravity/...plugins.entries.google-antigravity-auth- 任何只允許舊 Antigravity 模型的 allowlist 或 alias
不要直接複製本文的欄位路徑去刪資料；先用 openclaw config get agents.defaults.model --json 對照自己的設定，備份後再改。
4. 選擇支援中的模型路徑
若要使用 Google Gemini API，可依官方文件用 API Key onboarding：
openclaw onboard --auth-choice gemini-api-keyopenclaw models list --provider google若你原本只是需要一個可供 OpenClaw 使用的模型，也可以改用其他 provider，例如 OpenCode Go 訂閱與 OpenClaw 設定；模型切換與 allowlist 可參考 OpenClaw 模型設定全解。
OpenClaw 官方仍把 Gemini CLI OAuth 標為非官方整合，並提示帳號限制風險。這和 Google AI Studio API Key 是不同認證路徑；不要因為兩者都能使用 Gemini 就混為同一種授權方式。
如何驗證更新與遷移成功
openclaw --versionopenclaw models statusopenclaw models list --provider googleopenclaw gateway status驗證時確認：
- 設定不再引用
google-antigravity或google-antigravity-auth。 models status顯示新 provider 有可用憑證。- 預設模型使用目前列出的實際 ID。
- Gateway 重啟後可以完成一個最小測試請求。
若更新後 Gateway 無法啟動，先還原備份中的設定檔，再執行 openclaw doctor 與 openclaw update repair。回復目標是讓服務恢復到更新前狀態，不是把已移除的 Antigravity plugin 強行裝回去。
歷史方法：為什麼不再建議硬改版本號
2026-01-30 的環境中，問題來自 @mariozechner/pi-ai 送出的舊 user agent。當時的臨時方法是在 google-gemini-cli.js 中把 1.11.5 改成 1.15.8，然後重啟 Moltbot Gateway。
這段資訊保留作為事故紀錄，但現在有四個明確風險：
- 修改的是
node_modules，更新或重裝後一定會消失。 - 偽裝版本不代表 API、認證與請求格式相容。
1.15.8不是 2026-07-13 的有效性保證。- 舊
google-antigravity-auth已從 OpenClaw 支援路徑移除，修版本字串無法解決這件事。
因此，不要再執行舊文章流傳的 sed 's/1.11.5/1.15.8/' 指令。若你為了事故鑑識需要確認檔案是否被改過，只讀搜尋即可：
find "$(npm root -g)/openclaw" -name "google-gemini-cli.js" -type f -print常見問題
Q: 更新後仍看到同一段 Antigravity 版本錯誤？
A: 先用 rg 或 grep 搜尋 ~/.openclaw，確認 primary、fallback、alias 或 plugin entry 沒有殘留舊 provider。只更新程式但保留舊模型路由，請求仍可能走回已移除的路徑。
Q: 可以從舊版本備份 google-antigravity-auth 再裝回來嗎？
A: 技術上有人在 GitHub Issue 分享過保存舊 plugin 的方法，但 OpenClaw 維護者已把它視為移除的 legacy provider，而且有帳號限制風險。本文不把這條路徑列為支援中的修復。
Q: 改用 Google AI Studio API Key 後，模型名稱要怎麼確認？
A: 完成 openclaw onboard --auth-choice gemini-api-key 後，執行 openclaw models list --provider google。不要從舊文章複製已退役的固定模型 ID。
這個錯誤在 2026 年 1 月曾能靠改版本字串暫時繞過，但現在的正確判斷點已改變：先找出舊 provider，再使用官方更新與受支援的認證路徑完成遷移。
參考資料：
OpenClaw Google (Gemini) provider
回報錯字、失效連結，或告訴我你想看的延伸主題。