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 คือแพลตฟอร์ม API สำหรับโมเดล GLM โดยให้บริการ REST API สำหรับ GLM และ ใช้คีย์ API สำหรับการยืนยันตัวตน สร้างคีย์ API ของคุณในคอนโซล Z.AI OpenClaw ใช้ผู้ให้บริการ zai ร่วมกับคีย์ API ของ Z.AI

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

โมเดล GLM

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

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

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

bash
openclaw plugins install @openclaw/zai-provider

Auto-detect endpoint

เหมาะที่สุดสำหรับ: ผู้ใช้ส่วนใหญ่ OpenClaw จะตรวจสอบเอ็นด์พอยต์ Z.AI ที่รองรับด้วยคีย์ API ของคุณ และใช้ 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

    • เอ็นด์พอยต์

    ตัวเลือกการเริ่มต้นใช้งาน URL ฐาน โมเดลเริ่มต้น
    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 จะตรวจหาเอ็นด์พอยต์หนึ่งในสี่รายการนี้โดยอัตโนมัติ ด้วยการทดสอบคีย์ของคุณกับ API การเติมข้อความสนทนาของแต่ละเอ็นด์พอยต์ โดยตรวจสอบเอ็นด์พอยต์ทั่วไป (zai-global จากนั้น zai-cn) ก่อนเอ็นด์พอยต์ Coding Plan (zai-coding-global จากนั้น zai-coding-cn) และหยุดที่เอ็นด์พอยต์แรกที่ยอมรับคำขอ ใช้ --auth-choice แบบระบุชัดเจนเพื่อบังคับใช้เอ็นด์พอยต์ Coding Plan หากคีย์ของคุณ ใช้งานได้กับทั้งสองประเภท

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

    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

    ปัจจุบันแค็ตตาล็อกที่อ้างอิงจากไฟล์ประกาศประกอบด้วย:

    การอ้างอิงโมเดล หมายเหตุ
    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

    ระดับการคิด

    GLM-5.2

    ช่วงทั้งหมด: off, low, high, max (ค่าเริ่มต้นคือ off) OpenClaw จะแมป low และ high ไปยังระดับความพยายามในการให้เหตุผล high ของ Z.AI และแมป max ไปยัง ระดับความพยายาม max ของ Z.AI ผ่าน reasoning_effort ในเพย์โหลดคำขอ

    Other GLM models

    สลับได้เพียงสองค่า: off และ low (แสดงเป็น on ในตัวเลือก) โดยค่าเริ่มต้นคือ off การตั้งค่าการคิดเป็น off จะส่ง thinking: { type: "disabled" }; ระดับอื่นทั้งหมดจะไม่แก้ไขเพย์โหลดคำขอ (ใช้พฤติกรรมการให้เหตุผลเริ่มต้น ของ Z.AI)

    การตั้งค่าการคิดเป็น off ช่วยหลีกเลี่ยงการตอบกลับที่ใช้โควตาผลลัพธ์ไปกับ reasoning_content ก่อนข้อความที่มองเห็นได้

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

    Forward-resolving unknown GLM-5 models

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

    Tool-call streaming

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

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

    การเก็บรักษาการคิดเป็นคุณสมบัติที่ต้องเลือกเปิดใช้ เนื่องจาก 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 คีย์พารามิเตอร์แบบ snake_case preserve_thinking ใช้งานเป็นนามแฝงได้

    ผู้ใช้ขั้นสูงยังคงสามารถเขียนทับเพย์โหลดของผู้ให้บริการแบบเจาะจงได้ด้วย params.extra_body.thinking

    Image understanding

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

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

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

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

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

    Model selection

    การเลือกผู้ให้บริการ การอ้างอิงโมเดล และพฤติกรรมการสลับไปใช้ระบบสำรอง
    Configuration reference

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

    On this page