From be32f4a4fb64eb761995f1529e54eaf608048c47 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 1 May 2026 13:15:14 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/providers/zai.md | 116 +++++++++++++++++------------------- 1 file changed, 56 insertions(+), 60 deletions(-) diff --git a/docs/zh-CN/providers/zai.md b/docs/zh-CN/providers/zai.md index b962e3c6d..df1b4d65b 100644 --- a/docs/zh-CN/providers/zai.md +++ b/docs/zh-CN/providers/zai.md @@ -5,35 +5,33 @@ read_when: summary: 在 OpenClaw 中使用 Z.AI（GLM 模型） title: Z.AI x-i18n: - generated_at: "2026-04-28T12:03:15Z" + generated_at: "2026-05-01T13:14:44Z" model: gpt-5.5 provider: openai - source_hash: 0192797b9e023065a384b0428830e73877a5088d2c40c2190d5322273294607d + source_hash: 423fc2bc27c62352d9d9acd13c70aa2bc3804112dab25aa46505e844cb166c93 source_path: providers/zai.md workflow: 16 --- -Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 API key -进行身份认证。请在 Z.AI 控制台中创建你的 API key。OpenClaw 使用 `zai` 提供商 -以及 Z.AI API key。 +Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 API key 进行身份验证。请在 Z.AI 控制台创建你的 API key。OpenClaw 使用带有 Z.AI API key 的 `zai` provider。 - 提供商：`zai` -- 认证：`ZAI_API_KEY` -- API：Z.AI Chat Completions（Bearer 认证） +- 身份验证：`ZAI_API_KEY` +- API：Z.AI Chat Completions（Bearer 身份验证） ## 入门指南 - - **最适合：** 大多数用户。OpenClaw 会从 key 检测匹配的 Z.AI endpoint，并自动应用正确的 base URL。 + + **最适合：** 大多数用户。OpenClaw 会根据密钥检测匹配的 Z.AI 端点，并自动应用正确的 base URL。 - + ```bash openclaw onboard --auth-choice zai-api-key ``` - + ```json5 { env: { ZAI_API_KEY: "sk-..." }, @@ -41,20 +39,20 @@ Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 A } ``` - + ```bash - openclaw models list --provider zai + openclaw models list --all --provider zai ``` - + **最适合：** 想要强制使用特定 Coding Plan 或通用 API 表面的用户。 - + ```bash # Coding Plan Global (recommended for Coding Plan users) openclaw onboard --auth-choice zai-coding-global @@ -69,7 +67,7 @@ Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 A openclaw onboard --auth-choice zai-cn ``` - + ```json5 { env: { ZAI_API_KEY: "sk-..." }, @@ -77,9 +75,9 @@ Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 A } ``` - + ```bash - openclaw models list --provider zai + openclaw models list --all --provider zai ``` @@ -89,39 +87,43 @@ Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 A ## 内置目录 -OpenClaw 目前为内置的 `zai` 提供商预置： +OpenClaw 会在插件清单中随附内置的 `zai` provider 目录，因此只读列表可以在不加载提供商运行时的情况下显示已知的 GLM 行： -| 模型引用 | 备注 | -| -------------------- | ---------- | -| `zai/glm-5.1` | 默认模型 | -| `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` | | +```bash +openclaw models list --all --provider zai +``` + +基于清单的目录当前包含： + +| 模型引用 | 备注 | +| -------------------- | ------------ | +| `zai/glm-5.1` | 默认模型 | +| `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 模型可用作 `zai/`（示例：`zai/glm-5`）。默认内置模型引用是 `zai/glm-5.1`。 +GLM 模型可作为 `zai/` 使用（示例：`zai/glm-5`）。默认内置模型引用是 `zai/glm-5.1`。 ## 高级配置 - - 未知的 `glm-5*` id 仍会在内置提供商路径上向前解析： - 当 id 匹配当前 GLM-5 系列形态时，会基于 `glm-4.7` 模板 - 合成由提供商拥有的元数据。 + + 未知的 `glm-5*` ID 仍会在内置提供商路径上向前解析：当 ID 匹配当前 GLM-5 系列形态时，会从 `glm-4.7` 模板合成提供商拥有的元数据。 - - Z.AI 工具调用流式传输默认启用 `tool_stream`。要禁用它： + + Z.AI 工具调用流式传输默认启用 `tool_stream`。若要禁用它： ```json5 { @@ -139,13 +141,10 @@ GLM 模型可用作 `zai/`（示例：`zai/glm-5`）。默认内置模型 - - Z.AI thinking 遵循 OpenClaw 的 `/think` 控制。关闭 thinking 时， - OpenClaw 会发送 `thinking: { type: "disabled" }`，以避免响应在可见文本之前 - 将输出预算消耗在 `reasoning_content` 上。 + + Z.AI 思考遵循 OpenClaw 的 `/think` 控制。关闭思考时，OpenClaw 会发送 `thinking: { type: "disabled" }`，以避免响应在可见文本之前将输出预算消耗在 `reasoning_content` 上。 - preserved thinking 是可选启用的，因为 Z.AI 要求回放完整历史 - `reasoning_content`，这会增加 prompt token。按模型启用： + 保留思考是选择启用的，因为 Z.AI 要求重放完整的历史 `reasoning_content`，这会增加提示词 token。请按模型启用： ```json5 { @@ -161,29 +160,26 @@ GLM 模型可用作 `zai/`（示例：`zai/glm-5`）。默认内置模型 } ``` - 启用后且 thinking 开启时，OpenClaw 会发送 - `thinking: { type: "enabled", clear_thinking: false }`，并为同一个兼容 OpenAI 的 transcript 回放之前的 - `reasoning_content`。 + 启用后且思考处于开启状态时，OpenClaw 会发送 `thinking: { type: "enabled", clear_thinking: false }`，并为同一个 OpenAI 兼容对话记录重放先前的 `reasoning_content`。 - 高级用户仍可通过 `params.extra_body.thinking` 覆盖确切的提供商 payload。 + 高级用户仍可使用 `params.extra_body.thinking` 覆盖确切的提供商载荷。 - - 内置 Z.AI 插件会注册图像理解能力。 + + 内置的 Z.AI 插件会注册图像理解。 | 属性 | 值 | | ------------- | ----------- | | 模型 | `glm-4.6v` | - 图像理解会根据配置的 Z.AI 认证自动解析，不需要 - 额外配置。 + 图像理解会从已配置的 Z.AI 身份验证自动解析，无需额外配置。 - - - Z.AI 使用你的 API key 进行 Bearer 认证。 - - `zai-api-key` 新手引导选项会根据 key 前缀自动检测匹配的 Z.AI endpoint。 + + - Z.AI 使用你的 API key 进行 Bearer 身份验证。 + - `zai-api-key` 新手引导选项会根据密钥前缀自动检测匹配的 Z.AI 端点。 - 当你想要强制使用特定 API 表面时，请使用显式区域选项（`zai-coding-global`、`zai-coding-cn`、`zai-global`、`zai-cn`）。 @@ -192,10 +188,10 @@ GLM 模型可用作 `zai/`（示例：`zai/glm-5`）。默认内置模型 ## 相关内容 - + GLM 的模型系列概览。 - + 选择提供商、模型引用和故障转移行为。