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 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ść
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 zainstaluj Plugin dostawcy:

bash
openclaw plugins install @openclaw/zai-provider

Auto-detect endpoint

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.

  • Run onboarding

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

  • Verify the model is listed

    bash
    openclaw models list --all --provider zai

    • Explicit regional endpoint

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

  • Pick the right onboarding choice

    bash
    # Coding Plan Global (recommended for Coding Plan users)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (China region)openclaw onboard --auth-choice zai-coding-cn # General APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cn

  • Verify the model is listed

    bash
    openclaw models list --all --provider zai

    • Przykład konfiguracji

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

    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:

    bash
    openclaw models list --all --provider zai

    Katalog oparty na manifeście obecnie obejmuje:

    Odwołanie modelu Uwagi
    zai/glm-5.2 Domyślny Coding Plan; kontekst 1M
    zai/glm-5.1 Domyś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

    Konfiguracja zaawansowana

    Forward-resolving unknown GLM-5 models

    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-call streaming

    tool_stream jest domyślnie włączone dla strumieniowania wywołań narzędzi Z.AI. Aby je wyłączyć:

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

    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:

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

    Image understanding

    Plugin Z.AI rejestruje rozumienie obrazów.

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

    Rozumienie obrazów jest automatycznie rozwiązywane na podstawie skonfigurowanego uwierzytelniania Z.AI — nie jest potrzebna dodatkowa konfiguracja.

    Auth details
    • 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.
    Was this useful?
    On this page

    On this page