Chutes

Chutes espone cataloghi di modelli open source tramite un’API compatibile con OpenAI. OpenClaw supporta sia OAuth tramite browser sia l’autenticazione con chiave API.

Proprietà	Valore
Provider	`chutes`
Plugin	pacchetto esterno ufficiale (`@openclaw/chutes-provider`)
API	compatibile con OpenAI
URL di base	`https://llm.chutes.ai/v1`
Autenticazione	OAuth o chiave API (vedere sotto)
Variabili di ambiente	`CHUTES_API_KEY`, `CHUTES_OAUTH_TOKEN`

CHUTES_OAUTH_TOKEN fornisce direttamente un token di accesso OAuth già ottenuto (ad esempio nella CI), evitando il flusso interattivo tramite browser descritto di seguito.

Installare il Plugin

openclaw plugins install @openclaw/chutes-provider
openclaw gateway restart

Introduzione

Entrambi i percorsi impostano il modello predefinito su chutes/zai-org/GLM-4.7-TEE e registrano il catalogo Chutes.

OAuth
Chiave API

Eseguire il flusso di configurazione iniziale OAuth

openclaw onboard --auth-choice chutes

OpenClaw avvia localmente il flusso tramite browser oppure, sugli host remoti o senza interfaccia grafica, mostra un URL e richiede di incollare il reindirizzamento. I token OAuth vengono aggiornati automaticamente tramite i profili di autenticazione di OpenClaw.

Ottenere una chiave API

Creare una chiave in chutes.ai/settings/api-keys.

Eseguire il flusso di configurazione iniziale della chiave API

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

Comportamento del rilevamento

Quando è disponibile l’autenticazione Chutes, OpenClaw interroga GET /v1/models con tali credenziali e utilizza i modelli rilevati, memorizzandoli nella cache per 5 minuti per ogni credenziale. In caso di chiave scaduta o non autorizzata (HTTP 401), OpenClaw riprova una volta senza credenziali. Se il rilevamento continua a non restituire righe, non riesce o restituisce qualsiasi altro stato diverso da 2xx, viene utilizzato come ripiego il catalogo statico incluso (sia il rilevamento con chiave API sia quello con OAuth usano lo stesso percorso). Se il rilevamento non riesce all’avvio, il catalogo statico viene utilizzato automaticamente.

Alias predefiniti

OpenClaw registra tre pratici alias per il catalogo Chutes:

Alias	Modello di destinazione
`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`

Catalogo iniziale integrato

Il catalogo di ripiego incluso contiene 47 modelli. Di seguito è riportato un campione rappresentativo dei riferimenti attuali:

Riferimento del modello
`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`

Eseguire openclaw models list --all --provider chutes per visualizzare l’elenco completo.

Esempio di configurazione

{
  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" },
      },
    },
  },
}

Personalizzazioni OAuth

Personalizzare il flusso OAuth con variabili di ambiente facoltative:

Variabile	Scopo
`CHUTES_CLIENT_ID`	ID client OAuth (richiesto se non impostato)
`CHUTES_CLIENT_SECRET`	Segreto client OAuth
`CHUTES_OAUTH_REDIRECT_URI`	URI di reindirizzamento (valore predefinito `http://127.0.0.1:1456/oauth-callback`)
`CHUTES_OAUTH_SCOPES`	Ambiti separati da spazi (valore predefinito `openid profile chutes:invoke`)

Consultare la documentazione OAuth di Chutes per i requisiti delle applicazioni di reindirizzamento e per ricevere assistenza.

Note

I modelli Chutes vengono registrati come chutes/<model-id>.
Chutes non segnala l’utilizzo dei token durante lo streaming (supportsUsageInStreaming: false); i totali di utilizzo vengono comunque visualizzati al completamento del flusso.

Contenuti correlati

Selezione del modello

Regole dei provider, riferimenti dei modelli e comportamento di failover.

Riferimento della configurazione

Schema di configurazione completo, incluse le impostazioni dei provider.

Dashboard Chutes e documentazione dell’API.

Chiavi API di Chutes

Creare e gestire le chiavi API di Chutes.

Overview

Concepts and configuration

Providers

Chutes

Installare il Plugin

Introduzione

Comportamento del rilevamento

Alias predefiniti

Catalogo iniziale integrato

Esempio di configurazione

Contenuti correlati

Selezione del modello

Riferimento della configurazione

Chutes

Chiavi API di Chutes

​Installare il Plugin

​Introduzione

​Comportamento del rilevamento

​Alias predefiniti

​Catalogo iniziale integrato

​Esempio di configurazione

​Contenuti correlati

Selezione del modello

Riferimento della configurazione

Chutes

Chiavi API di Chutes

Installare il Plugin

Introduzione

Comportamento del rilevamento

Alias predefiniti

Catalogo iniziale integrato

Esempio di configurazione

Contenuti correlati