OpenCode Go 費用與訂閱：$10 方案、模型與 OpenClaw 設定

OpenCode Go 費用與訂閱方式#

OpenCode Go 官方文件目前列出每月 10 美元的訂閱費。這筆月費與模型各自的美元用量上限是不同數字；每個模型的 5 小時上限是其月上限的 20%，每週上限是 50%，每月上限則是 100%。

這些限制依模型 token 價格換算成美元用量上限，不是另外入帳的現金或一個可任意共用的點數池。使用低成本模型，同一個時段能完成的請求通常較多；使用較高成本模型，能完成的請求就較少。OpenCode 文件提供的 requests 只是典型 prompt 與 token 模式下的估算，不能當成每個人的保證額度。付款前應重新查看 OpenCode Go 官方文件 中的模型與用量表。

舊文章或社群貼文若仍寫「首月 5 美元、之後 10 美元」，不要直接拿來當目前價格。付款前請重新查看 OpenCode Go 官方文件 的方案與限制；促銷若存在，也應以結帳頁實際顯示為準。

Go 與 Zen 怎麼選#

兩者都在 OpenCode 的 provider 生態裡，但適合的預算與路由不同：

共用同一套 API Key 機制，不代表兩個產品共用訂閱資格。若 workspace 的另一位成員已經訂閱 Go，你可能無法再用同一個 workspace 建立第二個 Go 訂閱；應先和 workspace 管理者確認誰負責付款與使用。

訂閱後取得 API Key#

1. 開啟 OpenCode 帳號頁 並登入。
2. 在 OpenCode 後台訂閱 OpenCode Go。
3. 複製 API Key，並只放進密碼管理工具或環境變數。

不要把 Key 寫進公開 repository、Issue 或終端機截圖。若 Key 曾經外洩，先在 OpenCode 後台撤銷並重新建立，再繼續排錯；不要只在本機換一個環境變數名稱。

1
export OPENCODE_API_KEY='你的 API Key'

OpenClaw 的原生 onboarding 流程#

OpenClaw 目前把兩個目錄分成不同 runtime provider：

• opencode/...：Zen 模型
• opencode-go/...：Go 訂閱模型

建議先用互動式 onboarding：

1
openclaw onboard --auth-choice opencode-go

若環境已安全設定 OPENCODE_API_KEY，也可以直接傳入：

1
openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"

OpenClaw 官方文件目前說明 Go provider 已包含在支援版本中，不需要再用舊文章的手動 provider JSON 補一個 baseUrl。輸入共享的 OpenCode Key 可以讓 OpenClaw 儲存兩個 runtime provider 所需的憑證，但 Go 仍需要有效的 Go 訂閱資格。

先列模型，再設定預設值#

1
openclaw models list --provider opencode-go

Go 目錄與各模型的用量上限都可能改變，因此本文不把模型名稱列成固定支援清單。OpenClaw 官方建議以 models list 的實際輸出為準；「列得出來」只是目錄可發現，不等於你的帳號已經通過 Go entitlement 檢查。

若輸出中有 kimi-k3，可以設定它為預設模型：

1
openclaw config set agents.defaults.model.primary "opencode-go/kimi-k3"

你的版本也可能列出 deepseek-v4-flash、qwen3.8-max 或 kimi-k2.6 等 ID；請以 CLI 顯示的實際值替換。如果有設定 agents.defaults.models allowlist，還要把相同的完整 opencode-go/... 參照加入 allowlist。OpenClaw 的 provider 與模型設定原則，可參考 模型設定全解。

Session header 要依 client 支援方式確認#

OpenClaw 官方文件目前說明，它會在對 OpenCode 的對話請求中送出穩定的 x-opencode-session header；低階 SDK 串流呼叫則要依 SDK 的 stream options 傳入 session ID。另一方面，OpenCode Go 文件的 client 相容性說明指出，特定 client 可以使用自己的原生 session header，不一定要送出這個確切名稱。因此不要把「缺少 x-opencode-session」當成所有自訂整合都會失敗的通用根因。

遇到「官方 OpenClaw 能用、自訂整合卻行為不一致」時，先用官方 CLI 重現，再比較 provider、完整模型 ID、API endpoint，以及該 client 對 session 的實際支援方式。不要先撤銷 API Key 或重做 onboarding，因為這不會修復由 client 或代理層造成的 session continuity 問題。

模型列得出來，呼叫仍失敗怎麼查#

把「看得到模型」與「能成功推理」分成兩個檢查：

• 執行 openclaw models list --provider opencode-go，確認模型 ID 和 provider 前綴正確。
• 執行 openclaw models status，確認憑證檔案與目前 profile 沒有失效。
• 確認 OpenCode workspace 的 Go 訂閱已生效，而且不是只有 Zen 方案。
• 確認模型參照是 opencode-go/...，沒有誤寫成 opencode/...。
• 若只在特定模型失敗，先換成 models list 中的另一個可用 ID，再查看當下的 Go 用量限制與模型政策。

如果已達到某個模型的 5 小時、每週或每月上限，先到 OpenCode console 檢查 balance 與方案狀態；部分免費模型仍可能可用，但這不會替 Go entitlement 補上。把「模型不可用」、「方案沒有啟用」和「用量已達上限」分開記錄，排錯才不會一直重複建立憑證。

安全的最小檢查可以是：

1
openclaw --version
2
openclaw models list --provider opencode-go
3
openclaw models status

不要在問題尚未分層前重複 onboarding。重做 onboarding 只能更新憑證或設定，不能替 workspace 補上 Go 訂閱，也不能突破 5 小時、每週或每月用量上限。

舊版手動 baseUrl 設定要不要保留#

如果你曾依照舊文件建立自訂 opencode-go provider，現在要重建設定時，優先改用官方 onboarding。原本的 JSON 先備份，再確認新流程能列出 provider 與模型；不要在每次請求中混用自訂 provider 和原生 opencode-go。

這裡的重點不是「看到 baseUrl 就一定錯」，而是原生 provider 已經負責模型路由、憑證與目前目錄。自訂設定若仍正常，可等到規劃好的維護窗口再整理；遇到模型路由或權限問題時，先回到官方流程，才能排除重複設定造成的干擾。

如果你真正要比較的不是模型訂閱，而是「哪個 Agent 能在隔離環境讀檔、執行指令並驗證修改」，可以接著看 OpenHands 的本機安裝、模型設定與故障排除。OpenCode Go 在這篇扮演模型 provider；OpenHands 則是另一套完整的 coding agent 執行介面，兩者不是同一層產品。

結論：先確認訂閱資格，再讓 CLI 決定模型清單#

OpenCode Go 現行官方月費是 10 美元；各模型另有不同的月用量上限，並依 20%／50%／100% 換算 5 小時、每週與每月限制。Zen 與 Go 可以共用 OPENCODE_API_KEY 基礎設施，但 Go entitlement 不會因為有 Zen Key 而自動出現。

實際設定時，使用 openclaw onboard --auth-choice opencode-go、用 openclaw models list --provider opencode-go 取得當前目錄，再用完整的 opencode-go/... 參照設定預設模型。價格、模型與估算請求數會變動，付款和排錯都要以官方頁面與目前 CLI 輸出核對。

常見問題#