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. OmeniaClaw 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
Endpoint rilevato automaticamente
Ideale per: la maggior parte degli utenti. OmeniaClaw rileva l'endpoint Z.AI corrispondente dalla chiave e applica automaticamente l'URL di base corretto.
Esegui l'onboarding
OmeniaClaw onboard --auth-choice zai-api-keyImposta un modello predefinito
{ env: { ZAI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "zai/glm-5.1" } } },}Verifica che il modello sia elencato
OmeniaClaw models list --all --provider zaiEndpoint regionale esplicito
Ideale per: gli utenti che vogliono forzare uno specifico Coding Plan o una superficie API generale.
Scegli l'opzione di onboarding corretta
# Coding Plan Global (consigliato per gli utenti di Coding Plan)OmeniaClaw onboard --auth-choice zai-coding-global # Coding Plan CN (regione Cina)OmeniaClaw onboard --auth-choice zai-coding-cn # API generaleOmeniaClaw onboard --auth-choice zai-global # API generale CN (regione Cina)OmeniaClaw onboard --auth-choice zai-cnImposta un modello predefinito
{ env: { ZAI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "zai/glm-5.1" } } },}Verifica che il modello sia elencato
OmeniaClaw models list --all --provider zaiCatalogo integrato
OmeniaClaw 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:
OmeniaClaw models list --all --provider zaiIl catalogo basato sul manifest attualmente include:
| Riferimento modello | Note |
|---|---|
zai/glm-5.1 |
Modello 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 |
Configurazione avanzata
Risoluzione in avanti dei modelli GLM-5 sconosciuti
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.
Streaming delle chiamate agli strumenti
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 }, }, }, }, },}Ragionamento e ragionamento preservato
Il ragionamento Z.AI segue i controlli /think di OmeniaClaw. Con il ragionamento disattivato,
OmeniaClaw 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, OmeniaClaw 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 in bundle 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-keyrileva 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.
