> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scivoli

[Chutes](https://chutes.ai) espone cataloghi di modelli open-source tramite un'API compatibile con
OpenAI. OpenClaw supporta sia OAuth via browser sia l'autenticazione diretta con chiave API
per il provider `chutes`.

| Proprietà      | Valore                          |
| -------------- | ------------------------------- |
| Provider       | `chutes`                        |
| API            | Compatibile con OpenAI          |
| URL base       | `https://llm.chutes.ai/v1`      |
| Autenticazione | OAuth o chiave API (vedi sotto) |

## Installa Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/chutes-provider
openclaw gateway restart
```

## Per iniziare

<Tabs>
  <Tab title="OAuth">
    <Steps>
      <Step title="Esegui il flusso di onboarding OAuth">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice chutes
        ```

        OpenClaw avvia il flusso del browser localmente oppure mostra un URL + un flusso
        di reindirizzamento con incolla su host remoti/headless. I token OAuth si aggiornano
        automaticamente tramite i profili di autenticazione di OpenClaw.
      </Step>

      <Step title="Verifica il modello predefinito">
        Dopo l'onboarding, il modello predefinito viene impostato su
        `chutes/zai-org/GLM-4.7-TEE` e il catalogo statico di Chutes viene
        registrato.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Chiave API">
    <Steps>
      <Step title="Ottieni una chiave API">
        Crea una chiave in
        [chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys).
      </Step>

      <Step title="Esegui il flusso di onboarding con chiave API">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice chutes-api-key
        ```
      </Step>

      <Step title="Verifica il modello predefinito">
        Dopo l'onboarding, il modello predefinito viene impostato su
        `chutes/zai-org/GLM-4.7-TEE` e il catalogo statico di Chutes viene
        registrato.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Note>
  Entrambi i percorsi di autenticazione registrano il catalogo statico di Chutes e impostano il modello predefinito su
  `chutes/zai-org/GLM-4.7-TEE`. Variabili d'ambiente di runtime: `CHUTES_API_KEY`,
  `CHUTES_OAUTH_TOKEN`.
</Note>

## Comportamento di discovery

Quando l'autenticazione Chutes è disponibile, OpenClaw interroga il catalogo Chutes con quelle
credenziali e usa i modelli rilevati. Se la discovery non riesce, OpenClaw ripiega
su un catalogo statico, così onboarding e avvio continuano a funzionare.

## Alias predefiniti

OpenClaw registra tre alias di comodità per il catalogo statico di 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 statico di fallback include i riferimenti Chutes attuali:

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

## Esempio di configurazione

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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" },
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="Override OAuth">
    Puoi personalizzare il flusso OAuth con variabili d'ambiente opzionali:

    | Variabile                   | Scopo                                  |
    | --------------------------- | -------------------------------------- |
    | `CHUTES_CLIENT_ID`          | ID client OAuth personalizzato         |
    | `CHUTES_CLIENT_SECRET`      | Segreto client OAuth personalizzato    |
    | `CHUTES_OAUTH_REDIRECT_URI` | URI di reindirizzamento personalizzato |
    | `CHUTES_OAUTH_SCOPES`       | Ambiti OAuth personalizzati            |

    Consulta la [documentazione OAuth di Chutes](https://chutes.ai/docs/sign-in-with-chutes/overview)
    per i requisiti dell'app di reindirizzamento e assistenza.
  </Accordion>

  <Accordion title="Note">
    * La discovery con chiave API e OAuth usa lo stesso ID provider `chutes`.
    * I modelli Chutes sono registrati come `chutes/<model-id>`.
    * Se la discovery non riesce all'avvio, il catalogo statico viene usato automaticamente.
  </Accordion>
</AccordionGroup>

## Correlati

<CardGroup cols={2}>
  <Card title="Selezione del modello" href="/it/concepts/model-providers" icon="layers">
    Regole dei provider, riferimenti dei modelli e comportamento di failover.
  </Card>

  <Card title="Riferimento di configurazione" href="/it/gateway/configuration-reference" icon="gear">
    Schema di configurazione completo, incluse le impostazioni dei provider.
  </Card>

  <Card title="Chutes" href="https://chutes.ai" icon="arrow-up-right-from-square">
    Dashboard Chutes e documentazione API.
  </Card>

  <Card title="Chiavi API Chutes" href="https://chutes.ai/settings/api-keys" icon="key">
    Crea e gestisci le chiavi API Chutes.
  </Card>
</CardGroup>