Skip to content

OpenCode

OpenCode 在 OpenClaw 中公開了兩個託管目錄:

目錄前綴Runtime provider
Zenopencode/...opencode
Goopencode-go/...opencode-go

這兩個目錄使用相同的 OpenCode API 金鑰。OpenClaw 保持 runtime provider id 分開,以便上游按模型的路由保持正確,但入門指南和文件將它們視為一個 OpenCode 設定。

最適合用於: 經過策劃的 OpenCode 多模型代理(Claude、GPT、Gemini)。

  1. 執行入門

    Terminal window
    openclaw onboard --auth-choice opencode-zen

    或直接傳遞金鑰:

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

    Terminal window
    openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"
  3. 驗證模型是否可用

    Terminal window
    openclaw models list --provider opencode
{
env: { OPENCODE_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}
屬性
Runtime provideropencode
範例模型opencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3-pro
屬性
Runtime provideropencode-go
範例模型opencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5
API 金鑰別名

OPENCODE_ZEN_API_KEY 也支援作為 OPENCODE_API_KEY 的別名。

共用認證

在設定期間輸入一個 OpenCode 金鑰會儲存這兩個執行時提供者的 認證資訊。您不需要分別為每個目錄進行上架。

計費與儀表板

您登入 OpenCode,新增計費詳細資訊,並複製您的 API 金鑰。計費 和目錄可用性是從 OpenCode 儀表板進行管理的。

Gemini 重播行為

支援 Gemini 的 OpenCode 參照會停留在 proxy-Gemini 路徑上,因此 OpenClaw 會在該處保留 Gemini 思維簽章清理,而不啟用原生的 Gemini 重播驗證或啟動重寫。

非 Gemini 重播行為

非 Gemini 的 OpenCode 參照會保持最少的 OpenAI 相容重播原則。

模型選擇

選擇提供者、模型參照和容錯移轉行為。

設定參考

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