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 — це API-платформа для моделей GLM. Вона надає REST API для GLM і використовує API-ключі для автентифікації. Створіть свій API-ключ у консолі Z.AI. OpenClaw використовує провайдера zai з API-ключем Z.AI.

Властивість Значення
Провайдер zai
Пакет @openclaw/zai-provider
Автентифікація ZAI_API_KEY (застарілий псевдонім: Z_AI_API_KEY)
API Z.AI Chat Completions (Bearer auth)

Моделі GLM

GLM — це сімейство моделей, а не окремий провайдер. В OpenClaw моделі GLM використовують посилання на кшталт zai/glm-5.2: провайдер zai, ідентифікатор моделі glm-5.2.

Початок роботи

Спершу встановіть Plugin провайдера:

bash
openclaw plugins install @openclaw/zai-provider

Автовиявлення кінцевої точки

Найкраще для: більшості користувачів. OpenClaw перевіряє підтримувані кінцеві точки Z.AI з вашим API-ключем і автоматично застосовує правильну базову URL-адресу.

  • Запустіть онбординг

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

  • Перевірте, що модель є у списку

    bash
    openclaw models list --all --provider zai

    • Явна регіональна кінцева точка

    Найкраще для: користувачів, які хочуть примусово задати конкретний Coding Plan або загальну поверхню API.

  • Виберіть правильний варіант онбордингу

    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

  • Перевірте, що модель є у списку

    bash
    openclaw models list --all --provider zai

    • Приклад конфігурації

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

    Вбудований каталог

    Plugin провайдера zai постачає свій каталог у маніфесті Plugin, тому список лише для читання може показувати відомі рядки GLM без завантаження runtime провайдера:

    bash
    openclaw models list --all --provider zai

    Каталог на основі маніфесту наразі містить:

    Посилання на модель Примітки
    zai/glm-5.2 Типовий Coding Plan; контекст 1M
    zai/glm-5.1 Типовий загальний 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

    Розширена конфігурація

    Пряме розвʼязання невідомих моделей GLM-5

    Невідомі ідентифікатори glm-5* і далі розвʼязуються вперед у шляху провайдера шляхом синтезування метаданих, що належать провайдеру, з шаблону glm-4.7, коли ідентифікатор відповідає поточній формі сімейства GLM-5.

    Потокова передача tool-call

    tool_stream увімкнено за замовчуванням для потокової передачі tool-call Z.AI. Щоб вимкнути її:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Мислення та збережене мислення

    Мислення Z.AI дотримується елементів керування /think OpenClaw. Коли мислення вимкнено, OpenClaw надсилає thinking: { type: "disabled" }, щоб уникнути відповідей, які витрачають бюджет виводу на reasoning_content перед видимим текстом.

    Збережене мислення є опціональним, бо Z.AI вимагає повторного відтворення повного історичного reasoning_content, що збільшує кількість токенів підказки. Увімкніть його для окремої моделі:

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

    Коли це ввімкнено і мислення активне, OpenClaw надсилає thinking: { type: "enabled", clear_thinking: false } і повторно відтворює попередній reasoning_content для тієї самої OpenAI-сумісної розмови.

    Досвідчені користувачі все ще можуть перевизначити точне навантаження провайдера за допомогою params.extra_body.thinking.

    Розуміння зображень

    Plugin Z.AI реєструє розуміння зображень.

    Властивість Значення
    Модель glm-4.6v

    Розуміння зображень автоматично розвʼязується з налаштованої автентифікації Z.AI — жодна додаткова конфігурація не потрібна.

    Деталі автентифікації
    • Z.AI використовує Bearer auth із вашим API-ключем.
    • Варіант онбордингу zai-api-key автоматично визначає відповідну кінцеву точку Z.AI, перевіряючи підтримувані кінцеві точки з вашим ключем.
    • Використовуйте явні регіональні варіанти (zai-coding-global, zai-coding-cn, zai-global, zai-cn), коли хочете примусово задати конкретну поверхню API.
    • Застаріла змінна середовища Z_AI_API_KEY усе ще приймається; OpenClaw копіює її в ZAI_API_KEY під час запуску, якщо ZAI_API_KEY не встановлено.

    Пов’язане

    Вибір моделі

    Вибір провайдерів, посилань на моделі та поведінки перемикання в разі відмови.
    Довідник із конфігурації

    Повна схема конфігурації OpenClaw, включно з налаштуваннями провайдера та моделі.
    Was this useful?
    On this page

    On this page