Przejdź do głównej treści
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 dostawcy zai z kluczem API Z.AI.
WłaściwośćWartość
Dostawcazai
Pakiet@openclaw/zai-provider
UwierzytelnianieZAI_API_KEY (starszy alias: Z_AI_API_KEY)
APIZ.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 zainstaluj Plugin dostawcy: 
openclaw plugins install @openclaw/zai-provider
Najlepsze dla: większości użytkowników. OpenClaw sprawdza obsługiwane punkty końcowe Z.AI przy użyciu Twojego klucza API i automatycznie stosuje poprawny bazowy URL.
1

Run onboarding

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

Verify the model is listed

openclaw models list --all --provider zai

​
Przykład konfiguracji

zai-api-key pozwala OpenClaw wykryć pasujący punkt końcowy Z.AI na podstawie klucza i automatycznie zastosować poprawny bazowy URL. Użyj jawnych wyborów regionalnych, gdy chcesz wymusić określony Coding Plan lub ogólną powierzchnię API.
{
  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" } } },
}

​
Wbudowany katalog

Plugin dostawcy zai dostarcza swój katalog w manifeście Pluginu, więc lista tylko do odczytu może pokazywać znane wiersze GLM bez ładowania środowiska uruchomieniowego dostawcy: 
openclaw models list --all --provider zai
Katalog oparty na manifeście obecnie obejmuje:
Odwołanie modeluUwagi
zai/glm-5.2Domyślny Coding Plan; kontekst 1M
zai/glm-5.1Domyślne ogólne 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).
GLM-5.2 obsługuje poziomy myślenia off, low, high i max. OpenClaw mapuje low i high na wysoki wysiłek rozumowania Z.AI, a max na maksymalny wysiłek.
Konfiguracja Coding Plan domyślnie używa zai/glm-5.2; konfiguracja ogólnego API zachowuje zai/glm-5.1. Automatyczne wykrywanie punktu końcowego wraca do glm-5.1 lub glm-4.7, gdy wybrany plan nie udostępnia GLM-5.2. Wersje i dostępność GLM mogą się zmieniać; uruchom openclaw models list --all --provider zai, aby zobaczyć katalog znany Twojej zainstalowanej wersji.

​
Konfiguracja zaawansowana

Nieznane identyfikatory glm-5* nadal są rozwiązywane naprzód na ścieżce dostawcy przez syntetyzowanie metadanych należących do dostawcy 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 działa zgodnie z kontrolkami OpenClaw /think. 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 w prompcie. Włącz je dla modelu:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          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 dostawcy za pomocą params.extra_body.thinking.
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.
  • Wybór onboardingu zai-api-key automatycznie wykrywa pasujący punkt końcowy Z.AI, sprawdzając obsługiwane punkty końcowe za pomocą Twojego klucza.
  • Użyj jawnych wyborów regionalnych (zai-coding-global, zai-coding-cn, zai-global, zai-cn), gdy chcesz wymusić określoną powierzchnię API.
  • Starsza zmienna środowiskowa Z_AI_API_KEY jest nadal akceptowana; OpenClaw kopiuje ją do ZAI_API_KEY podczas uruchamiania, jeśli ZAI_API_KEY nie jest ustawiona.

​
Powiązane

Model selection

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

Configuration reference

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