Z.AI

Z.AI to platforma API dla modeli GLM. Udostępnia interfejsy REST API dla GLM i wykorzystuje klucze API do uwierzytelniania. Klucz API należy utworzyć w konsoli Z.AI. OpenClaw używa dostawcy zai z kluczem API Z.AI.

Właściwość	Wartość
Dostawca	`zai`
Pakiet	`@openclaw/zai-provider`
Uwierzytelnianie	`ZAI_API_KEY` (starszy alias: `Z_AI_API_KEY`)
API	Z.AI Chat Completions (uwierzytelnianie Bearer)

Modele GLM

GLM to rodzina modeli, a nie osobny dostawca. W OpenClaw modele GLM używają odwołań takich jak zai/glm-5.2: dostawca zai, identyfikator modelu glm-5.2.

Pierwsze kroki

Najpierw należy zainstalować Plugin dostawcy:

openclaw plugins install @openclaw/zai-provider

Automatyczne wykrywanie punktu końcowego
Jawny regionalny punkt końcowy

Najlepsze dla: większości użytkowników. OpenClaw sprawdza obsługiwane punkty końcowe Z.AI przy użyciu klucza API i automatycznie stosuje prawidłowy bazowy adres URL.

Uruchom konfigurację początkową

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

Sprawdź, czy model znajduje się na liście

openclaw models list --all --provider zai

Najlepsze dla: użytkowników, którzy chcą wymusić określony interfejs Coding Plan lub ogólny interfejs API.

Wybierz odpowiednią opcję konfiguracji początkowej

# Coding Plan Global (zalecane dla użytkowników Coding Plan)
openclaw onboard --auth-choice zai-coding-global

# Coding Plan CN (region Chin)
openclaw onboard --auth-choice zai-coding-cn

# Ogólne API
openclaw onboard --auth-choice zai-global

# Ogólne API CN (region Chin)
openclaw onboard --auth-choice zai-cn

Sprawdź, czy model znajduje się na liście

openclaw models list --all --provider zai

Punkty końcowe

Opcja konfiguracji początkowej	Bazowy adres URL	Model domyślny
`zai-global`	`https://api.z.ai/api/paas/v4`	`glm-5.1`
`zai-cn`	`https://open.bigmodel.cn/api/paas/v4`	`glm-5.1`
`zai-coding-global`	`https://api.z.ai/api/coding/paas/v4`	`glm-5.2`
`zai-coding-cn`	`https://open.bigmodel.cn/api/coding/paas/v4`	`glm-5.2`

zai-api-key automatycznie wykrywa jeden z tych czterech punktów, testując klucz względem interfejsu API uzupełnień czatu każdego punktu końcowego. Najpierw sprawdza ogólne punkty końcowe (zai-global, następnie zai-cn), a później punkty końcowe Coding Plan (zai-coding-global, następnie zai-coding-cn) i zatrzymuje się na pierwszym punkcie końcowym, który zaakceptuje żądanie. Aby wymusić punkt końcowy Coding Plan, gdy klucz działa z obydwoma, należy użyć jawnej opcji --auth-choice.

Limity szybkości i przeciążenia

Z.AI opisuje Coding Plan oraz narzędzia agentowe ogólnego przeznaczenia jako usługi z zarządzaną przepustowością. Według dokumentacji Z.AI:

Narzędzia agentowe ogólnego przeznaczenia, w tym OpenClaw, są udostępniane na zasadzie najlepszych starań. Przy dużym obciążeniu wnioskowania, zazwyczaj około 2–6 PM czasu singapurskiego, niektóre żądania mogą podlegać tymczasowym limitom szybkości.
Limity szybkości i współbieżności Coding Plan są powiązane z poziomem planu i mogą być dynamicznie dostosowywane na podstawie dostępności zasobów. Poza godzinami szczytu współbieżność może być wyższa.
Kod błędu API 1302 oznacza „Osiągnięto limit szybkości żądań”. Kod błędu API 1305 oznacza „Usługa może być tymczasowo przeciążona, spróbuj ponownie później”.

Jeśli w okresie dużego obciążenia pojawi się tymczasowa odpowiedź 429 lub 1305, należy odczekać i ponowić żądanie. Jeśli błędy powtarzają się poza godzinami szczytu lub występują tylko dla jednego punktu końcowego, modelu albo postaci żądania, należy najpierw sprawdzić skonfigurowany punkt końcowy i model:

openclaw models list --all --provider zai
openclaw config get models.providers.zai.baseUrl

Klucze Coding Plan powinny używać punktu końcowego Coding Plan, takiego jak https://api.z.ai/api/coding/paas/v4; klucze ogólnego API powinny używać punktu końcowego ogólnego API, takiego jak https://api.z.ai/api/paas/v4. Utrzymujące się błędy przy tym samym kluczu i punkcie końcowym mogą wskazywać na odrzucenie po stronie dostawcy lub ograniczenie planu, a nie na zwykłe ograniczanie przepustowości podczas szczytowego obciążenia.

Przykład konfiguracji

zai-api-key umożliwia OpenClaw wykrycie pasującego punktu końcowego Z.AI na podstawie klucza i automatyczne zastosowanie prawidłowego bazowego adresu URL. Jawnych opcji regionalnych należy używać, aby wymusić określony interfejs Coding Plan lub ogólny interfejs API.

{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 korzysta z punktu końcowego Coding Plan.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

Wbudowany katalog

Plugin dostawcy zai udostępnia swój katalog w manifeście pluginu, dzięki czemu lista tylko do odczytu może wyświetlać znane wiersze GLM bez ładowania środowiska wykonawczego dostawcy:

openclaw models list --all --provider zai

Katalog oparty na manifeście obejmuje obecnie:

Odwołanie do modelu	Uwagi
`zai/glm-5.2`	Domyślny dla Coding Plan; kontekst 1M
`zai/glm-5.1`	Domyślny dla ogólnego API
`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).

Konfiguracja Coding Plan domyślnie używa zai/glm-5.2; konfiguracja ogólnego API zachowuje zai/glm-5.1. W punktach końcowych Coding Plan automatyczne wykrywanie przełącza się kolejno na glm-5.1, a następnie glm-4.7, gdy klucz lub plan nie udostępnia GLM-5.2. Wersje i dostępność GLM mogą się zmieniać; uruchom openclaw models list --all --provider zai, aby wyświetlić katalog znany zainstalowanej wersji.

Poziomy rozumowania

GLM-5.2
Inne modele GLM

Pełny zakres: off, low, high, max (domyślnie off). OpenClaw mapuje low i high na poziom intensywności rozumowania high w Z.AI, a max na poziom max w Z.AI za pośrednictwem reasoning_effort w danych żądania.

Dostępny jest tylko przełącznik binarny: off i low (wyświetlane jako on w selektorach), domyślnie off. Ustawienie rozumowania na off wysyła thinking: { type: "disabled" }; każdy inny poziom pozostawia dane żądania bez zmian (obowiązuje domyślne zachowanie rozumowania Z.AI).

Ustawienie rozumowania na off pozwala uniknąć odpowiedzi, które zużywają budżet wyjściowy na reasoning_content przed wyświetleniem widocznego tekstu.

Konfiguracja zaawansowana

Przekazywanie nierozpoznanych modeli GLM-5

Nieznane identyfikatory glm-5* są nadal przekazywane w ścieżce dostawcy przez syntezowanie metadanych należących do dostawcy na podstawie szablonu glm-4.7, gdy identyfikator odpowiada bieżącemu formatowi rodziny GLM-5.

Strumieniowanie wywołań narzędzi

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 },
        },
      },
    },
  },
}

Zachowane rozumowanie

Zachowywanie rozumowania jest opcjonalne, ponieważ Z.AI wymaga ponownego odtworzenia pełnej historycznej wartości reasoning_content, co zwiększa liczbę tokenów promptu. Włącz je osobno dla każdego modelu:

{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}

Po włączeniu tej opcji i rozumowania OpenClaw wysyła thinking: { type: "enabled", clear_thinking: false } i ponownie odtwarza wcześniejsze reasoning_content dla tej samej transkrypcji zgodnej z OpenAI. Klucz parametru preserve_thinking zapisany w notacji snake_case działa jako alias.Użytkownicy zaawansowani mogą nadal nadpisać dokładne dane dostawcy za pomocą params.extra_body.thinking.

Rozumienie obrazów

Plugin Z.AI rejestruje funkcję rozumienia obrazów.

Właściwość	Wartość
Model	`glm-4.6v`

Rozumienie obrazów jest automatycznie określane na podstawie skonfigurowanego uwierzytelniania Z.AI — dodatkowa konfiguracja nie jest potrzebna.

Szczegóły uwierzytelniania

Z.AI używa uwierzytelniania Bearer z kluczem API.
Opcja wdrażania zai-api-key automatycznie wykrywa odpowiedni punkt końcowy Z.AI, sondując obsługiwane punkty końcowe za pomocą klucza.
Aby wymusić określony interfejs API, użyj jawnych opcji regionalnych (zai-coding-global, zai-coding-cn, zai-global, zai-cn).
Starsza zmienna środowiskowa Z_AI_API_KEY jest nadal akceptowana; OpenClaw podczas uruchamiania kopiuje ją do ZAI_API_KEY, jeśli ZAI_API_KEY nie jest ustawiona.

Powiązane

Wybór modelu

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

Dokumentacja konfiguracji

Pełny schemat konfiguracji OpenClaw, w tym ustawienia dostawców i modeli.

Overview

Concepts and configuration

Providers

Modele GLM

Pierwsze kroki

Punkty końcowe

Limity szybkości i przeciążenia

Przykład konfiguracji

Wbudowany katalog

Poziomy rozumowania

Konfiguracja zaawansowana

Powiązane

Wybór modelu

Dokumentacja konfiguracji

​Modele GLM

​Pierwsze kroki

​Punkty końcowe

​Limity szybkości i przeciążenia

​Przykład konfiguracji

​Wbudowany katalog

​Poziomy rozumowania

​Konfiguracja zaawansowana

​Powiązane

Wybór modelu

Dokumentacja konfiguracji

Modele GLM

Pierwsze kroki

Punkty końcowe

Limity szybkości i przeciążenia

Przykład konfiguracji

Wbudowany katalog

Poziomy rozumowania

Konfiguracja zaawansowana

Powiązane