Vai al contenuto principale
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.
ProprietàValore
Providerzai
Pacchetto@openclaw/zai-provider
AutenticazioneZAI_API_KEY (alias legacy: Z_AI_API_KEY)
APIZ.AI Chat Completions (autenticazione Bearer)

​
Modelli GLM

GLM è una famiglia di modelli, non un provider separato. In OpenClaw, i modelli GLM usano riferimenti come zai/glm-5.2: provider zai, ID modello glm-5.2.

​
Guida introduttiva

Installa prima il Plugin del provider: 
openclaw plugins install @openclaw/zai-provider
Ideale per: la maggior parte degli utenti. OpenClaw verifica gli endpoint Z.AI supportati con la tua chiave API e applica automaticamente l’URL di base corretto.
1

Esegui l'onboarding

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

Verifica che il modello sia elencato

openclaw models list --all --provider zai

​
Esempio di configurazione

zai-api-key consente a OpenClaw di rilevare dalla chiave l’endpoint Z.AI corrispondente e applicare automaticamente l’URL di base corretto. Usa le opzioni regionali esplicite quando vuoi forzare uno specifico Coding Plan o una superficie API generale.
{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 uses the Coding Plan endpoint.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

​
Catalogo integrato

Il Plugin del provider zai distribuisce il suo catalogo nel manifesto 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 manifesto attualmente include:
Riferimento modelloNote
zai/glm-5.2Predefinito del Coding Plan; contesto 1M
zai/glm-5.1Predefinito dell’API generale
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).
GLM-5.2 supporta i livelli di thinking off, low, high e max. OpenClaw mappa low e high sullo sforzo di ragionamento alto di Z.AI, e max sullo sforzo massimo.
La configurazione del Coding Plan usa come predefinito zai/glm-5.2; la configurazione dell’API generale mantiene zai/glm-5.1. Il rilevamento automatico dell’endpoint ripiega su glm-5.1 o glm-4.7 quando il piano selezionato non espone GLM-5.2. Le versioni e la disponibilità di GLM possono cambiare; esegui openclaw models list --all --provider zai per vedere il catalogo noto alla tua versione installata.

​
Configurazione avanzata

Gli ID glm-5* sconosciuti continuano a risolversi in avanti sul percorso del provider sintetizzando metadati di proprietà del provider dal modello glm-4.7 quando l’ID corrisponde alla forma attuale della famiglia GLM-5.
tool_stream è abilitato per impostazione predefinita per lo streaming delle chiamate agli strumenti di Z.AI. Per disabilitarlo:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Il thinking di Z.AI segue i controlli /think di OpenClaw. Con il thinking disattivato, OpenClaw invia thinking: { type: "disabled" } per evitare risposte che consumano il budget di output in reasoning_content prima del testo visibile.Il thinking preservato è opt-in perché Z.AI richiede che l’intero reasoning_content storico venga riprodotto, aumentando i token del prompt. Abilitalo per modello:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Quando è abilitato e il thinking è 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 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 verificando gli endpoint supportati con la tua chiave.
  • Usa le opzioni regionali esplicite (zai-coding-global, zai-coding-cn, zai-global, zai-cn) quando vuoi forzare una specifica superficie API.
  • La variabile env legacy Z_AI_API_KEY è ancora accettata; OpenClaw la copia in ZAI_API_KEY all’avvio se ZAI_API_KEY non è impostata.

​
Correlati

Selezione del modello

Scelta dei provider, riferimenti modello e comportamento di failover.

Riferimento di configurazione

Schema completo di configurazione di OpenClaw, incluse le impostazioni di provider e modello.