Chuyển đến nội dung chính

Documentation Index

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

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

Z.AI là nền tảng API cho các mô hình GLM. Nền tảng này cung cấp các REST API cho GLM và dùng khóa API để xác thực. Tạo khóa API của bạn trong bảng điều khiển Z.AI. OpenClaw dùng nhà cung cấp zai với khóa API Z.AI.
  • Nhà cung cấp: zai
  • Xác thực: ZAI_API_KEY
  • API: Z.AI Chat Completions (xác thực Bearer)

​
Bắt đầu

Phù hợp nhất cho: hầu hết người dùng. OpenClaw phát hiện endpoint Z.AI phù hợp từ khóa và tự động áp dụng base URL chính xác.
1

Chạy thiết lập ban đầu

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

Đặt mô hình mặc định

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

Xác minh mô hình có trong danh sách

openclaw models list --all --provider zai

​
Danh mục tích hợp sẵn

OpenClaw cung cấp danh mục nhà cung cấp zai đi kèm trong manifest Plugin, vì vậy thao tác liệt kê chỉ đọc có thể hiển thị các hàng GLM đã biết mà không cần tải runtime của nhà cung cấp: 
openclaw models list --all --provider zai
Danh mục dựa trên manifest hiện bao gồm:
Tham chiếu mô hìnhGhi chú
zai/glm-5.1Mô hình mặc định
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
Các mô hình GLM có sẵn dưới dạng zai/<model> (ví dụ: zai/glm-5). Tham chiếu mô hình đi kèm mặc định là zai/glm-5.1.

​
Cấu hình nâng cao

Các id glm-5* chưa biết vẫn được phân giải chuyển tiếp trên đường dẫn nhà cung cấp đi kèm bằng cách tổng hợp metadata do nhà cung cấp sở hữu từ mẫu glm-4.7 khi id khớp với dạng họ GLM-5 hiện tại.
tool_stream được bật theo mặc định cho truyền phát lệnh gọi công cụ của Z.AI. Để tắt tính năng này:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Thinking của Z.AI tuân theo các điều khiển /think của OpenClaw. Khi tắt thinking, OpenClaw gửi thinking: { type: "disabled" } để tránh phản hồi dùng ngân sách đầu ra cho reasoning_content trước phần văn bản hiển thị.Thinking được giữ lại là tùy chọn bật vì Z.AI yêu cầu phát lại toàn bộ reasoning_content lịch sử, làm tăng số token của prompt. Bật theo từng mô hình:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Khi được bật và thinking đang bật, OpenClaw gửi thinking: { type: "enabled", clear_thinking: false } và phát lại reasoning_content trước đó cho cùng transcript tương thích với OpenAI.Người dùng nâng cao vẫn có thể ghi đè payload chính xác của nhà cung cấp bằng params.extra_body.thinking.
Plugin Z.AI đi kèm đăng ký khả năng hiểu hình ảnh.
Thuộc tínhGiá trị
Mô hìnhglm-4.6v
Khả năng hiểu hình ảnh được tự động phân giải từ xác thực Z.AI đã cấu hình, không cần cấu hình bổ sung.
  • Z.AI dùng xác thực Bearer với khóa API của bạn.
  • Lựa chọn thiết lập ban đầu zai-api-key tự động phát hiện endpoint Z.AI phù hợp từ tiền tố khóa.
  • Dùng các lựa chọn khu vực rõ ràng (zai-coding-global, zai-coding-cn, zai-global, zai-cn) khi bạn muốn buộc dùng một bề mặt API cụ thể.

​
Liên quan

Họ mô hình GLM

Tổng quan về họ mô hình GLM.

Chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.