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 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 penyedia zai dengan kunci API Z.AI.

Properti Nilai
Penyedia zai
Paket @openclaw/zai-provider
Autentikasi ZAI_API_KEY (alias lama: Z_AI_API_KEY)
API Z.AI Chat Completions (autentikasi Bearer)

Model GLM

GLM adalah keluarga model, bukan penyedia terpisah. Di OpenClaw, model GLM menggunakan referensi seperti zai/glm-5.2: penyedia zai, ID model glm-5.2.

Memulai

Instal Plugin penyedia terlebih dahulu:

bash
openclaw plugins install @openclaw/zai-provider

Deteksi otomatis endpoint

Paling cocok untuk: sebagian besar pengguna. OpenClaw memeriksa endpoint Z.AI yang didukung menggunakan kunci API Anda dan menerapkan URL dasar yang benar secara otomatis.

  • Jalankan orientasi awal

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

  • Pastikan model tercantum

    bash
    openclaw models list --all --provider zai

    • Endpoint regional eksplisit

    Paling cocok untuk: pengguna yang ingin memaksakan Coding Plan tertentu atau antarmuka API umum.

  • Pilih opsi orientasi awal yang tepat

    bash
    # Coding Plan Global (direkomendasikan untuk pengguna Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (wilayah Tiongkok)openclaw onboard --auth-choice zai-coding-cn # API umumopenclaw onboard --auth-choice zai-global # API umum CN (wilayah Tiongkok)openclaw onboard --auth-choice zai-cn

  • Pastikan model tercantum

    bash
    openclaw models list --all --provider zai

    • Endpoint

    Opsi orientasi awal URL dasar Model bawaan
    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 mendeteksi otomatis salah satu dari keempat endpoint ini dengan menguji kunci Anda pada API chat-completions setiap endpoint, memeriksa endpoint umum (zai-global, lalu zai-cn) sebelum endpoint Coding Plan (zai-coding-global, lalu zai-coding-cn), dan berhenti pada endpoint pertama yang menerima permintaan. Gunakan --auth-choice eksplisit untuk memaksakan endpoint Coding Plan jika kunci Anda berfungsi pada keduanya.

    Contoh konfigurasi

    json5
    {  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 menggunakan endpoint Coding Plan.        baseUrl: "https://api.z.ai/api/coding/paas/v4",      },    },  },  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}

    Katalog bawaan

    Plugin penyedia zai menyertakan katalognya dalam manifes Plugin, sehingga daftar hanya-baca dapat menampilkan baris GLM yang dikenal tanpa memuat runtime penyedia:

    bash
    openclaw models list --all --provider zai

    Katalog berbasis manifes saat ini mencakup:

    Referensi model Catatan
    zai/glm-5.2 Bawaan Coding Plan; konteks 1 juta
    zai/glm-5.1 Bawaan API umum
    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

    Tingkat penalaran

    GLM-5.2

    Rentang lengkap: off, low, high, max (bawaan off). OpenClaw memetakan low dan high ke upaya penalaran high milik Z.AI, serta max ke upaya max milik Z.AI, melalui reasoning_effort pada muatan permintaan.

    Model GLM lainnya

    Hanya sakelar biner: off dan low (ditampilkan sebagai on dalam pemilih), dengan bawaan off. Mengatur penalaran ke off akan mengirim thinking: { type: "disabled" }; tingkat lainnya tidak mengubah muatan permintaan (perilaku penalaran bawaan milik Z.AI akan diterapkan).

    Mengatur penalaran ke off mencegah respons menghabiskan anggaran keluaran untuk reasoning_content sebelum teks yang terlihat.

    Konfigurasi lanjutan

    Resolusi maju model GLM-5 yang tidak dikenal

    ID glm-5* yang tidak dikenal tetap diresolusikan ke depan pada jalur penyedia dengan menyintesis metadata milik penyedia dari templat glm-4.7 ketika ID tersebut cocok dengan bentuk keluarga GLM-5 saat ini.

    Streaming pemanggilan alat

    tool_stream diaktifkan secara bawaan untuk streaming pemanggilan alat Z.AI. Untuk menonaktifkannya:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Penalaran yang dipertahankan

    Penalaran yang dipertahankan bersifat opsional karena Z.AI mengharuskan seluruh riwayat reasoning_content diputar ulang, yang meningkatkan jumlah token prompt. Aktifkan per model:

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

    Saat diaktifkan dan penalaran menyala, OpenClaw mengirim thinking: { type: "enabled", clear_thinking: false } dan memutar ulang reasoning_content sebelumnya untuk transkrip kompatibel OpenAI yang sama. Kunci parameter snake_case preserve_thinking berfungsi sebagai alias.

    Pengguna tingkat lanjut tetap dapat mengganti muatan penyedia secara persis dengan params.extra_body.thinking.

    Pemahaman gambar

    Plugin Z.AI mendaftarkan kemampuan pemahaman gambar.

    Properti Nilai
    Model glm-4.6v

    Pemahaman gambar diresolusikan secara otomatis dari autentikasi Z.AI yang dikonfigurasi—tidak diperlukan konfigurasi tambahan.

    Detail autentikasi
    • Z.AI menggunakan autentikasi Bearer dengan kunci API Anda.
    • Opsi orientasi awal zai-api-key mendeteksi otomatis endpoint Z.AI yang cocok dengan menguji endpoint yang didukung menggunakan kunci Anda.
    • Gunakan pilihan regional eksplisit (zai-coding-global, zai-coding-cn, zai-global, zai-cn) saat Anda ingin memaksakan antarmuka API tertentu.
    • Variabel lingkungan lama Z_AI_API_KEY tetap diterima; OpenClaw menyalinnya ke ZAI_API_KEY saat dimulai jika ZAI_API_KEY belum ditetapkan.

    Terkait

    Pemilihan model

    Memilih penyedia, referensi model, dan perilaku failover.
    Referensi konfigurasi

    Skema konfigurasi lengkap OpenClaw, termasuk pengaturan penyedia dan model.
    Was this useful?
    On this page

    On this page