【Debug 筆記】OpenClaw (Clawdbot, Moltbot) 報錯 "Antigravity version not supported"？五分鐘快速自救法

English Title

OpenClaw (Clawdbot, Moltbot) Agent Down? How to Resolve the Google Antigravity API Version Issue

简体标题

【Debug笔记】OpenClaw (Clawdbot, Moltbot) 报错 "Antigravity version not supported"？五分钟快速自救法

type

Post

status

Published

date

Jan 30, 2026

slug

fix-clawdbot-openclaw-moltbot-antigravity-version-not-supported

summary

遇到 OpenClaw (原 Moltbot / Clawdbot) 突然報錯「This version of Antigravity is no longer supported」導致 Agent 罷工嗎？別驚慌，這不是你的設定壞了，而是 Google API 淘汰了舊版 User Agent。本文提供一個免等待官方更新的 5 分鐘手動修復方案 (Hotfix)，教你如何定位並修改 google-gemini-cli.js，讓開發環境立即復活。

發生什麼事？

今天早上準備讓 Agent 繼續跑專案時，OpenClaw 突然罷工，完全不回傳內容，只吐出一行冷冰冰的錯誤：

This version of Antigravity is no longer supported.
Please update to receive the latest features!

不管重啟 Gateway、換模型、或是重登 Google 帳號都沒用。爬了一圈 GitHub Issues 才知道，這不是 OpenClaw 壞了，而是 Google Antigravity 的 API 版本策略 擋下了連線。

為什麼會這樣？（Root Cause）

簡單來說，這是典型的「依賴套件版本過舊」問題。

OpenClaw 底層是透過一個叫做 @mariozechner/pi-ai 的套件來跟 Google Antigravity 溝通。這個套件在發送 HTTP 請求時，會像瀏覽器一樣帶上一張「身分證」（User Agent），告訴 Google 它是哪個版本的客戶端。

目前的狀況是：

套件內寫死的版本號是 1.11.5。

Google 伺服器端已經停用了這個舊版本，要求更新的版本號。

雖然 Google 更新了，但 OpenClaw 的 npm 依賴還沒跟上。

所以，我們的 Agent 就像拿著過期的通行證想闖關，當然被 Google 擋在門外。

解決方案：手動修改版本號 (Hotfix)

雖然官方還沒釋出修復版（預計要等 PR 合併），但我們可以透過手動修改本地檔案來「欺騙」Google 我們是最新的版本。

步驟 1：找出關鍵檔案 `google-gemini-cli.js`

這個檔案藏在 node_modules 深處。路徑取決於你是怎麼安裝的（npm global, Volta, 或直接 clone）。

最快的方法是直接用 Terminal 搜尋（Mac/Linux）：

find ~ -name "google-gemini-cli.js" -type f 2>/dev/null

如果你跟我一樣是用 Volta 管理環境，路徑通常長得像這樣：

~/.volta/tools/image/packages/clawdbot/lib/node_modules/.../@mariozechner/pi-ai/dist/providers/google-gemini-cli.js

步驟 2：手術修改

找到檔案後，用 VS Code 或任何編輯器打開。

目標：搜尋字串 1.11.5

動作：將其替換為目前可用的版本 1.15.8

如果你想直接用 Command Line 解決（帥氣一點），可以直接跑這行 sed 指令（請將 <你的檔案路徑> 換成步驟 1 找到的路徑）：

sed -i '' 's/1\.11\.5/1.15.8/g' <你的檔案路徑>

Note: 1.15.8 是撰文當下 (2026/01) Google 接受的有效版本。如果過陣子又壞了，可能要查一下 Antigravity 最新的版號再改一次。

步驟 3：重啟並驗證

修改完存檔後，記得重啟 OpenClaw 的 Gateway 讓更動生效：

# 視你的安裝名稱而定
moltbot gateway restart
# 或
clawdbot gateway restart

接著隨便丟個 "Hello" 給它，如果 Agent 恢復正常幹話（或是正常工作），恭喜你，復活了！

常見 QA

Q: 為什麼不直接升級 pi-ai 套件就好？ A: 千萬別衝動。 pi-ai 的新版本（v0.50.3+）改動了核心 API 架構（Breaking Changes），如果你強行單獨升級這個依賴，OpenClaw 會直接崩潰跑不動。目前的最佳解是等待 OpenClaw 官方適配，或是用上面的方法暫時頂著。

Q: 這招能撐多久？ A: 直到 Google 決定停用 1.15.8 版本，或者直到你更新了 OpenClaw（因為更新會重裝 node_modules，覆蓋掉你的修改）。建議關注 GitHub 上的 Issue #4165 追蹤官方進度。

希望這篇筆記能幫大家省下半小時的 Debug 時間，趕快回去寫 Code 吧！

🔗 參考資料 (Credit)

本文的解決方案整理自 GitHub 社群大神的討論，想追蹤官方修復進度或查看原始討論串的朋友可以看這裡：

災情回報串：[GitHub Issue #4111 - Antigravity version no longer supported]

技術細節分析：[GitHub Issue #4165 - google-antigravity model fails due to outdated pi-agent-core]

原始解法來源：[Issue #4111 Comment]

官方文件：Moltbot Model Providers Documentation / Google Antigravity