Vai al contenuto principale

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.

Z.AI è la piattaforma API per i modelli GLM. Fornisce API REST per GLM e usa chiavi API per l’autenticazione. Crea la tua chiave API nella console Z.AI. OpenClaw usa il provider zai con una chiave API Z.AI.
  • Provider: zai
  • Autenticazione: ZAI_API_KEY
  • API: Chat Completions Z.AI (autenticazione Bearer)

​
Per iniziare

Ideale per: la maggior parte degli utenti. OpenClaw rileva l’endpoint Z.AI corrispondente dalla chiave e applica automaticamente l’URL di base corretto.
1

Esegui l'onboarding

openclaw onboard --auth-choice zai-api-key
2

Imposta un modello predefinito

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

Verifica che il modello sia elencato

openclaw models list --all --provider zai

​
Catalogo integrato

OpenClaw distribuisce il catalogo del provider zai in bundle nel manifest del plugin, quindi l’elenco in sola lettura può mostrare le righe GLM note senza caricare il runtime del provider: 
openclaw models list --all --provider zai
Il catalogo basato sul manifest attualmente include:
Riferimento modelloNote
zai/glm-5.1Modello predefinito
zai/glm-5
zai/glm-5-turbo
zai/glm-5v-turbo
zai/glm-4.7
zai/glm-4.7-flash
zai/glm-4.7-flashx
zai/glm-4.6
zai/glm-4.6v
zai/glm-4.5
zai/glm-4.5-air
zai/glm-4.5-flash
zai/glm-4.5v
I modelli GLM sono disponibili come zai/<model> (esempio: zai/glm-5). Il riferimento modello predefinito in bundle è zai/glm-5.1.

​
Configurazione avanzata

Gli id glm-5* sconosciuti continuano a risolversi in avanti sul percorso del provider in bundle sintetizzando metadati di proprietà del provider dal modello glm-4.7 quando l’id corrisponde alla forma corrente della famiglia GLM-5.
tool_stream è abilitato per impostazione predefinita per lo streaming delle chiamate agli strumenti Z.AI. Per disabilitarlo:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Il ragionamento Z.AI segue i controlli /think di OpenClaw. Con il ragionamento disattivato, OpenClaw invia thinking: { type: "disabled" } per evitare risposte che consumano il budget di output in reasoning_content prima del testo visibile.Il ragionamento preservato è facoltativo perché Z.AI richiede che l’intero storico reasoning_content venga riprodotto, aumentando i token del prompt. Abilitalo per modello:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Quando è abilitato e il ragionamento è attivo, OpenClaw invia thinking: { type: "enabled", clear_thinking: false } e riproduce il precedente reasoning_content per la stessa trascrizione compatibile con OpenAI.Gli utenti avanzati possono comunque sovrascrivere il payload esatto del provider con params.extra_body.thinking.
Il plugin Z.AI in bundle registra la comprensione delle immagini.
ProprietàValore
Modelloglm-4.6v
La comprensione delle immagini viene risolta automaticamente dall’autenticazione Z.AI configurata: non è necessaria alcuna configurazione aggiuntiva.
  • Z.AI usa l’autenticazione Bearer con la tua chiave API.
  • L’opzione di onboarding zai-api-key rileva automaticamente l’endpoint Z.AI corrispondente dal prefisso della chiave.
  • Usa le opzioni regionali esplicite (zai-coding-global, zai-coding-cn, zai-global, zai-cn) quando vuoi forzare una superficie API specifica.

​
Correlati

Famiglia di modelli GLM

Panoramica della famiglia di modelli GLM.

Selezione del modello

Scelta dei provider, dei riferimenti modello e del comportamento di failover.