Pular para o conteúdo principal
OpenCode expõe dois catálogos hospedados no OpenClaw:
CatálogoPrefixoProvedor de runtime
Zenopencode/...opencode
Goopencode-go/...opencode-go
Ambos os catálogos usam a mesma chave de API do OpenCode. O OpenClaw mantém os IDs dos provedores de runtime separados para que o roteamento upstream por modelo permaneça correto, mas a integração inicial e a documentação os tratam como uma única configuração do OpenCode.

Primeiros passos

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

Executar a integração inicial

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

Definir um modelo Zen como padrão

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

Verificar se os modelos estão disponíveis

openclaw models list --provider opencode

Exemplo de configuração

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

Catálogos integrados

Zen

PropriedadeValor
Provedor de runtimeopencode
Modelos de exemploopencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3.1-pro, opencode/glm-5.2

Go

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

Configuração avançada

OPENCODE_ZEN_API_KEY também é compatível como um alias para OPENCODE_API_KEY.
Inserir uma chave do OpenCode durante a configuração armazena credenciais para ambos os provedores de runtime. Você não precisa configurar cada catálogo separadamente na integração inicial.
Você entra no OpenCode, adiciona os detalhes de cobrança e copia sua chave de API. A cobrança e a disponibilidade do catálogo são gerenciadas pelo painel do OpenCode.
As refs do OpenCode baseadas no Gemini permanecem no caminho proxy-Gemini, portanto o OpenClaw mantém a sanitização de assinatura de pensamento do Gemini ali sem habilitar a validação de repetição nativa do Gemini nem reescritas de bootstrap.
As refs do OpenCode não Gemini mantêm a política mínima de repetição compatível com OpenAI.
Inserir uma chave do OpenCode durante a configuração armazena credenciais para os provedores de runtime Zen e Go, então você só precisa fazer a integração inicial uma vez.

Relacionados

Seleção de modelo

Escolha de provedores, refs de modelo e comportamento de alternância em caso de falha.

Referência de configuração

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