Providers
Z.AI
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 API REST cho GLM và
sử dụng khóa API để xác thực. Hãy tạo khóa API của bạn trong bảng điều khiển Z.AI.
OpenClaw sử dụng nhà cung cấp zai cùng với khóa API Z.AI.
| Thuộc tính | Giá trị |
|---|---|
| Nhà cung cấp | zai |
| Gói | @openclaw/zai-provider |
| Xác thực | ZAI_API_KEY (bí danh cũ: Z_AI_API_KEY) |
| API | Z.AI Chat Completions (xác thực Bearer) |
Các mô hình GLM
GLM là một họ mô hình, không phải một nhà cung cấp riêng biệt. Trong OpenClaw, các mô hình GLM sử dụng
tham chiếu như zai/glm-5.2: nhà cung cấp zai, mã mô hình glm-5.2.
Bắt đầu
Trước tiên, hãy cài đặt Plugin nhà cung cấp:
openclaw plugins install @openclaw/zai-providerTự động phát hiện điểm cuối
Phù hợp nhất cho: hầu hết người dùng. OpenClaw thăm dò các điểm cuối Z.AI được hỗ trợ bằng khóa API của bạn và tự động áp dụng URL cơ sở chính xác.
Chạy quy trình thiết lập ban đầu
openclaw onboard --auth-choice zai-api-keyXác minh mô hình có trong danh sách
openclaw models list --all --provider zaiĐiểm cuối khu vực cụ thể
Phù hợp nhất cho: người dùng muốn buộc sử dụng một Coding Plan hoặc bề mặt API chung cụ thể.
Chọn tùy chọn thiết lập ban đầu phù hợp
# Coding Plan toàn cầu (khuyến nghị cho người dùng Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (khu vực Trung Quốc)openclaw onboard --auth-choice zai-coding-cn # API chungopenclaw onboard --auth-choice zai-global # API chung CN (khu vực Trung Quốc)openclaw onboard --auth-choice zai-cnXác minh mô hình có trong danh sách
openclaw models list --all --provider zaiCác điểm cuối
| Tùy chọn thiết lập ban đầu | URL cơ sở | Mô hình mặc định |
|---|---|---|
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 tự động phát hiện một trong bốn điểm cuối này bằng cách thăm dò khóa của bạn trên API
hoàn thành hội thoại của từng điểm cuối, kiểm tra các điểm cuối chung (zai-global,
sau đó là zai-cn) trước các điểm cuối Coding Plan (zai-coding-global, sau đó là
zai-coding-cn) và dừng tại điểm cuối đầu tiên chấp nhận yêu cầu.
Hãy sử dụng một --auth-choice cụ thể để buộc dùng điểm cuối Coding Plan nếu khóa của bạn
hoạt động trên cả hai loại.
Ví dụ cấu hình
{ env: { ZAI_API_KEY: "sk-..." }, models: { providers: { zai: { // GLM-5.2 sử dụng điểm cuối Coding Plan. baseUrl: "https://api.z.ai/api/coding/paas/v4", }, }, }, agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}Danh mục tích hợp sẵn
Plugin nhà cung cấp zai cung cấp danh mục trong bản kê khai Plugin, nhờ đó 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 môi trường thực thi của nhà cung cấp:
openclaw models list --all --provider zaiDanh mục dựa trên bản kê khai hiện bao gồm:
| Tham chiếu mô hình | Ghi chú |
|---|---|
zai/glm-5.2 |
Mặc định của Coding Plan; ngữ cảnh 1M |
zai/glm-5.1 |
Mặc định của API chung |
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ức suy luận
GLM-5.2
Toàn bộ phạm vi: off, low, high, max (mặc định là off). OpenClaw ánh xạ
low và high sang mức nỗ lực suy luận high của Z.AI, còn max sang mức nỗ lực
max của Z.AI, thông qua reasoning_effort trong nội dung yêu cầu.
Các mô hình GLM khác
Chỉ có công tắc nhị phân: off và low (được hiển thị là on trong trình chọn), mặc định
là off. Đặt chế độ suy luận thành off sẽ gửi thinking: { type: "disabled" };
mọi mức khác sẽ giữ nguyên nội dung yêu cầu (hành vi suy luận mặc định của chính Z.AI
sẽ được áp dụng).
Đặt chế độ suy luận thành off giúp tránh các phản hồi tiêu tốn ngân sách đầu ra cho
reasoning_content trước khi tạo ra văn bản hiển thị.
Cấu hình nâng cao
Phân giải chuyển tiếp các mô hình GLM-5 chưa xác định
Các mã glm-5* chưa xác định vẫn được phân giải chuyển tiếp trên đường dẫn nhà cung cấp bằng cách
tổng hợp siêu dữ liệu do nhà cung cấp sở hữu từ mẫu glm-4.7 khi mã đó
khớp với cấu trúc hiện tại của họ GLM-5.
Truyền phát lệnh gọi công cụ
tool_stream được bật mặc định cho tính năng 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 }, }, }, }, },}Duy trì nội dung suy luận
Việc duy trì nội dung suy luận là tùy chọn vì Z.AI yêu cầu phát lại toàn bộ
reasoning_content trong lịch sử, làm tăng số token của lời nhắc. Bật tính năng này
cho từng mô hình:
{ agents: { defaults: { models: { "zai/glm-5.2": { params: { preserveThinking: true }, }, }, }, },}Khi tính năng này được bật và chế độ suy luận đang hoạt động, OpenClaw sẽ gửi
thinking: { type: "enabled", clear_thinking: false } và phát lại
reasoning_content trước đó cho cùng một bản ghi hội thoại tương thích với OpenAI. Khóa tham số dạng snake_case
preserve_thinking hoạt động như một bí danh.
Người dùng nâng cao vẫn có thể ghi đè chính xác nội dung gửi đến nhà cung cấp bằng
params.extra_body.thinking.
Hiểu hình ảnh
Plugin Z.AI đăng ký khả năng hiểu hình ảnh.
| Thuộc tính | Giá trị |
|---|---|
| Mô hình | glm-4.6v |
Khả năng hiểu hình ảnh được tự động phân giải từ thông tin xác thực Z.AI đã cấu hình — không cần cấu hình bổ sung.
Chi tiết xác thực
- Z.AI sử dụng xác thực Bearer với khóa API của bạn.
- Tùy chọn thiết lập ban đầu
zai-api-keytự động phát hiện điểm cuối Z.AI phù hợp bằng cách thăm dò các điểm cuối được hỗ trợ với khóa của bạn. - Hãy sử dụng các lựa chọn khu vực cụ thể (
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ể. - Biến môi trường cũ
Z_AI_API_KEYvẫn được chấp nhận; OpenClaw sao chép biến này sangZAI_API_KEYkhi khởi động nếuZAI_API_KEYchưa được đặt.