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, GLM modelleri için API platformudur. GLM için REST API'leri sağlar ve kimlik doğrulama için API anahtarları kullanır. API anahtarınızı Z.AI konsolunda oluşturun. OpenClaw, Z.AI API anahtarıyla zai sağlayıcısını kullanır.

Özellik Değer
Sağlayıcı zai
Paket @openclaw/zai-provider
Kimlik doğrulama ZAI_API_KEY (eski takma ad: Z_AI_API_KEY)
API Z.AI Chat Completions (Bearer kimlik doğrulaması)

GLM modelleri

GLM ayrı bir sağlayıcı değil, bir model ailesidir. OpenClaw'da GLM modelleri zai/glm-5.2 gibi ref'ler kullanır: sağlayıcı zai, model kimliği glm-5.2.

Başlarken

Önce sağlayıcı Plugin'ini yükleyin:

bash
openclaw plugins install @openclaw/zai-provider

Auto-detect endpoint

Şunlar için en iyi: çoğu kullanıcı. OpenClaw, API anahtarınızla desteklenen Z.AI uç noktalarını yoklar ve doğru temel URL'yi otomatik olarak uygular.

  • 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

    Şunlar için en iyi: belirli bir Coding Plan'ı veya genel API yüzeyini zorlamak isteyen kullanıcılar.

  • 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

    • Yapılandırma örneği

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

    Yerleşik katalog

    zai sağlayıcı Plugin'i kataloğunu Plugin bildiriminde gönderir, böylece salt okunur listeleme, sağlayıcı çalışma zamanını yüklemeden bilinen GLM satırlarını gösterebilir:

    bash
    openclaw models list --all --provider zai

    Bildirim destekli katalog şu anda şunları içerir:

    Model ref'i Notlar
    zai/glm-5.2 Coding Plan varsayılanı; 1M bağlam
    zai/glm-5.1 Genel API varsayılanı
    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

    Gelişmiş yapılandırma

    Forward-resolving unknown GLM-5 models

    Bilinmeyen glm-5* kimlikleri, kimlik geçerli GLM-5 ailesi şekliyle eşleştiğinde glm-4.7 şablonundan sağlayıcıya ait meta veriler sentezlenerek sağlayıcı yolunda yine ileriye dönük çözümlenir.

    Tool-call streaming

    Z.AI araç çağrısı akışı için tool_stream varsayılan olarak etkindir. Devre dışı bırakmak için:

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

    Z.AI düşünmesi, OpenClaw'un /think denetimlerini izler. Düşünme kapalıyken OpenClaw, görünür metinden önce çıktı bütçesini reasoning_content üzerinde harcayan yanıtları önlemek için thinking: { type: "disabled" } gönderir.

    Korunmuş düşünme isteğe bağlıdır, çünkü Z.AI tam geçmiş reasoning_content içeriğinin yeniden oynatılmasını gerektirir; bu da istem token'larını artırır. Bunu model başına etkinleştirin:

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

    Etkinleştirildiğinde ve düşünme açıkken OpenClaw thinking: { type: "enabled", clear_thinking: false } gönderir ve aynı OpenAI uyumlu transkript için önceki reasoning_content içeriğini yeniden oynatır.

    Gelişmiş kullanıcılar, tam sağlayıcı yükünü yine params.extra_body.thinking ile geçersiz kılabilir.

    Image understanding

    Z.AI Plugin'i görüntü anlama özelliğini kaydeder.

    Özellik Değer
    Model glm-4.6v

    Görüntü anlama, yapılandırılmış Z.AI kimlik doğrulamasından otomatik olarak çözümlenir; ek yapılandırma gerekmez.

    Auth details
    • Z.AI, API anahtarınızla Bearer kimlik doğrulaması kullanır.
    • zai-api-key ilk kurulum seçimi, desteklenen uç noktaları anahtarınızla yoklayarak eşleşen Z.AI uç noktasını otomatik algılar.
    • Belirli bir API yüzeyini zorlamak istediğinizde açık bölgesel seçimleri (zai-coding-global, zai-coding-cn, zai-global, zai-cn) kullanın.
    • Eski ortam değişkeni Z_AI_API_KEY hâlâ kabul edilir; ZAI_API_KEY ayarlanmamışsa OpenClaw başlangıçta onu ZAI_API_KEY değerine kopyalar.

    İlgili

    Model selection

    Sağlayıcıları, model ref'lerini ve yük devretme davranışını seçme.
    Configuration reference

    Sağlayıcı ve model ayarları dahil tam OpenClaw yapılandırma şeması.
    Was this useful?
    On this page

    On this page