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 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:

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

    • Jawny regionalny punkt końcowy

    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

    bash
    # 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 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, 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:

    bash
    openclaw models list --all --provider zaiopenclaw 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

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

    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 intensywności rozumowania high w Z.AI, a max na poziom max w Z.AI za pośrednictwem reasoning_effort w danych żądania.

    Inne modele GLM

    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ć:

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

    json5
    {  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.
    Was this useful?
    On this page

    On this page