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, GLM modelleri için API platformudur. GLM için REST API'leri sağlar ve kimlik doğrulama amacıyla API anahtarlarını kullanır. API anahtarınızı Z.AI konsolunda oluşturun. OpenClaw, bir 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 Sohbet Tamamlamaları (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 başvurular kullanır: sağlayıcı zai, model kimliği glm-5.2.

Başlarken

Önce sağlayıcı pluginini yükleyin:

bash
openclaw plugins install @openclaw/zai-provider

Uç noktayı otomatik algıla

En uygun olduğu kullanıcılar: çoğu kullanıcı. OpenClaw, API anahtarınızla desteklenen Z.AI uç noktalarını sınar ve doğru temel URL'yi otomatik olarak uygular.

  • İlk kurulumu çalıştırın

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

  • Modelin listelendiğini doğrulayın

    bash
    openclaw models list --all --provider zai

    • Bölgesel uç noktayı açıkça belirt

    En uygun olduğu kullanıcılar: belirli bir Coding Plan veya genel API yüzeyini zorunlu kılmak isteyen kullanıcılar.

  • Doğru ilk kurulum seçeneğini belirleyin

    bash
    # Coding Plan Global (Coding Plan kullanıcıları için önerilir)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (Çin bölgesi)openclaw onboard --auth-choice zai-coding-cn # Genel APIopenclaw onboard --auth-choice zai-global # Genel API CN (Çin bölgesi)openclaw onboard --auth-choice zai-cn

  • Modelin listelendiğini doğrulayın

    bash
    openclaw models list --all --provider zai

    • Uç noktalar

    İlk kurulum seçeneği Temel URL Varsayılan model
    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, anahtarınızı her uç noktanın sohbet tamamlama API'sinde sınayarak, önce genel uç noktaları (zai-global, ardından zai-cn), sonra Coding Plan uç noktalarını (zai-coding-global, ardından zai-coding-cn) kontrol eder ve isteği kabul eden ilk uç noktada durarak bu dört seçenekten birini otomatik algılar. Anahtarınız her ikisinde de çalışıyorsa bir Coding Plan uç noktasını zorunlu kılmak için açık bir --auth-choice kullanın.

    Yapılandırma örneği

    json5
    {  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2, Coding Plan uç noktasını kullanır.        baseUrl: "https://api.z.ai/api/coding/paas/v4",      },    },  },  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}

    Yerleşik katalog

    zai sağlayıcı plugini, kataloğunu plugin bildiriminde sunar; 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

    Bildirime dayalı katalog şu anda şunları içerir:

    Model başvurusu 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

    Düşünme düzeyleri

    GLM-5.2

    Tam aralık: off, low, high, max (varsayılan off). OpenClaw, istek yükündeki reasoning_effort aracılığıyla low ve high düzeylerini Z.AI'ın high akıl yürütme çabasına, max düzeyini ise Z.AI'ın max çabasına eşler.

    Diğer GLM modelleri

    Yalnızca ikili geçiş: off ve low (seçicilerde on olarak gösterilir); varsayılan off. Düşünmeyi off olarak ayarlamak thinking: { type: "disabled" } gönderir; diğer düzeyler istek yükünü değiştirmeden bırakır (Z.AI'ın kendi varsayılan akıl yürütme davranışı uygulanır).

    Düşünmeyi off olarak ayarlamak, görünür metinden önce çıktı bütçesini reasoning_content için harcayan yanıtları önler.

    Gelişmiş yapılandırma

    Bilinmeyen GLM-5 modellerini ileriye dönük çözümleme

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

    Araç çağrısı akışı

    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 },        },      },    },  },}
    Korunan düşünme

    Z.AI, geçmişteki reasoning_content içeriğinin tamamının yeniden oynatılmasını gerektirdiğinden ve bu işlem istem belirteçlerini artırdığından, korunan düşünme açıkça etkinleştirilmelidir. 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. Alt çizgili preserve_thinking parametre anahtarı da takma ad olarak çalışır.

    İleri düzey kullanıcılar, sağlayıcı yükünü tam olarak params.extra_body.thinking ile geçersiz kılmaya devam edebilir.

    Görüntü anlama

    Z.AI plugini görüntü anlamayı 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.

    Kimlik doğrulama ayrıntıları
    • Z.AI, API anahtarınızla Bearer kimlik doğrulaması kullanır.
    • zai-api-key ilk kurulum seçeneği, anahtarınızla desteklenen uç noktaları sınayarak eşleşen Z.AI uç noktasını otomatik olarak algılar.
    • Belirli bir API yüzeyini zorunlu kılmak istediğinizde açık bölgesel seçenekleri (zai-coding-global, zai-coding-cn, zai-global, zai-cn) kullanın.
    • Eski Z_AI_API_KEY ortam değişkeni hâlâ kabul edilir; ZAI_API_KEY ayarlanmamışsa OpenClaw başlangıçta bunu ZAI_API_KEY değişkenine kopyalar.

    İlgili konular

    Model seçimi

    Sağlayıcıları, model başvurularını ve yük devretme davranışını seçme.
    Yapılandırma başvurusu

    Sağlayıcı ve model ayarları dâhil eksiksiz OpenClaw yapılandırma şeması.
    Was this useful?
    On this page

    On this page