Ana içeriğe atla
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.
ÖzellikDeğer
Sağlayıcızai
Paket@openclaw/zai-provider
Kimlik doğrulamaZAI_API_KEY (eski takma ad: Z_AI_API_KEY)
APIZ.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: 
openclaw plugins install @openclaw/zai-provider
Ş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.
1

Run onboarding

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

Verify the model is listed

openclaw models list --all --provider zai

​
Yapılandırma örneği

zai-api-key, OpenClaw’un anahtardan eşleşen Z.AI uç noktasını algılamasını ve doğru temel URL’yi otomatik olarak uygulamasını sağlar. Belirli bir Coding Plan’ı veya genel API yüzeyini zorlamak istediğinizde açık bölgesel seçimleri kullanın.
{
  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: 
openclaw models list --all --provider zai
Bildirim destekli katalog şu anda şunları içerir:
Model ref’iNotlar
zai/glm-5.2Coding Plan varsayılanı; 1M bağlam
zai/glm-5.1Genel 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
GLM modelleri zai/<model> olarak kullanılabilir (örnek: zai/glm-5).
GLM-5.2, off, low, high ve max düşünme seviyelerini destekler. OpenClaw, low ve high değerlerini Z.AI yüksek akıl yürütme çabasına, max değerini ise en yüksek çabaya eşler.
Coding Plan kurulumu varsayılan olarak zai/glm-5.2 kullanır; genel API kurulumu zai/glm-5.1 değerini korur. Uç nokta otomatik algılama, seçili plan GLM-5.2’yi sunmadığında glm-5.1 veya glm-4.7 değerine geri döner. GLM sürümleri ve kullanılabilirliği değişebilir; yüklü sürümünüzün bildiği kataloğu görmek için openclaw models list --all --provider zai komutunu çalıştırın.

​
Gelişmiş yapılandırma

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.
Z.AI araç çağrısı akışı için tool_stream varsayılan olarak etkindir. Devre dışı bırakmak için:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
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:
{
  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.
Z.AI Plugin’i görüntü anlama özelliğini kaydeder.
ÖzellikDeğer
Modelglm-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.
  • 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ı.