chore(i18n): refresh zh-CN translations

2026-04-12 10:43:23 +00:00 · 2026-04-12 10:43:23 +00:00 · 7b93d3c556
commit 7b93d3c556
parent 1606f30e08
5 changed files with 118 additions and 109 deletions
--- a/docs/zh-CN/providers/deepseek.md
+++ b/docs/zh-CN/providers/deepseek.md
@ -1,33 +1,34 @@
 ---
 read_when:
    - 你想在 OpenClaw 中使用 DeepSeek
-    - 你需要 API 密钥环境变量或 CLI 认证选项
-summary: DeepSeek 设置（认证 + 模型选择）
+    - 你需要 API 密钥环境变量或 CLI 身份验证选项
+summary: DeepSeek 设置（身份验证 + 模型选择）
+title: DeepSeek
 x-i18n:
-    generated_at: "2026-04-12T10:38:49Z"
+    generated_at: "2026-04-12T10:43:02Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 8b439c4b4cf5445db891b81d03e99f6aef5be64623e79e818763de43a2823d6d
+    source_hash: ad06880bd1ab89f72f9e31f4927e2c099dcf6b4e0ff2b3fcc91a24468fbc089d
    source_path: providers/deepseek.md
    workflow: 15
 ---

 # DeepSeek

-[DeepSeek](https://www.deepseek.com) 通过兼容 OpenAI 的 API 提供强大的 AI 模型。
+[DeepSeek](https://www.deepseek.com) 通过与 OpenAI 兼容的 API 提供强大的 AI 模型。

-| Property | Value                      |
+| 属性 | 值 |
 | -------- | -------------------------- |
-| 提供商 | `deepseek`                 |
-| 认证     | `DEEPSEEK_API_KEY`         |
-| API      | 兼容 OpenAI          |
+| 提供商 | `deepseek` |
+| 身份验证 | `DEEPSEEK_API_KEY` |
+| API | 与 OpenAI 兼容 |
 | Base URL | `https://api.deepseek.com` |

 ## 入门指南

 <Steps>
  <Step title="获取你的 API 密钥">
-    在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建 API 密钥。
+    在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建一个 API 密钥。
  </Step>
  <Step title="运行新手引导">
    ```bash
@ -46,7 +47,7 @@ x-i18n:

 <AccordionGroup>
  <Accordion title="非交互式设置">
-    对于脚本化或无头安装，直接传入所有标志：
+    对于脚本化或无头安装，请直接传递所有标志：

    ```bash
    openclaw onboard --non-interactive \
@ -61,20 +62,20 @@ x-i18n:
 </AccordionGroup>

 <Warning>
-如果 Gateway 网关 以守护进程方式运行（launchd/systemd），请确保 `DEEPSEEK_API_KEY`
-对该进程可用（例如，在 `~/.openclaw/.env` 中或通过
+如果 Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保 `DEEPSEEK_API_KEY`
+可供该进程使用（例如，在 `~/.openclaw/.env` 中，或通过
 `env.shellEnv`）。
 </Warning>

 ## 内置目录

-| Model ref                    | Name              | Input | Context | Max output | Notes                                             |
+| 模型引用 | 名称 | 输入 | 上下文 | 最大输出 | 说明 |
 | ---------------------------- | ----------------- | ----- | ------- | ---------- | ------------------------------------------------- |
-| `deepseek/deepseek-chat`     | DeepSeek Chat     | 文本  | 131,072 | 8,192      | 默认模型；DeepSeek V3.2 非思考表层 |
-| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | 文本  | 131,072 | 65,536     | 启用推理的 V3.2 表层                    |
+| `deepseek/deepseek-chat` | DeepSeek Chat | text | 131,072 | 8,192 | 默认模型；DeepSeek V3.2 非思考表面 |
+| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | text | 131,072 | 65,536 | 启用推理的 V3.2 表面 |

 <Tip>
-源码中，这两个内置模型目前都声明支持流式传输用法兼容性。
+源码中当前将这两个内置模型都声明为兼容流式传输用法。
 </Tip>

 ## 配置示例
--- a/docs/zh-CN/providers/fireworks.md
+++ b/docs/zh-CN/providers/fireworks.md
@ -1,13 +1,14 @@
 ---
 read_when:
    - 你想在 OpenClaw 中使用 Fireworks
-    - 你需要 Fireworks API 密钥环境变量或默认模型 ID
+    - 你需要 Fireworks API 密钥环境变量或默认模型 id
 summary: Fireworks 设置（凭证 + 模型选择）
+title: Fireworks
 x-i18n:
-    generated_at: "2026-04-12T10:33:24Z"
+    generated_at: "2026-04-12T10:43:05Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 8f87b2ed6fb6c6db086166ff2775f15d876947f48a36b9dd2e2a55269709cb6a
+    source_hash: 1a85d9507c19e275fdd846a303d844eda8045d008774d4dde1eae408e8716b6f
    source_path: providers/fireworks.md
    workflow: 15
 ---
@ -35,7 +36,7 @@ x-i18n:
    这会将你的 Fireworks 密钥存储到 OpenClaw 配置中，并将 Fire Pass 入门模型设为默认值。

  </Step>
-  <Step title="验证模型可用">
+  <Step title="验证模型是否可用">
    ```bash
    openclaw models list --provider fireworks
    ```
@ -44,7 +45,7 @@ x-i18n:

 ## 非交互式示例

-对于脚本化或 CI 设置，在命令行上传递所有值：
+对于脚本化或 CI 设置，请在命令行中传入所有值：

 ```bash
 openclaw onboard --non-interactive \
@ -57,17 +58,17 @@ openclaw onboard --non-interactive \

 ## 内置目录

-| Model ref                                              | Name                        | Input      | Context | Max output | Notes                                      |
+| 模型引用                                              | 名称                        | 输入      | 上下文 | 最大输出 | 说明                                      |
 | ------------------------------------------------------ | --------------------------- | ---------- | ------- | ---------- | ------------------------------------------ |
 | `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` | Kimi K2.5 Turbo（Fire Pass） | text,image | 256,000 | 256,000    | Fireworks 上默认内置的入门模型 |

 <Tip>
-如果 Fireworks 发布了更新的模型，例如新的 Qwen 或 Gemma 版本，你可以直接使用其 Fireworks 模型 ID 切换到该模型，而无需等待内置目录更新。
+如果 Fireworks 发布了更新的模型，例如新的 Qwen 或 Gemma 版本，你可以直接使用其 Fireworks 模型 id 切换过去，而无需等待内置目录更新。
 </Tip>

-## 自定义 Fireworks 模型 ID
+## 自定义 Fireworks 模型 id

-OpenClaw 也接受动态 Fireworks 模型 ID。使用 Fireworks 显示的精确模型或路由 ID，并在前面加上 `fireworks/` 前缀。
+OpenClaw 也接受动态 Fireworks 模型 id。使用 Fireworks 显示的精确模型或路由 id，并为其添加 `fireworks/` 前缀。

 ```json5
 {
@ -82,8 +83,8 @@ OpenClaw 也接受动态 Fireworks 模型 ID。使用 Fireworks 显示的精确
 ```

 <AccordionGroup>
-  <Accordion title="模型 ID 前缀的工作方式">
-    OpenClaw 中的每个 Fireworks 模型引用都以 `fireworks/` 开头，后面跟 Fireworks 平台中的精确 ID 或路由路径。例如：
+  <Accordion title="模型 id 前缀的工作方式">
+    OpenClaw 中的每个 Fireworks 模型引用都以 `fireworks/` 开头，后面跟着 Fireworks 平台中的精确 id 或路由路径。例如：

    - 路由模型：`fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`
    - 直接模型：`fireworks/accounts/fireworks/models/<model-name>`
@ -92,11 +93,11 @@ OpenClaw 也接受动态 Fireworks 模型 ID。使用 Fireworks 显示的精确

  </Accordion>

-  <Accordion title="环境变量说明">
-    如果 Gateway 网关 运行在你的交互式 shell 之外，请确保 `FIREWORKS_API_KEY` 对该进程同样可用。
+  <Accordion title="环境说明">
+    如果 Gateway 网关 运行在你的交互式 shell 之外，请确保 `FIREWORKS_API_KEY` 对该进程也可用。

    <Warning>
-    如果密钥只存在于 `~/.profile` 中，那么对于 `launchd`/`systemd` 守护进程不会有帮助，除非该环境变量也被导入到那里。请在 `~/.openclaw/.env` 中设置该密钥，或通过 `env.shellEnv` 设置，以确保 Gateway 网关 进程能够读取它。
+    如果密钥只存在于 `~/.profile` 中，那么除非该环境变量也被导入到那里，否则它无法帮助 launchd/systemd 守护进程。请在 `~/.openclaw/.env` 中设置该密钥，或通过 `env.shellEnv` 设置，以确保 Gateway 网关 进程可以读取它。
    </Warning>

  </Accordion>
@ -106,9 +107,9 @@ OpenClaw 也接受动态 Fireworks 模型 ID。使用 Fireworks 显示的精确

 <CardGroup cols={2}>
  <Card title="模型选择" href="/zh-CN/concepts/model-providers" icon="layers">
-    选择提供商、模型引用和故障切换行为。
+    选择提供商、模型引用和故障转移行为。
  </Card>
  <Card title="故障排除" href="/zh-CN/help/troubleshooting" icon="wrench">
-    常见的故障排除和常见问题。
+    常规故障排除和常见问题。
  </Card>
 </CardGroup>
--- a/docs/zh-CN/providers/glm.md
+++ b/docs/zh-CN/providers/glm.md
@ -1,14 +1,14 @@
 ---
 read_when:
    - 你想在 OpenClaw 中使用 GLM 模型
-    - 你需要了解模型命名约定和设置方法
+    - 你需要了解模型命名约定和设置方式
 summary: GLM 模型家族概览 + 如何在 OpenClaw 中使用它
-title: GLM 模型
+title: GLM（智谱）
 x-i18n:
-    generated_at: "2026-04-12T10:36:50Z"
+    generated_at: "2026-04-12T10:43:00Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 12469bda0298f05fd94dc76a3183ab0e08257ec12e84ad1ed393107880e193de
+    source_hash: b38f0896c900fae3cf3458ff99938d73fa46973a057d1dd373ae960cb7d2e9b5
    source_path: providers/glm.md
    workflow: 15
 ---
@ -21,16 +21,16 @@ GLM 是一个**模型家族**（不是公司），可通过 Z.AI 平台使用。
 ## 入门指南

 <Steps>
-  <Step title="选择凭证方式并运行新手引导">
+  <Step title="选择一种凭证方式并运行新手引导">
    选择与你的 Z.AI 套餐和地区匹配的新手引导选项：

    | 凭证选项 | 最适合 |
    | ----------- | -------- |
-    | `zai-api-key` | 通用 API 密钥设置，带端点自动检测 |
+    | `zai-api-key` | 通用 API 密钥设置，支持端点自动检测 |
    | `zai-coding-global` | Coding Plan 用户（全球） |
-    | `zai-coding-cn` | Coding Plan 用户（中国区） |
+    | `zai-coding-cn` | Coding Plan 用户（中国地区） |
    | `zai-global` | 通用 API（全球） |
-    | `zai-cn` | 通用 API（中国区） |
+    | `zai-cn` | 通用 API（中国地区） |

    ```bash
    # 示例：通用自动检测
@ -46,7 +46,7 @@ GLM 是一个**模型家族**（不是公司），可通过 Z.AI 平台使用。
    openclaw config set agents.defaults.model.primary "zai/glm-5.1"
    ```
  </Step>
-  <Step title="验证模型可用">
+  <Step title="验证模型是否可用">
    ```bash
    openclaw models list --provider zai
    ```
@ -63,14 +63,14 @@ GLM 是一个**模型家族**（不是公司），可通过 Z.AI 平台使用。
 ```

 <Tip>
-`zai-api-key` 允许 OpenClaw 根据密钥自动检测匹配的 Z.AI 端点，
-并自动应用正确的基础 URL。当你想强制使用特定的 Coding Plan 或通用 API
-接口时，请使用显式地区选项。
+`zai-api-key` 会让 OpenClaw 根据密钥自动检测匹配的 Z.AI 端点，
+并自动应用正确的基础 URL。如果你想强制使用特定的 Coding Plan 或通用 API 端点，
+请使用显式地区选项。
 </Tip>

-## 内置的 GLM 模型
+## 内置 GLM 模型

-OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用：
+OpenClaw 目前为内置 `zai` 提供商预置了这些 GLM 引用：

 | 模型           | 模型            |
 | --------------- | ---------------- |
@ -84,8 +84,8 @@ OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用：
 | `glm-4.5v`      |                  |

 <Note>
-默认的内置模型引用是 `zai/glm-5.1`。GLM 版本和可用性可能会发生变化；
-请查看 Z.AI 的文档以获取最新信息。
+默认的内置模型引用是 `zai/glm-5.1`。GLM 版本和可用性
+可能会变化；请查看 Z.AI 的文档以获取最新信息。
 </Note>

 ## 高级说明
@ -95,12 +95,12 @@ OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用：
    当你使用 `zai-api-key` 凭证选项时，OpenClaw 会检查密钥格式，
    以确定正确的 Z.AI 基础 URL。显式地区选项
    （`zai-coding-global`、`zai-coding-cn`、`zai-global`、`zai-cn`）会覆盖
-    自动检测，并直接固定端点。
+    自动检测并直接固定端点。
  </Accordion>

  <Accordion title="提供商详情">
-    GLM 模型由 `zai` 运行时提供商提供。有关完整的提供商配置、
-    地区端点和其他功能，请参阅
+    GLM 模型由 `zai` 运行时提供商提供。有关完整的提供商
+    配置、地区端点和其他功能，请参阅
    [Z.AI 提供商文档](/zh-CN/providers/zai)。
  </Accordion>
 </AccordionGroup>
@ -112,6 +112,6 @@ OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用：
    完整的 Z.AI 提供商配置和地区端点。
  </Card>
  <Card title="模型选择" href="/zh-CN/concepts/model-providers" icon="layers">
-    选择提供商、模型引用和故障切换行为。
+    选择提供商、模型引用和故障转移行为。
  </Card>
 </CardGroup>
--- a/docs/zh-CN/providers/kilocode.md
+++ b/docs/zh-CN/providers/kilocode.md
@ -1,24 +1,24 @@
 ---
 read_when:
-    - 你想用一个 API 密钥访问多个 LLM】【。
-    - 你想在 OpenClaw 中通过 Kilo Gateway 运行模型。
-summary: 在 OpenClaw 中使用 Kilo Gateway 的统一 API 访问多种模型
-title: Kilo Gateway
+    - 你想用一个 API 密钥访问多个 LLM
+    - 你想在 OpenClaw 中通过 Kilo Gateway 运行模型
+summary: 使用 Kilo Gateway 的统一 API 在 OpenClaw 中访问多种模型
+title: Kilocode
 x-i18n:
-    generated_at: "2026-04-12T10:30:08Z"
+    generated_at: "2026-04-12T10:43:06Z"
    model: gpt-5.4
    provider: openai
-    source_hash: bf08ee5157b44233692795294b263668a9e0003795c8c170af74ad75c88b1040
+    source_hash: 32946f2187f3933115341cbe81006718b10583abc4deea7440b5e56366025f4a
    source_path: providers/kilocode.md
    workflow: 15
 ---

 # Kilo Gateway

-Kilo Gateway 提供一个**统一 API**，可通过单个端点和 API 密钥将请求路由到多种模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。
+Kilo Gateway 提供一个**统一 API**，可将请求路由到单个端点和 API 密钥背后的多种模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。

-| 属性 | 值 |
-| -------- | ---------------------------------- |
+| Property | Value |
+| -------- | ----- |
 | 提供商 | `kilocode` |
 | 认证 | `KILOCODE_API_KEY` |
 | API | 兼容 OpenAI |
@ -28,7 +28,7 @@ Kilo Gateway 提供一个**统一 API**，可通过单个端点和 API 密钥将

 <Steps>
  <Step title="创建账户">
-    前往 [app.kilo.ai](https://app.kilo.ai)，登录或创建账户，然后进入 API Keys 并生成一个新密钥。
+    前往 [app.kilo.ai](https://app.kilo.ai)，登录或创建账户，然后导航到 API Keys 并生成一个新密钥。
  </Step>
  <Step title="运行新手引导">
    ```bash
@ -42,7 +42,7 @@ Kilo Gateway 提供一个**统一 API**，可通过单个端点和 API 密钥将
    ```

  </Step>
-  <Step title="验证模型可用">
+  <Step title="验证模型是否可用">
    ```bash
    openclaw models list --provider kilocode
    ```
@ -51,10 +51,10 @@ Kilo Gateway 提供一个**统一 API**，可通过单个端点和 API 密钥将

 ## 默认模型

-默认模型是 `kilocode/kilo/auto`，这是一个由提供商拥有的智能路由模型，由 Kilo Gateway 管理。
+默认模型是 `kilocode/kilo/auto`，这是一个由 Kilo Gateway 管理、由提供商拥有的智能路由模型。

 <Note>
-OpenClaw 将 `kilocode/kilo/auto` 视为稳定的默认引用，但不会发布该路由从任务到上游模型的、由源码支持的映射。`kilocode/kilo/auto` 背后的精确上游路由由 Kilo Gateway 负责，而不是在 OpenClaw 中硬编码。
+OpenClaw 将 `kilocode/kilo/auto` 视为稳定的默认引用，但不会发布该路由从任务到上游模型映射的源码依据。`kilocode/kilo/auto` 背后的确切上游路由由 Kilo Gateway 决定，而不是在 OpenClaw 中硬编码。
 </Note>

 ## 可用模型
@ -62,18 +62,18 @@ OpenClaw 将 `kilocode/kilo/auto` 视为稳定的默认引用，但不会发布
 OpenClaw 会在启动时从 Kilo Gateway 动态发现可用模型。使用
 `/models kilocode` 可查看你的账户可用的完整模型列表。

-Gateway 网关上可用的任何模型都可以配合 `kilocode/` 前缀使用：
+Gateway 网关上任何可用模型都可以配合 `kilocode/` 前缀使用：

 | 模型引用 | 说明 |
-| -------------------------------------- | ---------------------------------- |
+| -------- | ---- |
 | `kilocode/kilo/auto` | 默认 —— 智能路由 |
 | `kilocode/anthropic/claude-sonnet-4` | 通过 Kilo 使用 Anthropic |
 | `kilocode/openai/gpt-5.4` | 通过 Kilo 使用 OpenAI |
 | `kilocode/google/gemini-3-pro-preview` | 通过 Kilo 使用 Google |
-| ...以及更多模型 | 使用 `/models kilocode` 列出全部 |
+| ...以及更多 | 使用 `/models kilocode` 列出全部 |

 <Tip>
-在启动时，OpenClaw 会查询 `GET https://api.kilo.ai/api/gateway/models`，并将发现的模型合并到静态后备目录之前。内置后备始终包含 `kilocode/kilo/auto`（`Kilo Auto`），其配置为 `input: ["text", "image"]`、`reasoning: true`、`contextWindow: 1000000` 和 `maxTokens: 128000`。
+启动时，OpenClaw 会查询 `GET https://api.kilo.ai/api/gateway/models`，并将发现的模型合并到静态后备目录之前。内置后备目录始终包含 `kilocode/kilo/auto`（`Kilo Auto`），其参数为 `input: ["text", "image"]`、`reasoning: true`、`contextWindow: 1000000` 和 `maxTokens: 128000`。
 </Tip>

 ## 配置示例
@ -91,26 +91,26 @@ Gateway 网关上可用的任何模型都可以配合 `kilocode/` 前缀使用

 <AccordionGroup>
  <Accordion title="传输与兼容性">
-    Kilo Gateway 在源码中被记录为兼容 OpenRouter，因此它会保留在代理风格的 OpenAI 兼容路径上，而不是使用原生 OpenAI 请求塑形。
+    源码中将 Kilo Gateway 记录为兼容 OpenRouter，因此它会保留在代理风格的 OpenAI 兼容路径上，而不是使用原生 OpenAI 请求整形。

-    - 由 Gemini 支持的 Kilo 引用会保留在 proxy-Gemini 路径上，因此 OpenClaw 会继续在该路径中保留 Gemini thought-signature 清理，而不会启用原生 Gemini 重放验证或引导重写。
+    - 由 Gemini 支持的 Kilo 引用会保留在 proxy-Gemini 路径上，因此 OpenClaw 会继续在该路径执行 Gemini thought-signature 清理，而不会启用原生 Gemini 重放校验或 bootstrap 重写。
    - Kilo Gateway 在底层使用带有你的 API 密钥的 Bearer token。

  </Accordion>

  <Accordion title="流包装器与推理">
-    Kilo 的共享流包装器会添加提供商应用头，并为受支持的具体模型引用标准化代理推理负载。
+    Kilo 的共享流包装器会添加 provider app header，并为受支持的具体模型引用规范化代理推理负载。

    <Warning>
-    `kilocode/kilo/auto` 和其他不支持代理推理的提示会跳过推理注入。如果你需要推理支持，请使用具体模型引用，例如 `kilocode/anthropic/claude-sonnet-4`。
+    `kilocode/kilo/auto` 和其他不支持代理推理的提示会跳过推理注入。如果你需要推理支持，请使用具体的模型引用，例如 `kilocode/anthropic/claude-sonnet-4`。
    </Warning>

  </Accordion>

  <Accordion title="故障排除">
-    - 如果启动时模型发现失败，OpenClaw 会回退到内置的静态目录，其中包含 `kilocode/kilo/auto`。
+    - 如果模型发现过程在启动时失败，OpenClaw 会回退到包含 `kilocode/kilo/auto` 的内置静态目录。
    - 确认你的 API 密钥有效，并且你的 Kilo 账户已启用所需模型。
-    - 当 Gateway 网关以守护进程方式运行时，请确保 `KILOCODE_API_KEY` 对该进程可用（例如在 `~/.openclaw/.env` 中，或通过 `env.shellEnv`）。
+    - 当 Gateway 网关以守护进程方式运行时，确保 `KILOCODE_API_KEY` 对该进程可用（例如放在 `~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。
  </Accordion>
 </AccordionGroup>

@ -124,6 +124,6 @@ Gateway 网关上可用的任何模型都可以配合 `kilocode/` 前缀使用
    完整的 OpenClaw 配置参考。
  </Card>
  <Card title="Kilo Gateway" href="https://app.kilo.ai" icon="arrow-up-right-from-square">
-    Kilo Gateway 控制台、API 密钥和账户管理。
+    Kilo Gateway 仪表板、API 密钥和账户管理。
  </Card>
 </CardGroup>
--- a/docs/zh-CN/providers/perplexity-provider.md
+++ b/docs/zh-CN/providers/perplexity-provider.md
@ -1,14 +1,14 @@
 ---
 read_when:
    - 你想将 Perplexity 配置为 Web 搜索提供商
-    - 你需要 Perplexity API 密钥或 OpenRouter 代理设置
-summary: Perplexity Web 搜索提供商设置（API 密钥、搜索模式、筛选）
-title: Perplexity（提供商）
+    - 你需要设置 Perplexity API 密钥或 OpenRouter 代理配置
+summary: Perplexity Web 搜索提供商设置（API 密钥、搜索模式、过滤）
+title: Perplexity
 x-i18n:
-    generated_at: "2026-04-12T10:36:47Z"
+    generated_at: "2026-04-12T10:43:01Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 9a6cfa63541e875869db26e407c9433442b954933a5658f443be206a496aac83
+    source_hash: 55c089e96601ebe05480d305364272c7f0ac721caa79746297c73002a9f20f55
    source_path: providers/perplexity-provider.md
    workflow: 15
 ---
@ -18,14 +18,14 @@ x-i18n:
 Perplexity 插件通过 Perplexity Search API 或经由 OpenRouter 的 Perplexity Sonar 提供 Web 搜索能力。

 <Note>
-本页面介绍 Perplexity **提供商** 的设置。关于 Perplexity **工具**（即智能体如何使用它），请参阅 [Perplexity 工具](/zh-CN/tools/perplexity-search)。
+本页介绍 Perplexity **提供商** 的设置。关于 Perplexity **工具**（即智能体如何使用它），请参阅 [Perplexity 工具](/zh-CN/tools/perplexity-search)。
 </Note>

-| Property    | Value                                                                  |
+| 属性 | 值 |
 | ----------- | ---------------------------------------------------------------------- |
-| 类型        | Web 搜索提供商（不是模型提供商）                                       |
-| 认证        | `PERPLEXITY_API_KEY`（直连）或 `OPENROUTER_API_KEY`（通过 OpenRouter） |
-| 配置路径    | `plugins.entries.perplexity.config.webSearch.apiKey`                   |
+| 类型 | Web 搜索提供商（不是模型提供商） |
+| 凭证 | `PERPLEXITY_API_KEY`（直连）或 `OPENROUTER_API_KEY`（通过 OpenRouter） |
+| 配置路径 | `plugins.entries.perplexity.config.webSearch.apiKey` |

 ## 入门指南

@ -45,61 +45,68 @@ Perplexity 插件通过 Perplexity Search API 或经由 OpenRouter 的 Perplexit

  </Step>
  <Step title="开始搜索">
-    配置好密钥后，智能体会自动使用 Perplexity 执行 Web 搜索。无需额外步骤。
+    配置好密钥后，智能体会自动使用 Perplexity 执行 Web 搜索。无需其他额外步骤。
  </Step>
 </Steps>

 ## 搜索模式

-插件会根据 API 密钥前缀自动选择传输方式：
+该插件会根据 API 密钥前缀自动选择传输方式：

 <Tabs>
  <Tab title="原生 Perplexity API（pplx-）">
-    当你的密钥以 `pplx-` 开头时，OpenClaw 会使用原生 Perplexity Search API。此传输方式会返回结构化结果，并支持域名、语言和日期筛选（见下方筛选选项）。
+    当你的密钥以 `pplx-` 开头时，OpenClaw 会使用原生 Perplexity Search API。此传输方式会返回结构化结果，并支持域名、语言和日期过滤（见下方过滤选项）。
  </Tab>
  <Tab title="OpenRouter / Sonar（sk-or-）">
    当你的密钥以 `sk-or-` 开头时，OpenClaw 会通过 OpenRouter 路由，并使用 Perplexity Sonar 模型。此传输方式会返回带引用的 AI 综合答案。
  </Tab>
 </Tabs>

-| 密钥前缀  | 传输方式                        | 功能                               |
-| --------- | ------------------------------- | ---------------------------------- |
-| `pplx-`   | 原生 Perplexity Search API      | 结构化结果、域名/语言/日期筛选     |
-| `sk-or-`  | OpenRouter（Sonar）             | 带引用的 AI 综合答案               |
+| 密钥前缀 | 传输方式 | 功能 |
+| ---------- | ---------------------------- | ------------------------------------------------ |
+| `pplx-` | 原生 Perplexity Search API | 结构化结果、域名/语言/日期过滤 |
+| `sk-or-` | OpenRouter（Sonar） | 带引用的 AI 综合答案 |

-## 原生 API 筛选
+## 原生 API 过滤

 <Note>
-筛选选项仅在使用原生 Perplexity API（`pplx-` 密钥）时可用。OpenRouter/Sonar 搜索不支持这些参数。
+过滤选项仅在使用原生 Perplexity API 时可用
+（`pplx-` 密钥）。OpenRouter/Sonar 搜索不支持这些参数。
 </Note>

-使用原生 Perplexity API 时，搜索支持以下筛选条件：
+使用原生 Perplexity API 时，搜索支持以下过滤条件：

-| 筛选项       | 说明                                 | 示例                                |
-| ------------ | ------------------------------------ | ----------------------------------- |
-| 国家         | 2 位国家代码                         | `us`, `de`, `jp`                    |
-| 语言         | ISO 639-1 语言代码                   | `en`, `fr`, `zh`                    |
-| 日期范围     | 时间新近度窗口                       | `day`, `week`, `month`, `year`      |
-| 域名筛选     | 允许列表或拒绝列表（最多 20 个域名） | `example.com`                       |
-| 内容预算     | 每次响应 / 每个页面的 token 限制     | `max_tokens`, `max_tokens_per_page` |
+| 过滤项 | 说明 | 示例 |
+| -------------- | -------------------------------------- | ----------------------------------- |
+| 国家 | 2 位国家代码 | `us`, `de`, `jp` |
+| 语言 | ISO 639-1 语言代码 | `en`, `fr`, `zh` |
+| 日期范围 | 时间新近程度窗口 | `day`, `week`, `month`, `year` |
+| 域名过滤 | 允许列表或拒绝列表（最多 20 个域名） | `example.com` |
+| 内容预算 | 每次响应 / 每页的 token 限制 | `max_tokens`, `max_tokens_per_page` |

 ## 高级说明

 <AccordionGroup>
  <Accordion title="守护进程的环境变量">
-    如果 OpenClaw Gateway 网关以守护进程方式运行（launchd/systemd），请确保该进程可以访问 `PERPLEXITY_API_KEY`。
+    如果 OpenClaw Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保
+    `PERPLEXITY_API_KEY` 对该进程可用。

    <Warning>
-    如果密钥只设置在 `~/.profile` 中，launchd/systemd 守护进程将无法看到它，除非该环境被显式导入。请在 `~/.openclaw/.env` 中设置密钥，或通过 `env.shellEnv` 设置，以确保 Gateway 网关进程可以读取它。
+    如果密钥只设置在 `~/.profile` 中，launchd/systemd
+    守护进程将无法看到它，除非显式导入该环境。请在
+    `~/.openclaw/.env` 中设置密钥，或通过 `env.shellEnv` 设置，
+    以确保 Gateway 网关 进程能够读取它。
    </Warning>

  </Accordion>

  <Accordion title="OpenRouter 代理设置">
-    如果你更希望通过 OpenRouter 路由 Perplexity 搜索，请设置 `OPENROUTER_API_KEY`（前缀为 `sk-or-`），而不是原生 Perplexity 密钥。OpenClaw 会检测该前缀，并自动切换到 Sonar 传输方式。
+    如果你希望通过 OpenRouter 路由 Perplexity 搜索，请设置
+    `OPENROUTER_API_KEY`（前缀为 `sk-or-`），而不是原生 Perplexity 密钥。
+    OpenClaw 会检测该前缀，并自动切换到 Sonar 传输方式。

    <Tip>
-    如果你已经拥有 OpenRouter 账户，并希望在多个提供商之间统一计费，OpenRouter 传输方式会很有用。
+    如果你已经有 OpenRouter 账户，并希望将多个提供商的计费统一管理，OpenRouter 传输方式会很有用。
    </Tip>

  </Accordion>
@ -109,7 +116,7 @@ Perplexity 插件通过 Perplexity Search API 或经由 OpenRouter 的 Perplexit

 <CardGroup cols={2}>
  <Card title="Perplexity 搜索工具" href="/zh-CN/tools/perplexity-search" icon="magnifying-glass">
-    介绍智能体如何调用 Perplexity 搜索并解释结果。
+    了解智能体如何调用 Perplexity 搜索并解释结果。
  </Card>
  <Card title="配置参考" href="/zh-CN/gateway/configuration-reference" icon="gear">
    完整的配置参考，包括插件条目。