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

Providers

Chutes

O Chutes disponibiliza catálogos de modelos de código aberto por meio de uma API compatível com a OpenAI. O OpenClaw oferece suporte tanto a OAuth pelo navegador quanto à autenticação por chave de API.

Propriedade Valor
Provedor chutes
Plugin pacote externo oficial (@openclaw/chutes-provider)
API compatível com a OpenAI
URL base https://llm.chutes.ai/v1
Autenticação OAuth ou chave de API (veja abaixo)
Variáveis de ambiente de execução CHUTES_API_KEY, CHUTES_OAUTH_TOKEN

CHUTES_OAUTH_TOKEN fornece diretamente um token de acesso OAuth já obtido (por exemplo, em CI), ignorando o fluxo interativo pelo navegador descrito abaixo.

Instalar o Plugin

bash
openclaw plugins install @openclaw/chutes-provideropenclaw gateway restart

Primeiros passos

Ambos os métodos definem o modelo padrão como chutes/zai-org/GLM-4.7-TEE e registram o catálogo do Chutes.

OAuth

  • Execute o fluxo de integração do OAuth

    bash
    openclaw onboard --auth-choice chutes

    O OpenClaw inicia o fluxo pelo navegador localmente ou exibe uma URL e um fluxo para colar o redirecionamento em hosts remotos/sem interface gráfica. Os tokens OAuth são renovados automaticamente por meio dos perfis de autenticação do OpenClaw.

    • Chave de API

  • Obtenha uma chave de API

    Crie uma chave em chutes.ai/settings/api-keys.

  • Execute o fluxo de integração da chave de API

    bash
    openclaw onboard --auth-choice chutes-api-key

    • Comportamento da descoberta

    Quando a autenticação do Chutes está disponível, o OpenClaw consulta GET /v1/models com essa credencial e usa os modelos descobertos, armazenados em cache por 5 minutos para cada credencial. Em caso de chave expirada ou não autorizada (HTTP 401), o OpenClaw tenta novamente uma vez sem credenciais. Se a descoberta ainda não retornar nenhuma linha, falhar ou retornar qualquer outro status que não seja 2xx, ele recorre ao catálogo estático incluído (as descobertas por chave de API e OAuth usam esse mesmo caminho). Se a descoberta falhar na inicialização, o catálogo estático será usado automaticamente.

    Aliases padrão

    O OpenClaw registra três aliases práticos para o catálogo do Chutes:

    Alias Modelo de destino
    chutes-fast chutes/zai-org/GLM-4.7-FP8
    chutes-pro chutes/deepseek-ai/DeepSeek-V3.2-TEE
    chutes-vision chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506

    Catálogo inicial integrado

    O catálogo alternativo incluído contém 47 modelos. Veja uma amostra representativa das referências atuais:

    Referência do modelo
    chutes/zai-org/GLM-4.7-TEE
    chutes/zai-org/GLM-5-TEE
    chutes/deepseek-ai/DeepSeek-V3.2-TEE
    chutes/deepseek-ai/DeepSeek-R1-0528-TEE
    chutes/moonshotai/Kimi-K2.5-TEE
    chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506
    chutes/Qwen/Qwen3-Coder-Next-TEE
    chutes/openai/gpt-oss-120b-TEE

    Execute openclaw models list --all --provider chutes para ver a lista completa.

    Exemplo de configuração

    json5
    {  agents: {    defaults: {      model: { primary: "chutes/zai-org/GLM-4.7-TEE" },      models: {        "chutes/zai-org/GLM-4.7-TEE": { alias: "Chutes GLM 4.7" },        "chutes/deepseek-ai/DeepSeek-V3.2-TEE": { alias: "Chutes DeepSeek V3.2" },      },    },  },}
    Substituições de OAuth

    Personalize o fluxo OAuth com variáveis de ambiente opcionais:

    Variável Finalidade
    CHUTES_CLIENT_ID ID do cliente OAuth (solicitado se não estiver definido)
    CHUTES_CLIENT_SECRET Segredo do cliente OAuth
    CHUTES_OAUTH_REDIRECT_URI URI de redirecionamento (padrão: http://127.0.0.1:1456/oauth-callback)
    CHUTES_OAUTH_SCOPES Escopos separados por espaços (padrão: openid profile chutes:invoke)

    Consulte a documentação de OAuth do Chutes para obter os requisitos do aplicativo de redirecionamento e ajuda.

    Observações
    • Os modelos do Chutes são registrados como chutes/<model-id>.
    • O Chutes não informa o uso de tokens durante a transmissão (supportsUsageInStreaming: false); os totais de uso ainda são exibidos quando a transmissão é concluída.

    Relacionados

    Seleção de modelos

    Regras do provedor, referências de modelos e comportamento de failover.
    Referência de configuração

    Esquema completo de configuração, incluindo as configurações do provedor.
    Chutes

    Painel e documentação da API do Chutes.
    Chaves de API do Chutes

    Crie e gerencie chaves de API do Chutes.
    Was this useful?
    On this page

    On this page