Przejdź do głównej treści

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 to platforma API dla modeli GLM. Udostępnia interfejsy REST API dla GLM i używa kluczy API do uwierzytelniania. Utwórz klucz API w konsoli Z.AI. OpenClaw używa providera zai z kluczem API Z.AI.
  • Provider: zai
  • Uwierzytelnianie: ZAI_API_KEY
  • API: Z.AI Chat Completions (uwierzytelnianie Bearer)

Pierwsze kroki

Najlepsze dla: większości użytkowników. OpenClaw wykrywa pasujący punkt końcowy Z.AI na podstawie klucza i automatycznie stosuje prawidłowy bazowy adres URL.
1

Uruchom onboarding

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

Ustaw model domyślny

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

Sprawdź, czy model jest na liście

openclaw models list --all --provider zai

Wbudowany katalog

OpenClaw dostarcza dołączony katalog providera zai w manifeście Plugin, więc lista tylko do odczytu może pokazywać znane wiersze GLM bez ładowania środowiska uruchomieniowego providera:
openclaw models list --all --provider zai
Katalog oparty na manifeście obecnie obejmuje:
Odwołanie do modeluUwagi
zai/glm-5.1Model domyślny
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
Modele GLM są dostępne jako zai/<model> (przykład: zai/glm-5). Domyślne dołączone odwołanie do modelu to zai/glm-5.1.

Konfiguracja zaawansowana

Nieznane identyfikatory glm-5* nadal są rozwiązywane w przód na ścieżce dołączonego providera przez syntetyzowanie metadanych należących do providera z szablonu glm-4.7, gdy identyfikator pasuje do bieżącego kształtu rodziny GLM-5.
tool_stream jest domyślnie włączone dla strumieniowania wywołań narzędzi Z.AI. Aby je wyłączyć:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Myślenie Z.AI podąża za kontrolkami /think OpenClaw. Gdy myślenie jest wyłączone, OpenClaw wysyła thinking: { type: "disabled" }, aby uniknąć odpowiedzi, które zużywają budżet wyjściowy na reasoning_content przed widocznym tekstem.Zachowane myślenie jest opcjonalne, ponieważ Z.AI wymaga odtworzenia pełnej historycznej zawartości reasoning_content, co zwiększa liczbę tokenów promptu. Włącz je dla modelu:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Gdy jest włączone i myślenie jest aktywne, OpenClaw wysyła thinking: { type: "enabled", clear_thinking: false } i odtwarza wcześniejsze reasoning_content dla tego samego transkryptu zgodnego z OpenAI.Zaawansowani użytkownicy nadal mogą nadpisać dokładny ładunek providera za pomocą params.extra_body.thinking.
Dołączony Plugin Z.AI rejestruje rozumienie obrazów.
WłaściwośćWartość
Modelglm-4.6v
Rozumienie obrazów jest automatycznie rozwiązywane na podstawie skonfigurowanego uwierzytelniania Z.AI — nie jest potrzebna dodatkowa konfiguracja.
  • Z.AI używa uwierzytelniania Bearer z Twoim kluczem API.
  • Opcja onboardingu zai-api-key automatycznie wykrywa pasujący punkt końcowy Z.AI na podstawie prefiksu klucza.
  • Użyj jawnych opcji regionalnych (zai-coding-global, zai-coding-cn, zai-global, zai-cn), gdy chcesz wymusić konkretną powierzchnię API.

Powiązane

Rodzina modeli GLM

Przegląd rodziny modeli GLM.

Wybór modelu

Wybieranie providerów, odwołań do modeli i zachowania przełączania awaryjnego.