跳轉到主要內容
OpenCode 在 OpenClaw 中公開兩個託管目錄:
目錄前綴執行階段提供者
Zenopencode/...opencode
Goopencode-go/...opencode-go
兩個目錄共用同一把 OpenCode API 金鑰(OPENCODE_API_KEY,別名 OPENCODE_ZEN_API_KEY)。OpenClaw 會將執行階段提供者 ID 保持分開,讓 上游的個別模型路由維持正確,但初始設定與文件會將它們視為 同一個 OpenCode 設定。

開始使用

最適合: 精選的 OpenCode 多模型代理(Claude、GPT、Gemini、GLM、 DeepSeek、Kimi、MiniMax、Qwen)。
1

Run onboarding

openclaw onboard --auth-choice opencode-zen
或直接傳入金鑰:
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
2

Set a Zen model as the default

openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"
3

Verify models are available

openclaw models list --provider opencode

設定範例

{
  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-pickleopencode/deepseek-v4-flash-free

Go

屬性
執行階段提供者opencode-go
範例模型opencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5
請參閱 OpenCode Go 以取得完整的 Go 模型表。

進階設定

OPENCODE_ZEN_API_KEY 也可作為 OPENCODE_API_KEY 的別名使用。
在設定期間輸入一把 OpenCode 金鑰,會為兩個執行階段 提供者儲存憑證。你不需要分別為每個目錄執行初始設定。
建立 OpenCode 帳戶,並在 opencode.ai/auth 產生 API 金鑰。計費與目錄 可用性會從 OpenCode 儀表板管理。
Gemini 支援的 OpenCode 參照會保留在 proxy-Gemini 路徑上,因此 OpenClaw 會在那裡保留 Gemini thought-signature 清理,而不啟用原生 Gemini 重播驗證或啟動重寫。
非 Gemini 的 OpenCode 參照會保留最小 OpenAI 相容重播政策。

相關內容

OpenCode Go

完整的 Go 目錄參考。

Model selection

選擇提供者、模型參照與故障轉移行為。

Configuration reference

代理程式、模型與提供者的完整設定參考。