diff --git a/docs/zh-CN/providers/deepseek.md b/docs/zh-CN/providers/deepseek.md index cd6374a09..92d942d19 100644 --- 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` | ## 入门指南 - 在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建 API 密钥。 + 在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建一个 API 密钥。 ```bash @@ -46,7 +47,7 @@ x-i18n: - 对于脚本化或无头安装，直接传入所有标志： + 对于脚本化或无头安装，请直接传递所有标志： ```bash openclaw onboard --non-interactive \ @@ -61,20 +62,20 @@ x-i18n: -如果 Gateway 网关 以守护进程方式运行（launchd/systemd），请确保 `DEEPSEEK_API_KEY` -对该进程可用（例如，在 `~/.openclaw/.env` 中或通过 +如果 Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保 `DEEPSEEK_API_KEY` +可供该进程使用（例如，在 `~/.openclaw/.env` 中，或通过 `env.shellEnv`）。 ## 内置目录 -| 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 表面 | -源码中，这两个内置模型目前都声明支持流式传输用法兼容性。 +源码中当前将这两个内置模型都声明为兼容流式传输用法。 ## 配置示例 diff --git a/docs/zh-CN/providers/fireworks.md b/docs/zh-CN/providers/fireworks.md index 27852a4d0..b976452f0 100644 --- 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 入门模型设为默认值。 - + ```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 上默认内置的入门模型 | -如果 Fireworks 发布了更新的模型，例如新的 Qwen 或 Gemma 版本，你可以直接使用其 Fireworks 模型 ID 切换到该模型，而无需等待内置目录更新。 +如果 Fireworks 发布了更新的模型，例如新的 Qwen 或 Gemma 版本，你可以直接使用其 Fireworks 模型 id 切换过去，而无需等待内置目录更新。 -## 自定义 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 显示的精确 ``` - - OpenClaw 中的每个 Fireworks 模型引用都以 `fireworks/` 开头，后面跟 Fireworks 平台中的精确 ID 或路由路径。例如： + + OpenClaw 中的每个 Fireworks 模型引用都以 `fireworks/` 开头，后面跟着 Fireworks 平台中的精确 id 或路由路径。例如： - 路由模型：`fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` - 直接模型：`fireworks/accounts/fireworks/models/` @@ -92,11 +93,11 @@ OpenClaw 也接受动态 Fireworks 模型 ID。使用 Fireworks 显示的精确 - - 如果 Gateway 网关 运行在你的交互式 shell 之外，请确保 `FIREWORKS_API_KEY` 对该进程同样可用。 + + 如果 Gateway 网关 运行在你的交互式 shell 之外，请确保 `FIREWORKS_API_KEY` 对该进程也可用。 - 如果密钥只存在于 `~/.profile` 中，那么对于 `launchd`/`systemd` 守护进程不会有帮助，除非该环境变量也被导入到那里。请在 `~/.openclaw/.env` 中设置该密钥，或通过 `env.shellEnv` 设置，以确保 Gateway 网关 进程能够读取它。 + 如果密钥只存在于 `~/.profile` 中，那么除非该环境变量也被导入到那里，否则它无法帮助 launchd/systemd 守护进程。请在 `~/.openclaw/.env` 中设置该密钥，或通过 `env.shellEnv` 设置，以确保 Gateway 网关 进程可以读取它。 @@ -106,9 +107,9 @@ OpenClaw 也接受动态 Fireworks 模型 ID。使用 Fireworks 显示的精确 - 选择提供商、模型引用和故障切换行为。 + 选择提供商、模型引用和故障转移行为。 - 常见的故障排除和常见问题。 + 常规故障排除和常见问题。 diff --git a/docs/zh-CN/providers/glm.md b/docs/zh-CN/providers/glm.md index 781404a34..d67f00a75 100644 --- 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 平台使用。 ## 入门指南 - + 选择与你的 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" ``` - + ```bash openclaw models list --provider zai ``` @@ -63,14 +63,14 @@ GLM 是一个**模型家族**（不是公司），可通过 Z.AI 平台使用。 ``` -`zai-api-key` 允许 OpenClaw 根据密钥自动检测匹配的 Z.AI 端点， -并自动应用正确的基础 URL。当你想强制使用特定的 Coding Plan 或通用 API -接口时，请使用显式地区选项。 +`zai-api-key` 会让 OpenClaw 根据密钥自动检测匹配的 Z.AI 端点， +并自动应用正确的基础 URL。如果你想强制使用特定的 Coding Plan 或通用 API 端点， +请使用显式地区选项。 -## 内置的 GLM 模型 +## 内置 GLM 模型 -OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用： +OpenClaw 目前为内置 `zai` 提供商预置了这些 GLM 引用： | 模型 | 模型 | | --------------- | ---------------- | @@ -84,8 +84,8 @@ OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用： | `glm-4.5v` | | -默认的内置模型引用是 `zai/glm-5.1`。GLM 版本和可用性可能会发生变化； -请查看 Z.AI 的文档以获取最新信息。 +默认的内置模型引用是 `zai/glm-5.1`。GLM 版本和可用性 +可能会变化；请查看 Z.AI 的文档以获取最新信息。 ## 高级说明 @@ -95,12 +95,12 @@ OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用： 当你使用 `zai-api-key` 凭证选项时，OpenClaw 会检查密钥格式， 以确定正确的 Z.AI 基础 URL。显式地区选项 （`zai-coding-global`、`zai-coding-cn`、`zai-global`、`zai-cn`）会覆盖 - 自动检测，并直接固定端点。 + 自动检测并直接固定端点。 - GLM 模型由 `zai` 运行时提供商提供。有关完整的提供商配置、 - 地区端点和其他功能，请参阅 + GLM 模型由 `zai` 运行时提供商提供。有关完整的提供商 + 配置、地区端点和其他功能，请参阅 [Z.AI 提供商文档](/zh-CN/providers/zai)。 @@ -112,6 +112,6 @@ OpenClaw 当前为内置 `zai` 提供商预置了这些 GLM 引用： 完整的 Z.AI 提供商配置和地区端点。 - 选择提供商、模型引用和故障切换行为。 + 选择提供商、模型引用和故障转移行为。 diff --git a/docs/zh-CN/providers/kilocode.md b/docs/zh-CN/providers/kilocode.md index baa0f9687..54517c0ec 100644 --- 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 密钥将 - 前往 [app.kilo.ai](https://app.kilo.ai)，登录或创建账户，然后进入 API Keys 并生成一个新密钥。 + 前往 [app.kilo.ai](https://app.kilo.ai)，登录或创建账户，然后导航到 API Keys 并生成一个新密钥。 ```bash @@ -42,7 +42,7 @@ Kilo Gateway 提供一个**统一 API**，可通过单个端点和 API 密钥将 ``` - + ```bash openclaw models list --provider kilocode ``` @@ -51,10 +51,10 @@ Kilo Gateway 提供一个**统一 API**，可通过单个端点和 API 密钥将 ## 默认模型 -默认模型是 `kilocode/kilo/auto`，这是一个由提供商拥有的智能路由模型，由 Kilo Gateway 管理。 +默认模型是 `kilocode/kilo/auto`，这是一个由 Kilo Gateway 管理、由提供商拥有的智能路由模型。 -OpenClaw 将 `kilocode/kilo/auto` 视为稳定的默认引用，但不会发布该路由从任务到上游模型的、由源码支持的映射。`kilocode/kilo/auto` 背后的精确上游路由由 Kilo Gateway 负责，而不是在 OpenClaw 中硬编码。 +OpenClaw 将 `kilocode/kilo/auto` 视为稳定的默认引用，但不会发布该路由从任务到上游模型映射的源码依据。`kilocode/kilo/auto` 背后的确切上游路由由 Kilo Gateway 决定，而不是在 OpenClaw 中硬编码。 ## 可用模型 @@ -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` 列出全部 | -在启动时，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`。 ## 配置示例 @@ -91,26 +91,26 @@ Gateway 网关上可用的任何模型都可以配合 `kilocode/` 前缀使用 - 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。 - Kilo 的共享流包装器会添加提供商应用头，并为受支持的具体模型引用标准化代理推理负载。 + Kilo 的共享流包装器会添加 provider app header，并为受支持的具体模型引用规范化代理推理负载。 - `kilocode/kilo/auto` 和其他不支持代理推理的提示会跳过推理注入。如果你需要推理支持，请使用具体模型引用，例如 `kilocode/anthropic/claude-sonnet-4`。 + `kilocode/kilo/auto` 和其他不支持代理推理的提示会跳过推理注入。如果你需要推理支持，请使用具体的模型引用，例如 `kilocode/anthropic/claude-sonnet-4`。 - - 如果启动时模型发现失败，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` 提供）。 @@ -124,6 +124,6 @@ Gateway 网关上可用的任何模型都可以配合 `kilocode/` 前缀使用 完整的 OpenClaw 配置参考。 - Kilo Gateway 控制台、API 密钥和账户管理。 + Kilo Gateway 仪表板、API 密钥和账户管理。 diff --git a/docs/zh-CN/providers/perplexity-provider.md b/docs/zh-CN/providers/perplexity-provider.md index 19f36a278..04fec1a17 100644 --- 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 搜索能力。 -本页面介绍 Perplexity **提供商** 的设置。关于 Perplexity **工具**（即智能体如何使用它），请参阅 [Perplexity 工具](/zh-CN/tools/perplexity-search)。 +本页介绍 Perplexity **提供商** 的设置。关于 Perplexity **工具**（即智能体如何使用它），请参阅 [Perplexity 工具](/zh-CN/tools/perplexity-search)。 -| 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 - 配置好密钥后，智能体会自动使用 Perplexity 执行 Web 搜索。无需额外步骤。 + 配置好密钥后，智能体会自动使用 Perplexity 执行 Web 搜索。无需其他额外步骤。 ## 搜索模式 -插件会根据 API 密钥前缀自动选择传输方式： +该插件会根据 API 密钥前缀自动选择传输方式： - 当你的密钥以 `pplx-` 开头时，OpenClaw 会使用原生 Perplexity Search API。此传输方式会返回结构化结果，并支持域名、语言和日期筛选（见下方筛选选项）。 + 当你的密钥以 `pplx-` 开头时，OpenClaw 会使用原生 Perplexity Search API。此传输方式会返回结构化结果，并支持域名、语言和日期过滤（见下方过滤选项）。 当你的密钥以 `sk-or-` 开头时，OpenClaw 会通过 OpenRouter 路由，并使用 Perplexity Sonar 模型。此传输方式会返回带引用的 AI 综合答案。 -| 密钥前缀 | 传输方式 | 功能 | -| --------- | ------------------------------- | ---------------------------------- | -| `pplx-` | 原生 Perplexity Search API | 结构化结果、域名/语言/日期筛选 | -| `sk-or-` | OpenRouter（Sonar） | 带引用的 AI 综合答案 | +| 密钥前缀 | 传输方式 | 功能 | +| ---------- | ---------------------------- | ------------------------------------------------ | +| `pplx-` | 原生 Perplexity Search API | 结构化结果、域名/语言/日期过滤 | +| `sk-or-` | OpenRouter（Sonar） | 带引用的 AI 综合答案 | -## 原生 API 筛选 +## 原生 API 过滤 -筛选选项仅在使用原生 Perplexity API（`pplx-` 密钥）时可用。OpenRouter/Sonar 搜索不支持这些参数。 +过滤选项仅在使用原生 Perplexity API 时可用 +（`pplx-` 密钥）。OpenRouter/Sonar 搜索不支持这些参数。 -使用原生 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` | ## 高级说明 - 如果 OpenClaw Gateway 网关以守护进程方式运行（launchd/systemd），请确保该进程可以访问 `PERPLEXITY_API_KEY`。 + 如果 OpenClaw Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保 + `PERPLEXITY_API_KEY` 对该进程可用。 - 如果密钥只设置在 `~/.profile` 中，launchd/systemd 守护进程将无法看到它，除非该环境被显式导入。请在 `~/.openclaw/.env` 中设置密钥，或通过 `env.shellEnv` 设置，以确保 Gateway 网关进程可以读取它。 + 如果密钥只设置在 `~/.profile` 中，launchd/systemd + 守护进程将无法看到它，除非显式导入该环境。请在 + `~/.openclaw/.env` 中设置密钥，或通过 `env.shellEnv` 设置， + 以确保 Gateway 网关 进程能够读取它。 - 如果你更希望通过 OpenRouter 路由 Perplexity 搜索，请设置 `OPENROUTER_API_KEY`（前缀为 `sk-or-`），而不是原生 Perplexity 密钥。OpenClaw 会检测该前缀，并自动切换到 Sonar 传输方式。 + 如果你希望通过 OpenRouter 路由 Perplexity 搜索，请设置 + `OPENROUTER_API_KEY`（前缀为 `sk-or-`），而不是原生 Perplexity 密钥。 + OpenClaw 会检测该前缀，并自动切换到 Sonar 传输方式。 - 如果你已经拥有 OpenRouter 账户，并希望在多个提供商之间统一计费，OpenRouter 传输方式会很有用。 + 如果你已经有 OpenRouter 账户，并希望将多个提供商的计费统一管理，OpenRouter 传输方式会很有用。 @@ -109,7 +116,7 @@ Perplexity 插件通过 Perplexity Search API 或经由 OpenRouter 的 Perplexit - 介绍智能体如何调用 Perplexity 搜索并解释结果。 + 了解智能体如何调用 Perplexity 搜索并解释结果。 完整的配置参考，包括插件条目。