English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Providers

Z.AI

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
Provider zai
Pacchetto @openclaw/zai-provider
Autenticazione ZAI_API_KEY (alias legacy: Z_AI_API_KEY)
API Z.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:

bash
openclaw plugins install @openclaw/zai-provider

Rilevamento automatico dell'endpoint

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.

  • Esegui l'onboarding

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

  • Verifica che il modello sia elencato

    bash
    openclaw models list --all --provider zai

    • Endpoint regionale esplicito

    Ideale per: utenti che vogliono forzare uno specifico Coding Plan o una superficie API generale.

  • Scegli l'opzione di onboarding corretta

    bash
    # Coding Plan Global (consigliato per gli utenti del Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (regione Cina)openclaw onboard --auth-choice zai-coding-cn # API generaleopenclaw onboard --auth-choice zai-global # API generale CN (regione Cina)openclaw onboard --auth-choice zai-cn

  • Verifica che il modello sia elencato

    bash
    openclaw models list --all --provider zai

    • Esempio di configurazione

    json5
    {  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:

    bash
    openclaw models list --all --provider zai

    Il catalogo basato sul manifesto attualmente include:

    Riferimento modello Note
    zai/glm-5.2 Predefinito del Coding Plan; contesto 1M
    zai/glm-5.1 Predefinito 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

    Configurazione avanzata

    Risoluzione in avanti dei modelli GLM-5 sconosciuti

    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.

    Streaming delle chiamate agli strumenti

    tool_stream è abilitato per impostazione predefinita per lo streaming delle chiamate agli strumenti di Z.AI. Per disabilitarlo:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Thinking e thinking preservato

    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:

    json5
    {  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.

    Comprensione delle immagini

    Il Plugin Z.AI registra la comprensione delle immagini.

    Proprietà Valore
    Modello glm-4.6v

    La comprensione delle immagini viene risolta automaticamente dall'autenticazione Z.AI configurata: non è necessaria alcuna configurazione aggiuntiva.

    Dettagli di autenticazione
    • 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.
    Was this useful?
    On this page

    On this page