---
read_when:
    - Anda ingin model Z.AI / GLM di OpenClaw
    - Anda memerlukan penyiapan ZAI_API_KEY yang sederhana
summary: Gunakan Z.AI (model GLM) dengan OpenClaw
title: Z.AI
x-i18n:
    generated_at: "2026-07-12T14:38:08Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: ab29149da39cbf82fe041ea5932a860c461320e14bf26f83f69060d7ae0ae00a
    source_path: providers/zai.md
    workflow: 16
---

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
```

<Tabs>
  <Tab title="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.

    <Steps>
      <Step title="Jalankan orientasi awal">
        ```bash
        openclaw onboard --auth-choice zai-api-key
        ```
      </Step>
      <Step title="Pastikan model tercantum">
        ```bash
        openclaw models list --all --provider zai
        ```
      </Step>
    </Steps>

  </Tab>

  <Tab title="Endpoint regional eksplisit">
    **Paling cocok untuk:** pengguna yang ingin memaksakan Coding Plan tertentu atau antarmuka API umum.

    <Steps>
      <Step title="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 umum
        openclaw onboard --auth-choice zai-global

        # API umum CN (wilayah Tiongkok)
        openclaw onboard --auth-choice zai-cn
        ```
      </Step>
      <Step title="Pastikan model tercantum">
        ```bash
        openclaw models list --all --provider zai
        ```
      </Step>
    </Steps>

  </Tab>
</Tabs>

### 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

<Tip>
`zai-api-key` memungkinkan OpenClaw mendeteksi endpoint Z.AI yang cocok dari kunci tersebut dan
menerapkan URL dasar yang benar secara otomatis. Gunakan pilihan regional eksplisit jika
Anda ingin memaksakan Coding Plan tertentu atau antarmuka API umum.
</Tip>

```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`        |                                   |

<Tip>
Model GLM tersedia sebagai `zai/<model>` (contoh: `zai/glm-5`).
</Tip>

<Note>
Penyiapan Coding Plan secara bawaan menggunakan `zai/glm-5.2`; penyiapan API umum tetap menggunakan
`zai/glm-5.1`. Pada endpoint Coding Plan, deteksi otomatis beralih ke
`glm-5.1` lalu `glm-4.7` ketika kunci/paket tidak menyediakan GLM-5.2. Versi
dan ketersediaan GLM dapat berubah; jalankan `openclaw models list --all --provider zai`
untuk melihat katalog yang dikenal oleh versi yang Anda instal.
</Note>

## Tingkat penalaran

<Tabs>
  <Tab title="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.
  </Tab>
  <Tab title="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).
  </Tab>
</Tabs>

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

## Konfigurasi lanjutan

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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 },
            },
          },
        },
      },
    }
    ```

  </Accordion>

  <Accordion title="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`.

  </Accordion>

  <Accordion title="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.

  </Accordion>

  <Accordion title="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.

  </Accordion>
</AccordionGroup>

## Terkait

<CardGroup cols={2}>
  <Card title="Pemilihan model" href="/id/concepts/model-providers" icon="layers">
    Memilih penyedia, referensi model, dan perilaku failover.
  </Card>
  <Card title="Referensi konfigurasi" href="/id/gateway/configuration-reference" icon="gear">
    Skema konfigurasi lengkap OpenClaw, termasuk pengaturan penyedia dan model.
  </Card>
</CardGroup>