Pular para o conteúdo principal

​
OpenCode

O OpenCode expõe dois catálogos hospedados no OpenClaw:
CatalogPrefixRuntime provider
Zenopencode/...opencode
Goopencode-go/...opencode-go
Ambos os catálogos usam a mesma chave de API do OpenCode. O OpenClaw mantém os ids de provedor de runtime separados para que o roteamento upstream por modelo permaneça correto, mas o onboarding e a documentação os tratam como uma única configuração do OpenCode.

​
Introdução

Ideal para: o proxy multimodelo selecionado do OpenCode (Claude, GPT, Gemini).
1

Execute o onboarding

openclaw onboard --auth-choice opencode-zen
Ou passe a chave diretamente:
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
2

Defina um modelo Zen como padrão

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

Verifique se os modelos estão disponíveis

openclaw models list --provider opencode

​
Exemplo de config

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

​
Catálogos

​
Zen

PropertyValue
Provedor de runtimeopencode
Modelos de exemploopencode/claude-opus-4-6, opencode/gpt-5.4, opencode/gemini-3-pro

​
Go

PropertyValue
Provedor de runtimeopencode-go
Modelos de exemploopencode-go/kimi-k2.5, opencode-go/glm-5, opencode-go/minimax-m2.5

​
Observações avançadas

OPENCODE_ZEN_API_KEY também é compatível como alias de OPENCODE_API_KEY.
Informar uma chave OpenCode durante a configuração armazena credenciais para ambos os provedores de runtime. Você não precisa fazer onboarding de cada catálogo separadamente.
Você faz login no OpenCode, adiciona os detalhes de cobrança e copia sua chave de API. A cobrança e a disponibilidade de catálogos são gerenciadas pelo painel do OpenCode.
As refs OpenCode com suporte do Gemini permanecem no caminho proxy-Gemini, então o OpenClaw mantém a sanitização de thought-signature do Gemini ali sem habilitar validação nativa de replay do Gemini nem reescritas de bootstrap.
As refs OpenCode não-Gemini mantêm a política mínima de replay compatível com OpenAI.
Informar uma chave OpenCode durante a configuração armazena credenciais tanto para os provedores de runtime Zen quanto Go, então você só precisa fazer onboarding uma vez.

​
Relacionado

Seleção de modelo

Escolhendo provedores, refs de modelo e comportamento de failover.

Referência de configuração

Referência completa de configuração para agentes, modelos e provedores.