OpenCode

OpenCode 在 OpenClaw 中提供兩個託管目錄：

目錄	前綴	執行階段供應商
Zen	opencode/...	opencode
Go	opencode-go/...	opencode-go

這兩個目錄共用一個 OpenCode API 金鑰（OPENCODE_API_KEY，別名為 OPENCODE_ZEN_API_KEY）。OpenClaw 將執行階段供應商 ID 分開，以確保 上游的各模型路由維持正確，但引導設定與文件會將其視為 同一套 OpenCode 設定。

​

開始使用

Zen 目錄

最適合： 精選的 OpenCode 多模型代理（Claude、GPT、Gemini、GLM、 DeepSeek、Kimi、MiniMax、Qwen）。

1. 執行引導設定

   openclaw onboard --auth-choice opencode-zen
   

   或直接傳入金鑰：

   openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
   
2. 將 Zen 模型設為預設模型

   openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"
   
3. 確認模型可用

   openclaw models list --provider opencode
   

Go 目錄

最適合： 由 OpenCode 託管的 Kimi、GLM、MiniMax、Qwen 與 DeepSeek 模型陣容。

1. 執行引導設定

   openclaw onboard --auth-choice opencode-go
   

   或直接傳入金鑰：

   openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
   
2. 將 Go 模型設為預設模型

   openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"
   
3. 確認模型可用

   openclaw models list --provider opencode-go
   

​

設定範例

{
  env: { OPENCODE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

​

內建目錄

​

Zen

屬性	值
執行階段供應商	opencode
模型範例	opencode/claude-opus-4-6、opencode/gpt-5.5、opencode/gemini-3.1-pro、opencode/glm-5.2

執行 openclaw models list --provider opencode 以查看目前的完整清單，其中 也包含免費方案項目，例如 opencode/big-pickle 與 opencode/deepseek-v4-flash-free。

​

Go

屬性	值
執行階段供應商	opencode-go
模型範例	opencode-go/kimi-k2.6、opencode-go/glm-5、opencode-go/minimax-m2.5

如需完整的 Go 模型表，請參閱 OpenCode Go。

​

進階設定

API 金鑰別名

OPENCODE_ZEN_API_KEY 也可作為 OPENCODE_API_KEY 的別名使用。

共用認證資訊

在設定期間輸入一個 OpenCode 金鑰，便會儲存兩個執行階段 供應商的認證資訊。你不需要分別為每個目錄進行引導設定。

取得 API 金鑰

建立 OpenCode 帳號，並在 opencode.ai/auth 產生 API 金鑰。帳務與目錄 可用性由 OpenCode 儀表板管理。

Gemini 重播行為

由 Gemini 支援的 OpenCode 參照會維持使用代理 Gemini 路徑，因此 OpenClaw 會在該路徑 保留 Gemini 思考簽章清理機制，而不會啟用原生 Gemini 重播驗證或啟動程序重寫。

非 Gemini 重播行為

非 Gemini 的 OpenCode 參照會保留最低限度的 OpenAI 相容重播政策。

​

相關內容

OpenCode Go

完整的 Go 目錄參考資料。

模型選擇

選擇供應商、模型參照與容錯移轉行為。

設定參考

代理程式、模型與供應商的完整設定參考資料。