Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

O 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 de provedor de runtime separados para que o roteamento upstream por modelo permaneça correto, mas onboarding e documentação tratam isso como uma única configuração do OpenCode.

​
Primeiros passos

Ideal para: o proxy multimodelo curado 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 configuração

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

​
Catálogos incluídos

​
Zen

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

​
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 alias de OPENCODE_API_KEY.
Informar uma chave OpenCode durante o setup armazena credenciais para ambos os provedores de runtime. Você não precisa fazer onboarding de cada catálogo separadamente.
Você entra no OpenCode, adiciona 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.
Refs do OpenCode com base em Gemini permanecem no caminho proxy-Gemini, então o OpenClaw mantém ali a sanitização de assinatura de pensamento do Gemini sem habilitar validação de replay nativo do Gemini nem reescritas de bootstrap.
Refs do OpenCode não Gemini mantêm a política mínima de replay compatível com OpenAI.
Inserir uma chave OpenCode durante o setup armazena credenciais para ambos os provedores de runtime, Zen e Go, então você só precisa fazer onboarding uma vez.

​
Relacionado

Seleção de modelo

Escolhendo provedores, model refs e comportamento de failover.

Referência de configuração

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