OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk 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 Uzupełnianie czatu Z.AI (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

Automatyczne wykrywanie punktu końcowego

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 prawidłowy bazowy adres URL.

  • Uruchom konfigurację początkową

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

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

    bash
    openclaw models list --all --provider zai

    • Jawnie określony regionalny punkt końcowy

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

  • Wybierz właściwą opcję konfiguracji początkowej

    bash
    # Coding Plan Global (zalecany 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 APIopenclaw 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

    bash
    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 końcowych, sprawdzając klucz w interfejsie API uzupełniania czatu każdego punktu końcowego. Najpierw sprawdzane są ogólne punkty końcowe (zai-global, a następnie zai-cn), później punkty końcowe Coding Plan (zai-coding-global, a następnie zai-coding-cn). Proces zatrzymuje się przy pierwszym punkcie końcowym, który zaakceptuje żądanie. Użyj jawnej opcji --auth-choice, aby wymusić punkt końcowy Coding Plan, jeśli klucz działa w obu przypadkach.

    Przykład konfiguracji

    json5
    {  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 używa 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 dostarcza swój katalog w manifeście Pluginu, dzięki czemu lista tylko do odczytu może wyświetlać znane pozycje GLM bez ładowania środowiska uruchomieniowego dostawcy:

    bash
    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

    Poziomy rozumowania

    GLM-5.2

    Pełny zakres: off, low, high, max (domyślnie off). OpenClaw mapuje low i high na poziom wysiłku rozumowania high w Z.AI, a max na poziom max w Z.AI, za pomocą pola reasoning_effort w ładunku żądania.

    Inne modele GLM

    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 ładunek żądania bez zmian (stosowane jest domyślne zachowanie rozumowania Z.AI).

    Ustawienie rozumowania na off zapobiega odpowiedziom, które wykorzystują budżet wyjściowy na reasoning_content przed wyświetleniem widocznego tekstu.

    Konfiguracja zaawansowana

    Przekazywanie nierozpoznanych modeli GLM-5

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

    Strumieniowanie wywołań narzędzi

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

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Zachowywanie rozumowania

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

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

    Po włączeniu, gdy rozumowanie jest aktywne, OpenClaw wysyła thinking: { type: "enabled", clear_thinking: false } i odtwarza wcześniejszą zawartość reasoning_content dla tej samej transkrypcji zgodnej z OpenAI. Klucz parametru preserve_thinking zapisany w konwencji snake_case również działa jako alias.

    Użytkownicy zaawansowani nadal mogą nadpisać dokładny ładunek dostawcy za pomocą params.extra_body.thinking.

    Rozpoznawanie obrazów

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

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

    Rozpoznawanie obrazów jest automatycznie ustalane na podstawie skonfigurowanego uwierzytelniania Z.AI — dodatkowa konfiguracja nie jest potrzebna.

    Szczegóły uwierzytelniania
    • Z.AI używa uwierzytelniania Bearer z kluczem API.
    • Opcja konfiguracji początkowej zai-api-key automatycznie wykrywa odpowiedni punkt końcowy Z.AI, sprawdzając obsługiwane punkty końcowe przy użyciu klucza.
    • Użyj jawnych opcji regionalnych (zai-coding-global, zai-coding-cn, zai-global, zai-cn), jeśli chcesz wymusić określony interfejs 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 materiały

    Wybór modelu

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

    Pełny schemat konfiguracji OpenClaw, w tym ustawienia dostawców i modeli.
    Was this useful?
    On this page

    On this page