diff --git a/docs/zh-CN/providers/deepseek.md b/docs/zh-CN/providers/deepseek.md
index 85e04bdd6..cd6374a09 100644
--- a/docs/zh-CN/providers/deepseek.md
+++ b/docs/zh-CN/providers/deepseek.md
@@ -4,57 +4,99 @@ read_when:
- 你需要 API 密钥环境变量或 CLI 认证选项
summary: DeepSeek 设置（认证 + 模型选择）
x-i18n:
- generated_at: "2026-04-05T08:41:50Z"
+ generated_at: "2026-04-12T10:38:49Z"
model: gpt-5.4
provider: openai
- source_hash: 35f339ca206399496ce094eb8350e0870029ce9605121bcf86c4e9b94f3366c6
+ source_hash: 8b439c4b4cf5445db891b81d03e99f6aef5be64623e79e818763de43a2823d6d
source_path: providers/deepseek.md
workflow: 15
---
# DeepSeek
-[DeepSeek](https://www.deepseek.com) 通过与 OpenAI 兼容的 API 提供强大的 AI 模型。
+[DeepSeek](https://www.deepseek.com) 通过兼容 OpenAI 的 API 提供强大的 AI 模型。
-- 提供商：`deepseek`
-- 认证：`DEEPSEEK_API_KEY`
-- API：与 OpenAI 兼容
-- Base URL：`https://api.deepseek.com`
+| Property | Value |
+| -------- | -------------------------- |
+| 提供商 | `deepseek` |
+| 认证 | `DEEPSEEK_API_KEY` |
+| API | 兼容 OpenAI |
+| Base URL | `https://api.deepseek.com` |
-## 快速开始
+## 入门指南
-设置 API 密钥（推荐：为 Gateway 网关保存它）：
+
+
+ 在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建 API 密钥。
+
+
+ ```bash
+ openclaw onboard --auth-choice deepseek-api-key
+ ```
-```bash
-openclaw onboard --auth-choice deepseek-api-key
-```
+ 这会提示你输入 API 密钥，并将 `deepseek/deepseek-chat` 设为默认模型。
-这会提示你输入 API 密钥，并将 `deepseek/deepseek-chat` 设为默认模型。
+
+
+ ```bash
+ openclaw models list --provider deepseek
+ ```
+
+
-## 非交互式示例
+
+
+ 对于脚本化或无头安装，直接传入所有标志：
-```bash
-openclaw onboard --non-interactive \
- --mode local \
- --auth-choice deepseek-api-key \
- --deepseek-api-key "$DEEPSEEK_API_KEY" \
- --skip-health \
- --accept-risk
-```
+ ```bash
+ openclaw onboard --non-interactive \
+ --mode local \
+ --auth-choice deepseek-api-key \
+ --deepseek-api-key "$DEEPSEEK_API_KEY" \
+ --skip-health \
+ --accept-risk
+ ```
-## 环境说明
+
+
-如果 Gateway 网关作为守护进程运行（launchd/systemd），请确保 `DEEPSEEK_API_KEY`
-对该进程可用（例如放在 `~/.openclaw/.env` 中，或通过
-`env.shellEnv` 提供）。
+
+如果 Gateway 网关 以守护进程方式运行（launchd/systemd），请确保 `DEEPSEEK_API_KEY`
+对该进程可用（例如，在 `~/.openclaw/.env` 中或通过
+`env.shellEnv`）。
+
## 内置目录
-| 模型引用 | 名称 | 输入 | 上下文 | 最大输出 | 说明 |
-| ---------------------------- | ----------------- | ---- | --------- | ---------- | ------------------------------------------------- |
-| `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 表面 |
+| 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 表层 |
-当前，这两个内置模型在源中都声明支持流式使用量兼容性。
+
+源码中，这两个内置模型目前都声明支持流式传输用法兼容性。
+
-请在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 获取你的 API 密钥。
+## 配置示例
+
+```json5
+{
+ env: { DEEPSEEK_API_KEY: "sk-..." },
+ agents: {
+ defaults: {
+ model: { primary: "deepseek/deepseek-chat" },
+ },
+ },
+}
+```
+
+## 相关内容
+
+
+
+ 选择提供商、模型引用和故障转移行为。
+
+
+ agents、模型和提供商的完整配置参考。
+
+
diff --git a/docs/zh-CN/providers/nvidia.md b/docs/zh-CN/providers/nvidia.md
index 1b2c2cd46..ced7d31f9 100644
--- a/docs/zh-CN/providers/nvidia.md
+++ b/docs/zh-CN/providers/nvidia.md
@@ -2,34 +2,45 @@
read_when:
- 你想在 OpenClaw 中免费使用开放模型
- 你需要设置 `NVIDIA_API_KEY`
-summary: 在 OpenClaw 中使用 NVIDIA 兼容 OpenAI 的 API
+summary: 在 OpenClaw 中使用 NVIDIA 的 OpenAI 兼容 API
title: NVIDIA
x-i18n:
- generated_at: "2026-04-07T14:49:07Z"
+ generated_at: "2026-04-12T10:38:49Z"
model: gpt-5.4
provider: openai
- source_hash: b00f8cedaf223a33ba9f6a6dd8cf066d88cebeea52d391b871e435026182228a
+ source_hash: 45048037365138141ee82cefa0c0daaf073a1c2ae3aa7b23815f6ca676fc0d3e
source_path: providers/nvidia.md
workflow: 15
---
# NVIDIA
-NVIDIA 提供了一个兼容 OpenAI 的 API：`https://integrate.api.nvidia.com/v1`，可免费用于开放模型。使用来自 [build.nvidia.com](https://build.nvidia.com/settings/api-keys) 的 API 密钥进行身份验证。
+NVIDIA 在 `https://integrate.api.nvidia.com/v1` 提供 OpenAI 兼容 API，可免费用于开放模型。请使用来自 [build.nvidia.com](https://build.nvidia.com/settings/api-keys) 的 API 密钥进行身份验证。
-## CLI 设置
+## 入门指南
-导出一次密钥，然后运行新手引导并设置一个 NVIDIA 模型：
+
+
+ 在 [build.nvidia.com](https://build.nvidia.com/settings/api-keys) 创建 API 密钥。
+
+
+ ```bash
+ export NVIDIA_API_KEY="nvapi-..."
+ openclaw onboard --auth-choice skip
+ ```
+
+
+ ```bash
+ openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b
+ ```
+
+
-```bash
-export NVIDIA_API_KEY="nvapi-..."
-openclaw onboard --auth-choice skip
-openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b
-```
+
+如果你传递 `--token` 而不是使用环境变量，该值会进入 shell 历史记录和 `ps` 输出。在可能的情况下，优先使用 `NVIDIA_API_KEY` 环境变量。
+
-如果你仍然传递 `--token`，请记住它会出现在 shell 历史记录和 `ps` 输出中；尽可能优先使用环境变量。
-
-## 配置片段
+## 配置示例
```json5
{
@@ -50,17 +61,42 @@ openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b
}
```
-## 模型 ID
+## 内置目录
-| Model ref | 名称 | 上下文长度 | 最大输出 |
-| ------------------------------------------ | ---------------------------- | ---------- | -------- |
-| `nvidia/nvidia/nemotron-3-super-120b-a12b` | NVIDIA Nemotron 3 Super 120B | 262,144 | 8,192 |
-| `nvidia/moonshotai/kimi-k2.5` | Kimi K2.5 | 262,144 | 8,192 |
-| `nvidia/minimaxai/minimax-m2.5` | Minimax M2.5 | 196,608 | 8,192 |
-| `nvidia/z-ai/glm5` | GLM 5 | 202,752 | 8,192 |
+| Model ref | 名称 | 上下文 | 最大输出 |
+| ------------------------------------------ | ---------------------------- | ------ | -------- |
+| `nvidia/nvidia/nemotron-3-super-120b-a12b` | NVIDIA Nemotron 3 Super 120B | 262,144 | 8,192 |
+| `nvidia/moonshotai/kimi-k2.5` | Kimi K2.5 | 262,144 | 8,192 |
+| `nvidia/minimaxai/minimax-m2.5` | Minimax M2.5 | 196,608 | 8,192 |
+| `nvidia/z-ai/glm5` | GLM 5 | 202,752 | 8,192 |
-## 注意事项
+## 高级说明
-- 兼容 OpenAI 的 `/v1` 端点；使用来自 [build.nvidia.com](https://build.nvidia.com/) 的 API 密钥。
-- 设置 `NVIDIA_API_KEY` 后，提供商会自动启用。
-- 内置目录是静态的；费用在源码中默认设为 `0`。
+
+
+ 当设置了 `NVIDIA_API_KEY` 环境变量时，提供商会自动启用。除该密钥外，不需要任何显式的提供商配置。
+
+
+
+ 内置目录是静态的。由于 NVIDIA 当前为所列模型提供免费 API 访问，因此源码中的费用默认值为 `0`。
+
+
+
+ NVIDIA 使用标准的 `/v1` completions 端点。任何 OpenAI 兼容工具都应该可以直接配合 NVIDIA base URL 开箱即用。
+
+
+
+
+NVIDIA 模型当前可免费使用。请查看 [build.nvidia.com](https://build.nvidia.com/) 以获取最新的可用性和速率限制详情。
+
+
+## 相关内容
+
+
+
+ 选择提供商、模型引用和故障切换行为。
+
+
+ agents、models 和 providers 的完整配置参考。
+
+
diff --git a/docs/zh-CN/providers/opencode-go.md b/docs/zh-CN/providers/opencode-go.md
index 2b916d057..9d684e0a4 100644
--- a/docs/zh-CN/providers/opencode-go.md
+++ b/docs/zh-CN/providers/opencode-go.md
@@ -1,39 +1,77 @@
---
read_when:
- - 你想使用 OpenCode Go 目录
- - 你需要了解 Go 托管模型的运行时模型引用
-summary: 使用共享的 OpenCode 设置来使用 OpenCode Go 目录
+ - 你想要 OpenCode Go 目录
+ - 你需要 Go 托管模型的运行时模型引用
+summary: 使用共享的 OpenCode 设置配合 OpenCode Go 目录
title: OpenCode Go
x-i18n:
- generated_at: "2026-03-16T06:26:48Z"
- model: gpt-5.4
- provider: openai
- source_hash: 8650af7c64220c14bab8c22472fff8bebd7abde253e972b6a11784ad833d321c
- source_path: providers/opencode-go.md
- workflow: 15
+ generated_at: "2026-04-12T10:38:50Z"
+ model: gpt-5.4
+ provider: openai
+ source_hash: d1f0f182de81729616ccc19125d93ba0445de2349daf7067b52e8c15b9d3539c
+ source_path: providers/opencode-go.md
+ workflow: 15
---
# OpenCode Go
-OpenCode Go 是 [OpenCode](/providers/opencode) 中的 Go 目录。
-它使用与 Zen 目录相同的 `OPENCODE_API_KEY`，但保留运行时
-提供商 id `opencode-go`，以便上游按模型路由保持正确。
+OpenCode Go 是 [OpenCode](/zh-CN/providers/opencode) 中的 Go 目录。
+它使用与 Zen 目录相同的 `OPENCODE_API_KEY`，但保留运行时提供商 id `opencode-go`，这样上游的按模型路由就能保持正确。
+
+| 属性 | 值 |
+| ---------------- | ------------------------------- |
+| 运行时提供商 | `opencode-go` |
+| 认证 | `OPENCODE_API_KEY` |
+| 上级设置 | [OpenCode](/zh-CN/providers/opencode) |
## 支持的模型
-- `opencode-go/kimi-k2.5`
-- `opencode-go/glm-5`
-- `opencode-go/minimax-m2.5`
+| 模型引用 | 名称 |
+| -------------------------- | ------------ |
+| `opencode-go/kimi-k2.5` | Kimi K2.5 |
+| `opencode-go/glm-5` | GLM 5 |
+| `opencode-go/minimax-m2.5` | MiniMax M2.5 |
-## CLI 设置
+## 入门指南
-```bash
-openclaw onboard --auth-choice opencode-go
-# 或非交互式
-openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
-```
+
+
+
+
+ ```bash
+ openclaw onboard --auth-choice opencode-go
+ ```
+
+
+ ```bash
+ openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.5"
+ ```
+
+
+ ```bash
+ openclaw models list --provider opencode-go
+ ```
+
+
+
-## 配置片段
+
+
+
+ ```bash
+ openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
+ ```
+
+
+ ```bash
+ openclaw models list --provider opencode-go
+ ```
+
+
+
+
+
+## 配置示例
```json5
{
@@ -42,11 +80,34 @@ openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
}
```
-## 路由行为
+## 高级说明
-当模型引用使用 `opencode-go/...` 时，OpenClaw 会自动处理按模型路由。
+
+
+ 当模型引用使用 `opencode-go/...` 时，OpenClaw 会自动处理按模型路由。无需额外的提供商配置。
+
-## 说明
+
+ 运行时引用保持显式：Zen 使用 `opencode/...`，Go 使用 `opencode-go/...`。
+ 这样可以在两个目录之间保持上游按模型路由正确无误。
+
-- 共享的新手引导和目录概览请使用 [OpenCode](/providers/opencode)。
-- 运行时引用保持显式：Zen 使用 `opencode/...`，Go 使用 `opencode-go/...`。
+
+ Zen 和 Go 目录都使用同一个 `OPENCODE_API_KEY`。在设置期间输入该密钥后，会为这两个运行时提供商都存储凭证。
+
+
+
+
+有关共享新手引导概览以及完整的 Zen + Go 目录参考，请参阅 [OpenCode](/zh-CN/providers/opencode)。
+
+
+## 相关内容
+
+
+
+ 共享新手引导、目录概览和高级说明。
+
+
+ 选择提供商、模型引用和故障转移行为。
+
+
diff --git a/docs/zh-CN/providers/openrouter.md b/docs/zh-CN/providers/openrouter.md
index a10ea352a..dae8e5e5c 100644
--- a/docs/zh-CN/providers/openrouter.md
+++ b/docs/zh-CN/providers/openrouter.md
@@ -1,29 +1,44 @@
---
read_when:
- - 你想用一个 API 密钥访问许多 LLM
- - 你想在 OpenClaw 中通过 OpenRouter 运行模型
-summary: 在 OpenClaw 中使用 OpenRouter 的统一 API 访问许多模型
+ - 你想用一个 API 密钥访问多个 LLM】【。
+ - 你想在 OpenClaw 中通过 OpenRouter 运行模型】【。
+summary: 使用 OpenRouter 的统一 API 在 OpenClaw 中访问多种模型
title: OpenRouter
x-i18n:
- generated_at: "2026-04-05T10:06:32Z"
+ generated_at: "2026-04-12T10:38:57Z"
model: gpt-5.4
provider: openai
- source_hash: 8dd354ba060bcb47724c89ae17c8e2af8caecac4bd996fcddb584716c1840b87
+ source_hash: 9083c30b9e9846a9d4ef071c350576d4c3083475f4108871eabbef0b9bb9a368
source_path: providers/openrouter.md
workflow: 15
---
# OpenRouter
-OpenRouter 提供了一个**统一 API**，可通过单个端点和 API 密钥将请求路由到许多模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。
+OpenRouter 提供了一个**统一 API**，可通过单个端点和 API 密钥将请求路由到多种模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换基础 URL 即可使用。
-## CLI 设置
+## 入门指南
-```bash
-openclaw onboard --auth-choice openrouter-api-key
-```
+
+
+ 在 [openrouter.ai/keys](https://openrouter.ai/keys) 创建一个 API 密钥。
+
+
+ ```bash
+ openclaw onboard --auth-choice openrouter-api-key
+ ```
+
+
+ 新手引导默认使用 `openrouter/auto`。你稍后可以选择一个具体模型：
-## 配置片段
+ ```bash
+ openclaw models set openrouter//
+ ```
+
+
+
+
+## 配置示例
```json5
{
@@ -36,30 +51,59 @@ openclaw onboard --auth-choice openrouter-api-key
}
```
-## 说明
+## 模型引用
-- 模型引用格式为 `openrouter//`。
-- 新手引导默认使用 `openrouter/auto`。稍后可通过
- `openclaw models set openrouter//` 切换到具体模型。
-- 如需更多模型/提供商选项，请参见 [/concepts/model-providers](/zh-CN/concepts/model-providers)。
-- OpenRouter 在底层使用你的 API 密钥作为 Bearer token。
-- 对于真实的 OpenRouter 请求（`https://openrouter.ai/api/v1`），OpenClaw 还会
- 添加 OpenRouter 文档中说明的应用归因请求头：
- `HTTP-Referer: https://openclaw.ai`、`X-OpenRouter-Title: OpenClaw` 和
- `X-OpenRouter-Categories: cli-agent`。
-- 在已验证的 OpenRouter 路由上，Anthropic 模型引用还会保留
- OpenRouter 专用的 Anthropic `cache_control` 标记，这是 OpenClaw 为了
- 更好地复用 system/developer prompt 区块上的提示词缓存而使用的。
-- 如果你将 OpenRouter 提供商重定向到其他代理/base URL，OpenClaw
- 不会注入这些 OpenRouter 专用请求头或 Anthropic 缓存标记。
-- OpenRouter 仍通过代理式的 OpenAI 兼容路径运行，因此
- 原生 OpenAI 专有的请求整形能力，例如 `serviceTier`、Responses `store`、
- OpenAI reasoning-compat 负载和提示词缓存提示，都不会被转发。
-- 由 Gemini 支持的 OpenRouter 引用会保留在 proxy-Gemini 路径上：OpenClaw 会在该路径中保留
- Gemini thought-signature 清理，但不会启用原生 Gemini
- 重放校验或 bootstrap 重写。
-- 在受支持的非 `auto` 路由上，OpenClaw 会将所选的思考级别映射为
- OpenRouter 代理 reasoning 负载。不受支持的模型提示以及
- `openrouter/auto` 会跳过该 reasoning 注入。
-- 如果你在模型参数下传入 OpenRouter 提供商路由，OpenClaw 会在共享流包装器运行之前
- 将其作为 OpenRouter 路由元数据进行转发。
+
+模型引用遵循 `openrouter//` 模式。完整的可用提供商和模型列表，请参阅 [/concepts/model-providers](/zh-CN/concepts/model-providers)。
+
+
+## 身份验证和请求头
+
+OpenRouter 在底层使用你的 API 密钥作为 Bearer token。
+
+对于真实的 OpenRouter 请求（`https://openrouter.ai/api/v1`），OpenClaw 还会添加 OpenRouter 文档中说明的应用归因请求头：
+
+| Header | Value |
+| ------------------------- | --------------------- |
+| `HTTP-Referer` | `https://openclaw.ai` |
+| `X-OpenRouter-Title` | `OpenClaw` |
+| `X-OpenRouter-Categories` | `cli-agent` |
+
+
+如果你将 OpenRouter 提供商重新指向其他代理或基础 URL，OpenClaw **不会**注入这些 OpenRouter 特有的请求头或 Anthropic 缓存标记。
+
+
+## 高级说明
+
+
+
+ 在经过验证的 OpenRouter 路由上，Anthropic 模型引用会保留 OpenClaw 使用的 OpenRouter 特有 Anthropic `cache_control` 标记，以更好地复用系统 / 开发者提示块的提示缓存。
+
+
+
+ 在受支持的非 `auto` 路由上，OpenClaw 会将所选的 thinking 级别映射为 OpenRouter 代理推理负载。不受支持的模型提示和 `openrouter/auto` 会跳过该推理注入。
+
+
+
+ OpenRouter 仍然通过代理式的 OpenAI 兼容路径运行，因此原生仅限 OpenAI 的请求塑形（如 `serviceTier`、Responses `store`、OpenAI 推理兼容负载和提示缓存提示）不会被转发。
+
+
+
+ 由 Gemini 支持的 OpenRouter 引用会保留在代理 Gemini 路径上：OpenClaw 会继续在那里进行 Gemini thought-signature 清理，但不会启用原生 Gemini 重放验证或引导重写。
+
+
+
+ 如果你在模型参数下传递 OpenRouter 提供商路由，OpenClaw 会在共享流包装器运行之前，将其作为 OpenRouter 路由元数据进行转发。
+
+
+
+## 相关内容
+
+
+
+ 选择提供商、模型引用和故障转移行为。
+
+
+ agents、模型和提供商的完整配置参考。
+
+