Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Z.AI adalah platform API untuk model GLM. Platform ini menyediakan API REST untuk GLM dan menggunakan kunci API untuk autentikasi. Buat kunci API Anda di konsol Z.AI. OpenClaw menggunakan provider zai dengan kunci API Z.AI.
  • Provider: zai
  • Autentikasi: ZAI_API_KEY
  • API: Chat Completions Z.AI (autentikasi Bearer)

​
Memulai

Paling cocok untuk: sebagian besar pengguna. OpenClaw mendeteksi endpoint Z.AI yang sesuai dari kunci dan menerapkan URL dasar yang benar secara otomatis.
1

Run onboarding

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

Set a default model

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

Verify the model is listed

openclaw models list --all --provider zai

​
Katalog bawaan

OpenClaw menyertakan katalog provider zai terpaket di manifest Plugin, sehingga pencantuman hanya-baca dapat menampilkan baris GLM yang dikenal tanpa memuat runtime provider: 
openclaw models list --all --provider zai
Katalog berbasis manifest saat ini mencakup:
Ref modelCatatan
zai/glm-5.1Model default
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
Model GLM tersedia sebagai zai/<model> (contoh: zai/glm-5). Ref model bawaan default adalah zai/glm-5.1.

​
Konfigurasi lanjutan

Id glm-5* yang tidak dikenal tetap di-resolve ke depan pada jalur provider terpaket dengan menyintesis metadata milik provider dari templat glm-4.7 saat id tersebut cocok dengan bentuk keluarga GLM-5 saat ini.
tool_stream diaktifkan secara default untuk streaming tool-call Z.AI. Untuk menonaktifkannya:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Thinking Z.AI mengikuti kontrol /think OpenClaw. Dengan thinking nonaktif, OpenClaw mengirim thinking: { type: "disabled" } untuk menghindari respons yang menghabiskan anggaran keluaran pada reasoning_content sebelum teks yang terlihat.Thinking yang dipertahankan bersifat opt-in karena Z.AI mewajibkan seluruh riwayat reasoning_content diputar ulang, yang meningkatkan token prompt. Aktifkan per model:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Saat diaktifkan dan thinking aktif, OpenClaw mengirim thinking: { type: "enabled", clear_thinking: false } dan memutar ulang reasoning_content sebelumnya untuk transkrip kompatibel OpenAI yang sama.Pengguna tingkat lanjut tetap dapat mengganti payload provider persisnya dengan params.extra_body.thinking.
Plugin Z.AI terpaket mendaftarkan pemahaman gambar.
PropertiNilai
Modelglm-4.6v
Pemahaman gambar di-resolve otomatis dari autentikasi Z.AI yang dikonfigurasi — tidak diperlukan konfigurasi tambahan.
  • Z.AI menggunakan autentikasi Bearer dengan kunci API Anda.
  • Pilihan onboarding zai-api-key otomatis mendeteksi endpoint Z.AI yang sesuai dari prefiks kunci.
  • Gunakan pilihan regional eksplisit (zai-coding-global, zai-coding-cn, zai-global, zai-cn) saat Anda ingin memaksa permukaan API tertentu.

​
Terkait

GLM model family

Ikhtisar keluarga model untuk GLM.

Model selection

Memilih provider, ref model, dan perilaku failover.