為什麼會發生？#

Moltbot 透過 @mariozechner/pi-ai 這個套件來實作 Google Antigravity 的 API 連線。這個套件在發送請求時，會在 HTTP header 中附帶一個 userAgent 版本字串，告訴 Google 伺服器「我是哪個版本的 Antigravity 用戶端」。

問題的關鍵在於：

1. Google 會定期停用舊版 API——當 Antigravity 推出新版本後，舊版的 userAgent 會被伺服器拒絕
2. pi-ai 套件內嵌了固定的版本字串（例如 1.11.5），而 Google 已經停用了這個版本
3. Moltbot 的 npm 依賴尚未更新 pi-ai 到最新版，所以即使你更新 Moltbot 本體也沒用

1
請求流程：
2

3
  Moltbot
4
    ↓
5
  pi-ai 套件
6
    ↓
7
  HTTP 請求（userAgent: antigravity/1.11.5）
8
    ↓
9
  Google API
10
    ↓
11
  ❌ 「This version is no longer supported」

這不是個案#

同一時間，GitHub 上多個專案都回報了相同問題：

• moltbot/moltbot#4111 — Moltbot 主倉庫
• moltbot/moltbot#4165 — pi-agent-core 版本過舊
• lbjlaq/Antigravity-Manager#1314 — Antigravity Manager
• anomalyco/opencode#11182 — OpenCode

這波影響範圍不小，所有依賴舊版 pi-ai / pi-agent-core 套件的工具都中招了。

步驟 1：找到目標檔案#

需要修改的檔案是 google-gemini-cli.js，位於 @mariozechner/pi-ai 套件內。

路徑因安裝方式而異：

找不到？ 用 find 指令搜尋（可能需要 5～30 秒）：

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

以我的環境為例（Volta 安裝），實際路徑是：

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

注意：如果你是在改名前安裝的，路徑中可能還是 clawdbot 而非 moltbot。

步驟 2：修改版本號#

用任何文字編輯器打開檔案，搜尋舊版本號並替換：

1
# 方法一：用 sed 直接替換
2
sed -i '' 's/1\.11\.5/1.15.8/g' <你的檔案路徑>
3

4
# 方法二：用編輯器手動修改
5
code <你的檔案路徑>
6
# 搜尋 1.11.5 → 替換為 1.15.8

修改前（版本號 1.11.5）：

修改後（版本號 1.15.8）：

版本號說明：1.15.8 是目前有效的 Antigravity 版本號。如果未來 Google 再次停用此版本，你可能需要查看 Antigravity Changelog 取得最新版本號。

步驟 3：重啟 gateway#

1
# 新版指令
2
moltbot gateway restart
3

4
# 舊版（尚未改名的安裝）
5
clawdbot gateway restart

步驟 4：驗證修復#

1
# 測試 bot 是否正常回應
2
moltbot chat "Hello, are you working?"
3

4
# 或在互動模式中測試
5
moltbot
6
> /models
7
> /model google-antigravity/gemini-3-flash

如果 bot 正常回應內容，就代表修復成功了。

Q: 我用的是 google-gemini-cli provider，也會受影響嗎？#

A: 這兩個 provider 使用不同的認證路徑，但底層都透過 pi-ai 套件。如果你的 google-gemini-cli provider 也出現類似錯誤，同樣的修復方式應該適用。

Q: 修改後過了幾天又壞了？#

A: 可能是 Google 再次更新了版本限制。查看最新的 Antigravity Changelog 取得當前版本號，重複步驟 2 即可。

Q: 為什麼 Google 要做版本限制？#

A: 這是常見的 API 版本管理策略。Google 透過檢查用戶端版本來確保安全性和功能相容性，同時也可能用於推動使用者更新到最新版本。

Q: 等官方修復大概要多久？#

A: Issue #4165 已經有開發者提交了詳細的修改方案，但具體合併時間取決於 Moltbot 維護團隊。建議 watch 該 Issue 以獲得第一手通知。