Providers

Z.AI

Z.AI เป็นแพลตฟอร์ม API สำหรับโมเดล GLM โดยมี REST API สำหรับ GLM และ ใช้ API keys สำหรับการยืนยันตัวตน สร้าง API key ของคุณในคอนโซล Z.AI OpenClaw ใช้ผู้ให้บริการ zai ร่วมกับ Z.AI API key

คุณสมบัติ	ค่า
ผู้ให้บริการ	`zai`
แพ็กเกจ	`@openclaw/zai-provider`
การยืนยันตัวตน	`ZAI_API_KEY` (ชื่อแทนเดิม: `Z_AI_API_KEY`)
API	Z.AI Chat Completions (การยืนยันตัวตนแบบ Bearer)

โมเดล GLM

GLM เป็นตระกูลโมเดล ไม่ใช่ผู้ให้บริการแยกต่างหาก ใน OpenClaw โมเดล GLM ใช้ refs เช่น zai/glm-5.2: ผู้ให้บริการ zai, id โมเดล glm-5.2

เริ่มต้นใช้งาน

ติดตั้ง Plugin ผู้ให้บริการก่อน:

bash

openclaw plugins install @openclaw/zai-provider

Auto-detect endpoint

เหมาะที่สุดสำหรับ: ผู้ใช้ส่วนใหญ่ OpenClaw จะตรวจสอบปลายทาง Z.AI ที่รองรับด้วย API key ของคุณ และใช้ URL ฐานที่ถูกต้องโดยอัตโนมัติ

Run onboarding

bash

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

Verify the model is listed

bash

openclaw models list --all --provider zai

Explicit regional endpoint

เหมาะที่สุดสำหรับ: ผู้ใช้ที่ต้องการบังคับใช้ Coding Plan หรือพื้นผิว API ทั่วไปแบบเฉพาะเจาะจง

Pick the right onboarding choice

bash

# Coding Plan Global (recommended for Coding Plan users)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (China region)openclaw onboard --auth-choice zai-coding-cn # General APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cn

Verify the model is listed

bash

openclaw models list --all --provider zai

ตัวอย่างการกำหนดค่า

json5

{  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" } } },}

แค็ตตาล็อกในตัว

Plugin ผู้ให้บริการ zai มาพร้อมแค็ตตาล็อกในแมนิเฟสต์ของ Plugin ดังนั้นการแสดงรายการแบบอ่านอย่างเดียว จึงสามารถแสดงแถว GLM ที่รู้จักได้โดยไม่ต้องโหลดรันไทม์ของผู้ให้บริการ:

bash

openclaw models list --all --provider zai

แค็ตตาล็อกที่อิงกับแมนิเฟสต์ในปัจจุบันมีรายการต่อไปนี้:

ref โมเดล	หมายเหตุ
`zai/glm-5.2`	ค่าเริ่มต้นของ Coding Plan; บริบท 1M
`zai/glm-5.1`	ค่าเริ่มต้นของ API ทั่วไป
`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`

Note

การตั้งค่า Coding Plan ใช้ค่าเริ่มต้นเป็น zai/glm-5.2; การตั้งค่า API ทั่วไปยังคงใช้ zai/glm-5.1 การตรวจหาปลายทางอัตโนมัติจะย้อนกลับไปใช้ glm-5.1 หรือ glm-4.7 เมื่อแผนที่เลือกไม่ได้เปิดให้ใช้ GLM-5.2 เวอร์ชันและความพร้อมใช้งานของ GLM อาจเปลี่ยนแปลงได้; เรียกใช้ openclaw models list --all --provider zai เพื่อดูแค็ตตาล็อก ที่เวอร์ชันที่คุณติดตั้งรู้จัก

การกำหนดค่าขั้นสูง

Forward-resolving unknown GLM-5 models

id glm-5* ที่ไม่รู้จักยังคงถูกแก้ไปข้างหน้าบนเส้นทางผู้ให้บริการ โดย สังเคราะห์เมทาดาทาที่ผู้ให้บริการเป็นเจ้าของจากเทมเพลต glm-4.7 เมื่อ id ตรงกับรูปแบบตระกูล GLM-5 ปัจจุบัน

Tool-call streaming

tool_stream เปิดใช้งานเป็นค่าเริ่มต้นสำหรับการสตรีม tool-call ของ Z.AI หากต้องการปิดใช้งาน:

json5

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

Thinking and preserved thinking

การคิดของ Z.AI ทำตามตัวควบคุม /think ของ OpenClaw เมื่อปิดการคิด OpenClaw จะส่ง thinking: { type: "disabled" } เพื่อหลีกเลี่ยงคำตอบที่ ใช้งบประมาณเอาต์พุตกับ reasoning_content ก่อนข้อความที่มองเห็นได้

การเก็บรักษาการคิดต้องเลือกเปิดใช้ เพราะ Z.AI ต้องการให้เล่นซ้ำ reasoning_content ในประวัติทั้งหมด ซึ่งเพิ่มจำนวนโทเค็นพรอมป์ เปิดใช้งาน ต่อโมเดล:

json5

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

เมื่อเปิดใช้งานและการคิดเปิดอยู่ OpenClaw จะส่ง thinking: { type: "enabled", clear_thinking: false } และเล่นซ้ำ reasoning_content ก่อนหน้าสำหรับทรานสคริปต์ที่เข้ากันได้กับ OpenAI เดียวกัน

ผู้ใช้ขั้นสูงยังสามารถเขียนทับ payload ของผู้ให้บริการแบบตรงตัวได้ด้วย params.extra_body.thinking

Image understanding

Plugin Z.AI ลงทะเบียนความเข้าใจรูปภาพ

คุณสมบัติ	ค่า
โมเดล	`glm-4.6v`

ความเข้าใจรูปภาพถูกแก้อัตโนมัติจากการยืนยันตัวตน Z.AI ที่กำหนดค่าไว้ โดยไม่ต้องมี การกำหนดค่าเพิ่มเติม

Auth details

Z.AI ใช้การยืนยันตัวตนแบบ Bearer ด้วย API key ของคุณ
ตัวเลือก onboarding zai-api-key จะตรวจหาปลายทาง Z.AI ที่ตรงกันโดยอัตโนมัติด้วยการตรวจสอบปลายทางที่รองรับด้วย key ของคุณ
ใช้ตัวเลือกภูมิภาคแบบระบุชัดเจน (zai-coding-global, zai-coding-cn, zai-global, zai-cn) เมื่อคุณต้องการบังคับใช้พื้นผิว API แบบเฉพาะเจาะจง
env var เดิม Z_AI_API_KEY ยังยอมรับอยู่; OpenClaw จะคัดลอกไปยัง ZAI_API_KEY ตอนเริ่มต้น หากไม่ได้ตั้งค่า ZAI_API_KEY

ที่เกี่ยวข้อง

Model selection

การเลือกผู้ให้บริการ refs โมเดล และพฤติกรรม failover

Configuration reference

สคีมาการกำหนดค่า OpenClaw ฉบับเต็ม รวมถึงการตั้งค่าผู้ให้บริการและโมเดล

Was this useful?

Z.AI

โมเดล GLM

เริ่มต้นใช้งาน

Auto-detect endpoint

Run onboarding

Verify the model is listed

Explicit regional endpoint

Pick the right onboarding choice

Verify the model is listed

ตัวอย่างการกำหนดค่า

แค็ตตาล็อกในตัว

การกำหนดค่าขั้นสูง

ที่เกี่ยวข้อง

On this page

Molty