OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

OpenCode

O OpenCode disponibiliza dois catálogos hospedados no OpenClaw:

Catálogo Prefixo Provedor de execução
Zen opencode/... opencode
Go opencode-go/... opencode-go

Ambos os catálogos compartilham uma chave de API do OpenCode (OPENCODE_API_KEY, alias OPENCODE_ZEN_API_KEY). O OpenClaw mantém separados os ids dos provedores de execução para que o roteamento por modelo no upstream permaneça correto, mas a integração inicial e a documentação os tratam como uma única configuração do OpenCode.

Primeiros passos

Catálogo Zen

Ideal para: o proxy multimodelo selecionado do OpenCode (Claude, GPT, Gemini, GLM, DeepSeek, Kimi, MiniMax, Qwen).

  • Execute a integração inicial

    bash
    openclaw onboard --auth-choice opencode-zen

    Ou informe a chave diretamente:

    bash
    openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"

  • Defina um modelo Zen como padrão

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

  • Verifique se os modelos estão disponíveis

    bash
    openclaw models list --provider opencode

    • Catálogo Go

    Ideal para: a seleção de modelos Kimi, GLM, MiniMax, Qwen e DeepSeek hospedada pelo OpenCode.

  • Execute a integração inicial

    bash
    openclaw onboard --auth-choice opencode-go

    Ou informe a chave diretamente:

    bash
    openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"

  • Defina um modelo Go como padrão

    bash
    openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"

  • Verifique se os modelos estão disponíveis

    bash
    openclaw models list --provider opencode-go

    • Exemplo de configuração

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

    Catálogos integrados

    Zen

    Propriedade Valor
    Provedor de execução opencode
    Modelos de exemplo opencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3.1-pro, opencode/glm-5.2

    Execute openclaw models list --provider opencode para obter a lista atual completa, que também inclui opções da faixa gratuita, como opencode/big-pickle e opencode/deepseek-v4-flash-free.

    Go

    Propriedade Valor
    Provedor de execução opencode-go
    Modelos de exemplo opencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5

    Consulte OpenCode Go para ver a tabela completa de modelos Go.

    Configuração avançada

    Aliases da chave de API

    OPENCODE_ZEN_API_KEY também é aceita como alias de OPENCODE_API_KEY.

    Credenciais compartilhadas

    Inserir uma chave do OpenCode durante a configuração armazena as credenciais para ambos os provedores de execução. Não é necessário realizar a integração inicial de cada catálogo separadamente.

    Como obter uma chave de API

    Crie uma conta do OpenCode e gere uma chave de API em opencode.ai/auth. O faturamento e a disponibilidade dos catálogos são gerenciados no painel do OpenCode.

    Comportamento de reprodução do Gemini

    As referências do OpenCode baseadas no Gemini permanecem no caminho proxy-Gemini, portanto o OpenClaw mantém ali a higienização das assinaturas de raciocínio do Gemini sem habilitar a validação nativa de reprodução do Gemini nem reescritas de inicialização.

    Comportamento de reprodução para modelos não Gemini

    As referências do OpenCode que não usam Gemini mantêm a política mínima de reprodução compatível com OpenAI.

    Relacionados

    OpenCode Go

    Referência completa do catálogo Go.
    Seleção de modelos

    Como escolher provedores, referências de modelos e o comportamento de failover.
    Referência de configuração

    Referência completa da configuração de agentes, modelos e provedores.
    Was this useful?
    On this page

    On this page