farcasclaudiu/openclaw
1
0
Fork 0
mirror of https://github.com/farcasclaudiu/openclaw.git synced 2026-06-29 15:01:48 +03:00
Code Issues Packages Projects Releases Wiki Activity

Docs: update zh-CN translations and pipeline

Browse Source 
What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/zh-CN/providers/anthropic.md
+30 -29
View File
@@ -1,11 +1,11 @@
---
read_when:
- 你想在 OpenClaw 中使用 Anthropic 模型
- 你想使用 setup-token 而非 API 密钥
- 你想使用 setup-token 而不是 API 密钥
summary: 在 OpenClaw 中通过 API 密钥或 setup-token 使用 Anthropic Claude
title: Anthropic
x-i18n:
generated_at: "2026-02-01T21:34:53Z"
generated_at: "2026-02-03T10:08:33Z"
model: claude-opus-4-5
provider: pi
source_hash: a78ccd855810a93e71d7138af4d3fc7d66e877349815c4a3207cf2214b0150b3
@@ -13,14 +13,14 @@ x-i18n:
workflow: 15
---
# Anthropic (Claude)
# Anthropic（Claude）
Anthropic 开发了 **Claude** 模型系列，并通过 API 提供访问。
Anthropic 构建了 **Claude** 模型系列，并通过 API 提供访问。
在 OpenClaw 中，你可以使用 API 密钥或 **setup-token** 进行认证。
## 方案 A：Anthropic API 密钥
## 选项 A：Anthropic API 密钥
**适用于：** 标准 API 访问和按量计费。
**适用于：** 标准 API 访问和按用量计费。
在 Anthropic Console 中创建你的 API 密钥。
### CLI 设置
@@ -44,7 +44,7 @@ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
## 提示缓存（Anthropic API）
OpenClaw 支持 Anthropic 的提示缓存功能。此功能**仅限 API**；订阅认证不支持缓存设置。
OpenClaw 支持 Anthropic 的提示缓存功能。这是**仅限 API**；订阅认证不支持缓存设置。
### 配置
@@ -52,7 +52,7 @@ OpenClaw 支持 Anthropic 的提示缓存功能。此功能**仅限 API**；订
| 值 | 缓存时长 | 描述 |
| ------- | -------- | -------------------------- |
| `none` | 不缓存 | 禁用提示缓存 |
| `none` | 无缓存 | 禁用提示缓存 |
| `short` | 5 分钟 | API 密钥认证的默认值 |
| `long` | 1 小时 | 扩展缓存（需要 beta 标志） |
@@ -72,38 +72,39 @@ OpenClaw 支持 Anthropic 的提示缓存功能。此功能**仅限 API**；订
### 默认值
使用 Anthropic API 密钥认证时，OpenClaw 会自动为所有 Anthropic 模型应用 `cacheRetention: "short"`（5 分钟缓存）。你可以在配置中显式设置 `cacheRetention` 来覆盖此默认值。
使用 Anthropic API 密钥认证时，OpenClaw 会自动为所有 Anthropic 模型应用 `cacheRetention: "short"`（5 分钟缓存）。你可以通过在配置中显式设置 `cacheRetention` 来覆盖此设置。
### 旧版参数
旧的 `cacheControlTtl` 参数仍然支持向后兼容：
为了向后兼容，仍支持旧版 `cacheControlTtl` 参数：
- `"5m"` 对应 `short`
- `"1h"` 对应 `long`
- `"5m"` 映射到 `short`
- `"1h"` 映射到 `long`
我们建议迁移到新的 `cacheRetention` 参数。
OpenClaw 在 Anthropic API 请求中包含了 `extended-cache-ttl-2025-04-11` beta 标志；如果你覆盖了提供商请求头，请保留此标志（参见 [/gateway/configuration](/gateway/configuration)）。
OpenClaw 在 Anthropic API 请求中包含 `extended-cache-ttl-2025-04-11` beta 标志；
如果你覆盖提供商头信息，请保留它（参见 [/gateway/configuration](/gateway/configuration)）。
## 方案 B：Claude setup-token
## 选项 B：Claude setup-token
**适用于：** 使用你的 Claude 订阅。
### 如何获取 setup-token
### 在哪里获取 setup-token
Setup-token 由 **Claude Code CLI** 创建，而非 Anthropic Console。你可以在**任何机器**上运行：
setup-token 由 **Claude Code CLI** 创建，而不是 Anthropic Console。你可以在**任何机器**上运行：
```bash
claude setup-token
```
将令牌粘贴到 OpenClaw 中（向导中选择：**Anthropic token (paste setup-token)**），或在 Gateway网关主机上运行：
将令牌粘贴到 OpenClaw（向导：**Anthropic token (paste setup-token)**），或在 Gateway 网关主机上运行：
```bash
openclaw models auth setup-token --provider anthropic
```
如果你在其他机器上生成了令牌，请粘贴：
如果你在不同的机器上生成了令牌，请粘贴它：
```bash
openclaw models auth paste-token --provider anthropic
@@ -112,7 +113,7 @@ openclaw models auth paste-token --provider anthropic
### CLI 设置
```bash
# 在新手引导过程中粘贴 setup-token
# 在新手引导期间粘贴 setup-token
openclaw onboard --auth-choice setup-token
```
@@ -126,28 +127,28 @@ openclaw onboard --auth-choice setup-token
## 注意事项
- 使用 `claude setup-token` 生成令牌并粘贴，或在 Gateway网关主机上运行 `openclaw models auth setup-token`。
- 如果在 Claude 订阅上看到 "OAuth token refresh failed …" 错误，请使用 setup-token 重新认证。参见 [/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription](/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription)。
- 认证详情和重用规则请参阅 [/concepts/oauth](/concepts/oauth)。
- 使用 `claude setup-token` 生成 setup-token 并粘贴，或在 Gateway 网关主机上运行 `openclaw models auth setup-token`。
- 如果你在 Claude 订阅上看到"OAuth token refresh failed …"，请使用 setup-token 重新认证。参见 [/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription](/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription)。
- 认证详情 + 重用规则在 [/concepts/oauth](/concepts/oauth)。
## 故障排除
**401 错误 / 令牌突然失效**
**401 错误/令牌突然失效**
- Claude 订阅认证可能会过期或被撤销。重新运行 `claude setup-token`
并将其粘贴到 **Gateway网关主机**上。
- 如果 Claude CLI 登录在另一台机器上，请在 Gateway网关主机上使用
- Claude 订阅认证可能过期或被撤销。重新运行 `claude setup-token`
并将其粘贴到 **Gateway 网关主机**。
- 如果 Claude CLI 登录在不同的机器上，在 Gateway 网关主机上使用
`openclaw models auth paste-token --provider anthropic`。
**No API key found for provider "anthropic"**
- 认证是**按智能体**设置的。新智能体不会继承主智能体的密钥。
- 为该智能体重新运行新手引导，或在 Gateway网关主机上粘贴 setup-token / API 密钥，
- 认证是**按智能体**的。新智能体不会继承主智能体的密钥。
- 为该智能体重新运行新手引导，或在 Gateway 网关主机上粘贴 setup-token / API 密钥，
然后使用 `openclaw models status` 验证。
**No credentials found for profile `anthropic:default`**
- 运行 `openclaw models status` 查看当前活跃的认证配置文件。
- 运行 `openclaw models status` 查看哪个认证配置文件处于活动状态。
- 重新运行新手引导，或为该配置文件粘贴 setup-token / API 密钥。
**No available auth profile (all in cooldown/unavailable)**
docs/zh-CN/providers/index.md
+18 -17
View File
@@ -5,7 +5,7 @@ read_when:
summary: OpenClaw 支持的模型提供商（LLM）
title: 模型提供商
x-i18n:
generated_at: "2026-02-01T21:35:01Z"
generated_at: "2026-02-03T07:53:32Z"
model: claude-opus-4-5
provider: pi
source_hash: eb4a97438adcf610499253afcf8b2af6624f4be098df389a6c3746f14c4a901b
@@ -15,22 +15,22 @@ x-i18n:
# 模型提供商
OpenClaw 可以使用多种 LLM 提供商。选择一个提供商，完成认证，然后将默认模型设置为 `provider/model`。
OpenClaw 可以使用许多 LLM 提供商。选择一个提供商，进行认证，然后将默认模型设置为 `provider/model`。
在找聊天渠道文档（WhatsApp/Telegram/Discord/Slack/Mattermost（插件）/等）？请参阅[渠道](/channels)。
正在寻找聊天渠道文档（WhatsApp/Telegram/Discord/Slack/Mattermost（插件）等）？参见[渠道](/channels)。
## 推荐：Venice (Venice AI)
## 亮点：Venice（Venice AI）
Venice 是我们推荐的 Venice AI 配置方案，适合注重隐私的推理场景，并可选择使用 Opus 处理复杂任务。
Venice 是我们推荐的 Venice AI 设置，用于隐私优先的推理，并可选择使用 Opus 处理困难任务。
- 默认：`venice/llama-3.3-70b`
- 综合最佳：`venice/claude-opus-45`（Opus 仍然是最强的）
- 最佳综合：`venice/claude-opus-45`（Opus 仍然是最强的）
参阅 [Venice AI](/providers/venice)。
参见 [Venice AI](/providers/venice)。
## 快速开始
1. 向提供商进行认证（通常通过 `openclaw onboard`）。
1. 与提供商进行认证（通常通过 `openclaw onboard`）。
2. 设置默认模型：
```json5
@@ -41,27 +41,28 @@ Venice 是我们推荐的 Venice AI 配置方案，适合注重隐私的推理
## 提供商文档
- [OpenAI (API + Codex)](/providers/openai)
- [Anthropic (API + Claude Code CLI)](/providers/anthropic)
- [Qwen (OAuth)](/providers/qwen)
- [OpenAI（API + Codex）](/providers/openai)
- [Anthropic（API + Claude Code CLI）](/providers/anthropic)
- [Qwen（OAuth）](/providers/qwen)
- [OpenRouter](/providers/openrouter)
- [Vercel AI Gateway](/providers/vercel-ai-gateway)
- [Moonshot AI (Kimi + Kimi Coding)](/providers/moonshot)
- [Moonshot AI（Kimi + Kimi Coding）](/providers/moonshot)
- [OpenCode Zen](/providers/opencode)
- [Amazon Bedrock](/bedrock)
- [Z.AI](/providers/zai)
- [Xiaomi](/providers/xiaomi)
- [GLM 模型](/providers/glm)
- [MiniMax](/providers/minimax)
- [Venice (Venice AI，注重隐私)](/providers/venice)
- [Ollama (本地模型)](/providers/ollama)
- [Venice（Venice AI，注重隐私）](/providers/venice)
- [Ollama（本地模型）](/providers/ollama)
## 转录提供商
- [Deepgram (音频转录)](/providers/deepgram)
- [Deepgram（音频转录）](/providers/deepgram)
## 社区工具
- [Claude Max API 代理](/providers/claude-max-api-proxy) - 将 Claude Max/Pro 订阅用作 OpenAI 兼容的 API 端点
- [Claude Max API Proxy](/providers/claude-max-api-proxy) - 将 Claude Max/Pro 订阅作为 OpenAI 兼容的 API 端点使用
如需完整的提供商目录（xAI、Groq、Mistral 等）及高级配置，请参阅[模型提供商](/concepts/model-providers)。
有关完整的提供商目录（xAI、Groq、Mistral 等）和高级配置，
参见[模型提供商](/concepts/model-providers)。
docs/zh-CN/providers/minimax.md
+32 -32
View File
@@ -1,11 +1,11 @@
---
read_when:
- 你想在 OpenClaw 中使用 MiniMax 模型
- 你需要 MiniMax 设置指导
- 你需要 MiniMax 设置指南
summary: 在 OpenClaw 中使用 MiniMax M2.1
title: MiniMax
x-i18n:
generated_at: "2026-02-01T21:35:21Z"
generated_at: "2026-02-03T10:08:52Z"
model: claude-opus-4-5
provider: pi
source_hash: 861e1ddc3c24be88f716bfb72d6015d62875a9087f8e89ea4ba3a35f548c7fae
@@ -15,26 +15,26 @@ x-i18n:
# MiniMax
MiniMax 是一家 AI 公司，开发了 **M2/M2.1** 模型系列。当前面向编程的版本是 **MiniMax M2.1**（2025 年 12 月 23 日发布），专为现实世界的复杂任务而构建。
MiniMax 是一家构建 **M2/M2.1** 模型系列的 AI 公司。当前面向编程的版本是 **MiniMax M2.1**（2025 年 12 月 23 日），专为现实世界的复杂任务而构建。
来源：[MiniMax M2.1 发布说明](https://www.minimax.io/news/minimax-m21)
## 模型概览（M2.1）
## 模型概述（M2.1）
MiniMax 在 M2.1 中重点改进了以下方面：
MiniMax 强调 M2.1 的以下改进：
- 更强的**多语言编程**能力（Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS）。
- 更好的 **Web/应用开发**能力和更高的美观输出质量（包括原生移动端）。
- 改进的**复合指令**处理能力，适用于办公风格的工作流，基于交错思考和集成约束执行构建。
- **更简洁的回复**，更低的 token 用量和更快的迭代循环。
- 更好的 **Web/应用开发**和美观输出质量（包括原生移动端）。
- 改进的**复合指令**处理，适用于办公风格的工作流程，基于交错思考和集成约束执行。
- **更简洁的响应**，更低的 token 使用量和更快的迭代循环。
- 更强的**工具/智能体框架**兼容性和上下文管理（Claude Code、Droid/Factory AI、Cline、Kilo Code、Roo Code、BlackBox）。
- 更高质量的**对话和技术文档**输出。
- 更高质量的**对话和技术写作**输出。
## MiniMax M2.1 与 MiniMax M2.1 Lightning 对比
## MiniMax M2.1 vs MiniMax M2.1 Lightning
- **速度：** Lightning 是 MiniMax 定价文档中的"快速"变体。
- **成本：** 定价显示输入成本相同，但 Lightning 的输出成本更高。
- **编程计划路由：** Lightning 后端在 MiniMax 编程计划中无法直接使用。MiniMax 会自动将大多数请求路由到 Lightning，但在流量高峰时会回退到常规 M2.1 后端。
- **成本：** 定价显示相同的输入成本，但 Lightning 的输出成本更高。
- **编程计划路由：** Lightning 后端在 MiniMax 编程计划中不能直接使用。MiniMax 自动将大多数请求路由到 Lightning，但在流量高峰期会回退到常规 M2.1 后端。
## 选择设置方式
@@ -42,11 +42,11 @@ MiniMax 在 M2.1 中重点改进了以下方面：
**适用于：** 通过 OAuth 快速设置 MiniMax 编程计划，无需 API 密钥。
启用内置的 OAuth 插件并进行认证：
启用内置 OAuth 插件并进行认证：
```bash
openclaw plugins enable minimax-portal-auth # 如已加载则跳过
openclaw gateway restart # 如 Gateway网关已在运行则重启
openclaw plugins enable minimax-portal-auth # 如果已加载则跳过
openclaw gateway restart # 如果 Gateway 网关已在运行则重启
openclaw onboard --auth-choice minimax-portal
```
@@ -55,7 +55,7 @@ openclaw onboard --auth-choice minimax-portal
- **Global** - 国际用户（`api.minimax.io`）
- **CN** - 中国用户（`api.minimaxi.com`）
详情请参阅 [MiniMax OAuth 插件 README](https://github.com/openclaw/openclaw/tree/main/extensions/minimax-portal-auth)。
详情参见 [MiniMax OAuth 插件 README](https://github.com/openclaw/openclaw/tree/main/extensions/minimax-portal-auth)。
### MiniMax M2.1（API 密钥）
@@ -95,7 +95,7 @@ openclaw onboard --auth-choice minimax-portal
}
```
### MiniMax M2.1 作为备选（Opus 为主模型）
### MiniMax M2.1 作为备用（Opus 为主）
**适用于：** 保持 Opus 4.5 为主模型，故障时切换到 MiniMax M2.1。
@@ -117,10 +117,10 @@ openclaw onboard --auth-choice minimax-portal
}
```
### 可选：通过 LM Studio 本地运行（手动配置）
### 可选：通过 LM Studio 本地运行（手动）
**适用于：** 使用 LM Studio 进行本地推理。
我们在高性能硬件（如台式机/服务器）上使用 LM Studio 本地服务器运行 MiniMax M2.1 取得了良好效果。
我们在强大硬件（例如台式机/服务器）上使用 LM Studio 的本地服务器运行 MiniMax M2.1 时看到了出色的效果。
通过 `openclaw.json` 手动配置：
@@ -167,39 +167,39 @@ openclaw onboard --auth-choice minimax-portal
## 配置选项
- `models.providers.minimax.baseUrl`：推荐使用 `https://api.minimax.io/anthropic`（Anthropic 兼容）；`https://api.minimax.io/v1` 可选用于 OpenAI 兼容的请求格式。
- `models.providers.minimax.api`：推荐使用 `anthropic-messages`；`openai-completions` 可选用于 OpenAI 兼容的请求格式。
- `models.providers.minimax.baseUrl`：推荐使用 `https://api.minimax.io/anthropic`（Anthropic 兼容）；`https://api.minimax.io/v1` 可选用于 OpenAI 兼容的负载。
- `models.providers.minimax.api`：推荐使用 `anthropic-messages`；`openai-completions` 可选用于 OpenAI 兼容的负载。
- `models.providers.minimax.apiKey`：MiniMax API 密钥（`MINIMAX_API_KEY`）。
- `models.providers.minimax.models`：定义 `id`、`name`、`reasoning`、`contextWindow`、`maxTokens`、`cost`。
- `agents.defaults.models`：为允许列表中的模型设置别名。
- `models.mode`：如果你想将 MiniMax 与内置模型一起使用，保持 `merge`。
- `agents.defaults.models`：为你想要在允许列表中的模型设置别名。
- `models.mode`：如果你想将 MiniMax 与内置模型一起添加，保持 `merge`。
## 注意事项
- 模型引用格式为 `minimax/<model>`。
- 编程计划用量 API：`https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains`（需要编程计划密钥）。
- 如需精确成本跟踪，请更新 `models.json` 中的定价值。
- 编程计划使用量 API：`https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains`（需要编程计划密钥）。
- 如果需要精确的成本跟踪，请更新 `models.json` 中的定价值。
- MiniMax 编程计划推荐链接（9 折优惠）：https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
- 提供商规则请参阅 [/concepts/model-providers](/concepts/model-providers)。
- 使用 `openclaw models list` 和 `openclaw models set minimax/MiniMax-M2.1` 进行切换。
- 参见 [/concepts/model-providers](/concepts/model-providers) 了解提供商规则。
- 使用 `openclaw models list` 和 `openclaw models set minimax/MiniMax-M2.1` 切换模型。
## 故障排除
### "Unknown model: minimax/MiniMax-M2.1"
这通常意味着 **MiniMax 提供商未配置**（没有提供商条目，也未找到 MiniMax 认证配置文件/环境变量密钥）。此检测的修复包含在 **2026.1.12** 版本中（撰写本文时尚未发布）。修复方法：
这通常意味着 **MiniMax 提供商未配置**（没有提供商条目，也没有找到 MiniMax 认证配置文件/环境变量密钥）。此检测的修复在 **2026.1.12** 中（撰写本文时尚未发布）。修复方法：
- 升级到 **2026.1.12**（或从源码 `main` 分支运行），然后重启 Gateway网关。
- 升级到 **2026.1.12**（或从源码 `main` 分支运行），然后重启 Gateway 网关。
- 运行 `openclaw configure` 并选择 **MiniMax M2.1**，或
- 手动添加 `models.providers.minimax` 配置块，或
- 手动添加 `models.providers.minimax` 块，或
- 设置 `MINIMAX_API_KEY`（或 MiniMax 认证配置文件）以便注入提供商。
确保模型 ID **区分大小写**：
确保模型 id **区分大小写**：
- `minimax/MiniMax-M2.1`
- `minimax/MiniMax-M2.1-lightning`
然后使用以下命令重新检查：
然后重新检查：
```bash
openclaw models list
docs/zh-CN/providers/models.md
+8 -8
View File
@@ -1,11 +1,11 @@
---
read_when:
- 你想选择一个模型提供商
- 你需要 LLM 认证和模型选择的快速设置示例
- 你想要 LLM 认证 + 模型选择的快速设置示例
summary: OpenClaw 支持的模型提供商（LLM）
title: 模型提供商快速入门
x-i18n:
generated_at: "2026-02-01T21:35:02Z"
generated_at: "2026-02-03T07:53:35Z"
model: claude-opus-4-5
provider: pi
source_hash: 2f5b99207dc7860e0a7b541b61e984791f5d7ab1953b3e917365a248a09b025b
@@ -15,20 +15,20 @@ x-i18n:
# 模型提供商
OpenClaw 可以使用多种 LLM 提供商。选择一个，完成认证，然后将默认模型设置为 `provider/model` 格式。
OpenClaw 可以使用许多 LLM 提供商。选择一个，进行认证，然后将默认模型设置为 `provider/model`。
## 推荐：Venice（Venice AI）
Venice 是我们推荐的 Venice AI 配置方案，注重隐私优先的推理，并提供使用 Opus 处理最困难任务的选项。
Venice 是我们推荐的 Venice AI 设置，用于隐私优先的推理，并可选择使用 Opus 处理最困难的任务。
- 默认：`venice/llama-3.3-70b`
- 综合最佳：`venice/claude-opus-45`（Opus 仍然是最强的）
- 最佳综合：`venice/claude-opus-45`（Opus 仍然是最强的）
参见 [Venice AI](/providers/venice)。
## 快速开始（两个步骤）
1. 向提供商进行认证（通常通过 `openclaw onboard`）。
1. 与提供商认证（通常通过 `openclaw onboard`）。
2. 设置默认模型：
```json5
@@ -37,7 +37,7 @@ Venice 是我们推荐的 Venice AI 配置方案，注重隐私优先的推理
}
```
## 支持的提供商（入门集合）
## 支持的提供商（入门集）
- [OpenAI（API + Codex）](/providers/openai)
- [Anthropic（API + Claude Code CLI）](/providers/anthropic)
@@ -52,4 +52,4 @@ Venice 是我们推荐的 Venice AI 配置方案，注重隐私优先的推理
- [Venice（Venice AI）](/providers/venice)
- [Amazon Bedrock](/bedrock)
如需查看完整的提供商目录（xAI、Groq、Mistral 等）及高级配置，请参阅[模型提供商](/concepts/model-providers)。
有关完整的提供商目录（xAI、Groq、Mistral 等）和高级配置，请参阅[模型提供商](/concepts/model-providers)。
docs/zh-CN/providers/qwen.md
+11 -11
View File
@@ -1,11 +1,11 @@
---
read_when:
- 你想在 OpenClaw 中使用 Qwen
- 你想通过免费版 OAuth 访问 Qwen Coder
summary: 在 OpenClaw 中使用 Qwen OAuth（免费版）
- 你想要免费层 OAuth 访问 Qwen Coder
summary: 在 OpenClaw 中使用 Qwen OAuth（免费层）
title: Qwen
x-i18n:
generated_at: "2026-02-01T21:35:24Z"
generated_at: "2026-02-03T07:53:34Z"
model: claude-opus-4-5
provider: pi
source_hash: 88b88e224e2fecbb1ca26e24fbccdbe25609be40b38335d0451343a5da53fdd4
@@ -15,7 +15,7 @@ x-i18n:
# Qwen
Qwen 提供免费版 OAuth 流程，可访问 Qwen Coder 和 Qwen Vision 模型（每天 2,000 次请求，受 Qwen 速率限制约束）。
Qwen 为 Qwen Coder 和 Qwen Vision 模型提供免费层 OAuth 流程（每天 2,000 次请求，受 Qwen 速率限制约束）。
## 启用插件
@@ -23,7 +23,7 @@ Qwen 提供免费版 OAuth 流程，可访问 Qwen Coder 和 Qwen Vision 模型
openclaw plugins enable qwen-portal-auth
```
启用后重启 Gateway网关。
启用后重启 Gateway 网关。
## 认证
@@ -31,7 +31,7 @@ openclaw plugins enable qwen-portal-auth
openclaw models auth login --provider qwen-portal --set-default
```
这将运行 Qwen 设备码 OAuth 流程，并将提供商条目写入你的 `models.json`（同时创建一个 `qwen` 别名以便快速切换）。
这会运行 Qwen 设备码 OAuth 流程并将提供商条目写入你的 `models.json`（加上一个 `qwen` 别名以便快速切换）。
## 模型 ID
@@ -46,10 +46,10 @@ openclaw models set qwen-portal/coder-model
## 复用 Qwen Code CLI 登录
如果你已经通过 Qwen Code CLI 登录，OpenClaw 在加载认证存储时会从 `~/.qwen/oauth_creds.json` 同步凭据。你仍然需要一个 `models.providers.qwen-portal` 条目（使用上面的登录命令创建）。
如果你已经使用 Qwen Code CLI 登录，OpenClaw 会在加载认证存储时从 `~/.qwen/oauth_creds.json` 同步凭证。你仍然需要一个 `models.providers.qwen-portal` 条目（使用上面的登录命令创建一个）。
## 注意事项
## 注意
- 令牌会自动刷新；如果刷新失败或访问被撤销，请重新运行登录命令。
- 默认基础 URL：`https://portal.qwen.ai/v1`（如果 Qwen 提供了不同的端点，可通过 `models.providers.qwen-portal.baseUrl` 覆盖）。
- 有关提供商通用规则，请参阅[模型提供商](/concepts/model-providers)。
- 令牌自动刷新；如果刷新失败或访问被撤销，请重新运行登录命令。
- 默认基础 URL：`https://portal.qwen.ai/v1`（如果 Qwen 提供不同的端点，使用 `models.providers.qwen-portal.baseUrl` 覆盖）。
- 参阅[模型提供商](/concepts/model-providers)了解提供商级别的规则。
docs/zh-CN/providers/vercel-ai-gateway.md
+8 -8
View File
@@ -1,11 +1,11 @@
---
read_when:
- 你想要将 Vercel AI Gateway 与 OpenClaw 配合使用
- 你需要 API 密钥环境变量或 CLI 认证选项
- 你想将 Vercel AI Gateway 与 OpenClaw 配合使用
- 你需要 API 密钥环境变量或 CLI 认证选择
summary: Vercel AI Gateway 设置（认证 + 模型选择）
title: Vercel AI Gateway
x-i18n:
generated_at: "2026-02-01T21:36:13Z"
generated_at: "2026-02-03T07:53:39Z"
model: claude-opus-4-5
provider: pi
source_hash: c6482f047a31b09c7a691d40babbd1f9fb3aa2042b61cc42956ad9b791da8285
@@ -15,7 +15,7 @@ x-i18n:
# Vercel AI Gateway
[Vercel AI Gateway](https://vercel.com/ai-gateway) 提供统一的 API，通过单一端点访问数百个模型。
[Vercel AI Gateway](https://vercel.com/ai-gateway) 提供了一个统一的 API，通过单一端点访问数百个模型。
- 提供商：`vercel-ai-gateway`
- 认证：`AI_GATEWAY_API_KEY`
@@ -23,7 +23,7 @@ x-i18n:
## 快速开始
1. 设置 API 密钥（推荐：为 Gateway网关存储密钥）：
1. 设置 API 密钥（推荐：为 Gateway 网关存储它）：
```bash
openclaw onboard --auth-choice ai-gateway-api-key
@@ -50,8 +50,8 @@ openclaw onboard --non-interactive \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY"
```
## 环境说明
## 环境变量说明
如果 Gateway网关以守护进程（launchd/systemd）方式运行，请确保 `AI_GATEWAY_API_KEY`
如果 Gateway 网关作为守护进程运行（launchd/systemd），请确保 `AI_GATEWAY_API_KEY`
对该进程可用（例如，在 `~/.openclaw/.env` 中或通过
`env.shellEnv` 设置）。
`env.shellEnv`）。