Openclaw 使用 Google Vertex AI 及申辦紀錄

766 字

4 分鐘

Openclaw 使用 Google Vertex AI 及申辦紀錄

2026-03-12

技術筆記

openclaw

/

gcp

/

vertexai

WARNING
2026.3.13 更新版本可能會有問題，需再測試。

最近養蝦蔚為風潮，連新聞上都會聽看到其蹤跡，我也 deploy 到虛擬機玩了一下。

Openclaw 是一套讓你在本機或伺服器上以統一介面管理與切換多種 LLM 供應商的工具。能讓使用者透過統一的介面調度各種 AI 模型。

在執行 openclaw configure 時，我們會發現系統要求填入 API Key 或透過 gemini-cli (OAuth) 登入。然而，前陣子 Google 針對使用 Antigravity 接入 Openclaw 的帳號進行了一波封禁，為了保險起見，後者（OAuth）目前建議先觀望。

至於 API Key，研究後會發現它預設走的是 Google AI Studio 的路徑，而非 Vertex AI。這兩者雖然都是 Google 的服務，但 Google AI Studio 是給開發者快速測試用的獨立平台，而 Vertex AI 則是掛在 Google Cloud Platform (GCP) 旗下的企業級服務。

最關鍵的一點：GCP 新用戶贈送的 $300 抵用金，只能抵扣 Vertex AI 的帳單，使用 Google AI Studio 還是會被扣錢的。

Openclaw 對於 Vertex AI (google-vertex) 的支援是利用 ADC (Application Default Credentials) 機制。關於 ADC 這邊不多贅述，簡單來說它就是一套 Google 官方的憑證尋找標準，程式會自動去環境變數或特定路徑找金鑰，安全性與規範都比 hardcode 一個 API Key 字串來得好些。

開通 Vertex AI 服務帳戶與權限#

進入正題，首先登入 GCP 控制台，搜尋並進入 Vertex AI 頁面。

這裡的核心任務是建立一個 Service Account (服務帳戶) 並下載其 JSON 金鑰。

但如果在過程中發現無法建立金鑰，通常是因為組織策略（Organization Policy）預設禁用了 Service Account 的金鑰建立功能。

[API key permission issue page]

前往 Organization Policies 頁面，搜尋策略名稱 iam.managed.disableServiceAccountApiKeyCreation。將其改為 overwrite，並暫時關閉此限制（建立完金鑰後可以再調回來）。

[force enable policy 095751]

回到 Vertex AI 頁面後，建立 Service Account 並賦予它 Vertex AI User 的角色權限。

[create service account 103304]

接著在該 Service Account 的「金鑰 (Keys)」分頁中，選擇「新增金鑰」>「建立新金鑰」，格式選擇 JSON 並下載存檔。

[103617]

雖然這是在 GCP 內部運行，但還是建議對 Service Account 做好最小權限控管，避免金鑰外洩造成額外費用。

[101928]

Openclaw 環境設定#

將下載好的 .json 金鑰檔案放到 Openclaw 資料夾中。我自己習慣放在 .openclaw/credentials/ 下。

接著，在 .openclaw 目錄下新增或修改 .env 檔案，填入以下資訊（前三項請依實際情況填寫）：

1
GOOGLE_CLOUD_PROJECT=你的專案名稱
2
GOOGLE_CLOUD_PROJECT_ID=你的專案ID
3
GOOGLE_APPLICATION_CREDENTIALS=/絕對路徑/to/your/vertexai-service-account.json
4
GOOGLE_CLOUD_LOCATION=global