diff --git a/docs/zh-CN/providers/chutes.md b/docs/zh-CN/providers/chutes.md
index abdd482ed..1b298cae4 100644
--- a/docs/zh-CN/providers/chutes.md
+++ b/docs/zh-CN/providers/chutes.md
@@ -6,80 +6,96 @@ read_when:
summary: Chutes 设置（OAuth 或 API 密钥、模型发现、别名）
title: Chutes
x-i18n:
- generated_at: "2026-04-05T08:41:24Z"
+ generated_at: "2026-04-12T10:26:12Z"
model: gpt-5.4
provider: openai
- source_hash: e275f32e7a19fa5b4c64ffabfb4bf116dd5c9ab95bfa25bd3b1a15d15e237674
+ source_hash: 07c52b1d1d2792412e6daabc92df5310434b3520116d9e0fd2ad26bfa5297e1c
source_path: providers/chutes.md
workflow: 15
---
# Chutes
-[Chutes](https://chutes.ai) 通过与 OpenAI 兼容的 API 提供开源模型目录。OpenClaw 同时支持内置 `chutes` 提供商的浏览器 OAuth 和直接 API 密钥认证。
+[Chutes](https://chutes.ai) 通过与 OpenAI 兼容的 API 提供开源模型目录。OpenClaw 支持内置 `chutes` 提供商的浏览器 OAuth 和直接 API 密钥认证。
-- 提供商：`chutes`
-- API：与 OpenAI 兼容
-- Base URL：`https://llm.chutes.ai/v1`
-- 认证：
- - 通过 `openclaw onboard --auth-choice chutes` 使用 OAuth
- - 通过 `openclaw onboard --auth-choice chutes-api-key` 使用 API 密钥
- - 运行时环境变量：`CHUTES_API_KEY`、`CHUTES_OAUTH_TOKEN`
+| 属性 | 值 |
+| -------- | ---------------------------- |
+| 提供商 | `chutes` |
+| API | 与 OpenAI 兼容 |
+| Base URL | `https://llm.chutes.ai/v1` |
+| 认证 | OAuth 或 API 密钥（见下文） |
-## 快速开始
+## 入门指南
-### OAuth
+
+
+
+
+ ```bash
+ openclaw onboard --auth-choice chutes
+ ```
+ OpenClaw 会在本地启动浏览器流程，或者在远程 / 无头主机上显示 URL + 粘贴重定向地址的流程。OAuth 令牌会通过 OpenClaw 认证配置文件自动刷新。
+
+
+ 完成新手引导后，默认模型会设置为
+ `chutes/zai-org/GLM-4.7-TEE`，并注册内置的 Chutes 目录。
+
+
+
+
+
+
+ 在
+ [chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys)
+ 创建一个密钥。
+
+
+ ```bash
+ openclaw onboard --auth-choice chutes-api-key
+ ```
+
+
+ 完成新手引导后，默认模型会设置为
+ `chutes/zai-org/GLM-4.7-TEE`，并注册内置的 Chutes 目录。
+
+
+
+
-```bash
-openclaw onboard --auth-choice chutes
-```
-
-OpenClaw 会在本地启动浏览器流程，或者在远程 / 无头主机上显示 URL + 重定向粘贴流程。OAuth 令牌会通过 OpenClaw 认证配置文件自动刷新。
-
-可选的 OAuth 覆盖项：
-
-- `CHUTES_CLIENT_ID`
-- `CHUTES_CLIENT_SECRET`
-- `CHUTES_OAUTH_REDIRECT_URI`
-- `CHUTES_OAUTH_SCOPES`
-
-### API 密钥
-
-```bash
-openclaw onboard --auth-choice chutes-api-key
-```
-
-在
-[chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys)
-获取你的密钥。
-
-这两种认证路径都会注册内置的 Chutes 目录，并将默认模型设置为
-`chutes/zai-org/GLM-4.7-TEE`。
+
+两种认证路径都会注册内置的 Chutes 目录，并将默认模型设置为
+`chutes/zai-org/GLM-4.7-TEE`。运行时环境变量：`CHUTES_API_KEY`、
+`CHUTES_OAUTH_TOKEN`。
+
## 发现行为
-当 Chutes 认证可用时，OpenClaw 会使用该凭证查询 Chutes 目录，并使用发现到的模型。如果发现失败，OpenClaw 会回退到内置静态目录，以便新手引导和启动流程仍然可用。
+当 Chutes 认证可用时，OpenClaw 会使用该凭证查询 Chutes 目录，并使用发现到的模型。如果发现失败，OpenClaw 会回退到内置的静态目录，以确保新手引导和启动仍然可用。
## 默认别名
-OpenClaw 还为内置 Chutes 目录注册了三个便捷别名：
+OpenClaw 为内置的 Chutes 目录注册了三个便捷别名：
-- `chutes-fast` -> `chutes/zai-org/GLM-4.7-FP8`
-- `chutes-pro` -> `chutes/deepseek-ai/DeepSeek-V3.2-TEE`
-- `chutes-vision` -> `chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506`
+| 别名 | 目标模型 |
+| --------------- | ----------------------------------------------------- |
+| `chutes-fast` | `chutes/zai-org/GLM-4.7-FP8` |
+| `chutes-pro` | `chutes/deepseek-ai/DeepSeek-V3.2-TEE` |
+| `chutes-vision` | `chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506` |
## 内置起始目录
-内置回退目录包含当前的 Chutes 引用，例如：
+内置的回退目录包含当前的 Chutes 引用：
-- `chutes/zai-org/GLM-4.7-TEE`
-- `chutes/zai-org/GLM-5-TEE`
-- `chutes/deepseek-ai/DeepSeek-V3.2-TEE`
-- `chutes/deepseek-ai/DeepSeek-R1-0528-TEE`
-- `chutes/moonshotai/Kimi-K2.5-TEE`
-- `chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506`
-- `chutes/Qwen/Qwen3-Coder-Next-TEE`
-- `chutes/openai/gpt-oss-120b-TEE`
+| 模型引用 |
+| ----------------------------------------------------- |
+| `chutes/zai-org/GLM-4.7-TEE` |
+| `chutes/zai-org/GLM-5-TEE` |
+| `chutes/deepseek-ai/DeepSeek-V3.2-TEE` |
+| `chutes/deepseek-ai/DeepSeek-R1-0528-TEE` |
+| `chutes/moonshotai/Kimi-K2.5-TEE` |
+| `chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506` |
+| `chutes/Qwen/Qwen3-Coder-Next-TEE` |
+| `chutes/openai/gpt-oss-120b-TEE` |
## 配置示例
@@ -97,8 +113,41 @@ OpenClaw 还为内置 Chutes 目录注册了三个便捷别名：
}
```
-## 说明
+
+
+ 你可以使用可选环境变量自定义 OAuth 流程：
-- OAuth 帮助和重定向应用要求： [Chutes OAuth 文档](https://chutes.ai/docs/sign-in-with-chutes/overview)
-- API 密钥和 OAuth 发现都使用相同的 `chutes` 提供商 id。
-- Chutes 模型会注册为 `chutes/`。
+ | 变量 | 用途 |
+ | -------- | ------- |
+ | `CHUTES_CLIENT_ID` | 自定义 OAuth 客户端 ID |
+ | `CHUTES_CLIENT_SECRET` | 自定义 OAuth 客户端密钥 |
+ | `CHUTES_OAUTH_REDIRECT_URI` | 自定义重定向 URI |
+ | `CHUTES_OAUTH_SCOPES` | 自定义 OAuth 作用域 |
+
+ 有关重定向应用要求和帮助，请参阅 [Chutes OAuth 文档](https://chutes.ai/docs/sign-in-with-chutes/overview)。
+
+
+
+
+ - API 密钥和 OAuth 发现都使用相同的 `chutes` 提供商 id。
+ - Chutes 模型会注册为 `chutes/`。
+ - 如果启动时发现失败，会自动使用内置静态目录。
+
+
+
+## 相关内容
+
+
+
+ 提供商规则、模型引用和故障转移行为。
+
+
+ 完整的配置 schema，包括提供商设置。
+
+
+ Chutes 控制台和 API 文档。
+
+
+ 创建和管理 Chutes API 密钥。
+
+
diff --git a/docs/zh-CN/providers/deepgram.md b/docs/zh-CN/providers/deepgram.md
index 6ca9f628c..d7f85f2b7 100644
--- a/docs/zh-CN/providers/deepgram.md
+++ b/docs/zh-CN/providers/deepgram.md
@@ -1,97 +1,140 @@
---
read_when:
- - 你想为音频附件使用 Deepgram 语音转文本
+ - 你想要将 Deepgram 语音转文本用于音频附件
- 你需要一个快速的 Deepgram 配置示例
-summary: 用于入站语音笔记的 Deepgram 转录
+summary: 用于入站语音便笺的 Deepgram 转录
title: Deepgram
x-i18n:
- generated_at: "2026-04-05T08:41:50Z"
+ generated_at: "2026-04-12T10:26:13Z"
model: gpt-5.4
provider: openai
- source_hash: dabd1f6942c339fbd744fbf38040b6a663b06ddf4d9c9ee31e3ac034de9e79d9
+ source_hash: 091523d6669e3d258f07c035ec756bd587299b6c7025520659232b1b2c1e21a5
source_path: providers/deepgram.md
workflow: 15
---
# Deepgram（音频转录）
-Deepgram 是一个语音转文本 API。在 OpenClaw 中，它通过 `tools.media.audio` 用于**入站音频/语音笔记转录**。
+Deepgram 是一个语音转文本 API。在 OpenClaw 中，它用于通过 `tools.media.audio` 进行**入站音频/语音便笺转录**。
-启用后，OpenClaw 会将音频文件上传到 Deepgram，并将转录文本注入到回复管线中（`{{Transcript}}` + `[Audio]` 块）。这**不是流式传输**；它使用预录音转录端点。
+启用后，OpenClaw 会将音频文件上传到 Deepgram，并将转录文本注入回复流水线中（`{{Transcript}}` + `[Audio]` 区块）。这**不是流式传输**；它使用预录音转录端点。
-网站：[https://deepgram.com](https://deepgram.com)
-文档：[https://developers.deepgram.com](https://developers.deepgram.com)
+| 详情 | 值 |
+| ------------- | ---------------------------------------------------------- |
+| 网站 | [deepgram.com](https://deepgram.com) |
+| 文档 | [developers.deepgram.com](https://developers.deepgram.com) |
+| 认证 | `DEEPGRAM_API_KEY` |
+| 默认模型 | `nova-3` |
-## 快速开始
+## 入门指南
-1. 设置你的 API 密钥：
+
+
+ 将你的 Deepgram API 密钥添加到环境变量中：
-```
-DEEPGRAM_API_KEY=dg_...
-```
+ ```
+ DEEPGRAM_API_KEY=dg_...
+ ```
-2. 启用提供商：
-
-```json5
-{
- tools: {
- media: {
- audio: {
- enabled: true,
- models: [{ provider: "deepgram", model: "nova-3" }],
- },
- },
- },
-}
-```
-
-## 选项
-
-- `model`：Deepgram 模型 id（默认：`nova-3`）
-- `language`：语言提示（可选）
-- `tools.media.audio.providerOptions.deepgram.detect_language`：启用语言检测（可选）
-- `tools.media.audio.providerOptions.deepgram.punctuate`：启用标点（可选）
-- `tools.media.audio.providerOptions.deepgram.smart_format`：启用智能格式化（可选）
-
-带语言设置的示例：
-
-```json5
-{
- tools: {
- media: {
- audio: {
- enabled: true,
- models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
- },
- },
- },
-}
-```
-
-带 Deepgram 选项的示例：
-
-```json5
-{
- tools: {
- media: {
- audio: {
- enabled: true,
- providerOptions: {
- deepgram: {
- detect_language: true,
- punctuate: true,
- smart_format: true,
+
+
+ ```json5
+ {
+ tools: {
+ media: {
+ audio: {
+ enabled: true,
+ models: [{ provider: "deepgram", model: "nova-3" }],
},
},
- models: [{ provider: "deepgram", model: "nova-3" }],
},
- },
- },
-}
-```
+ }
+ ```
+
+
+ 通过任意已连接的渠道发送一条音频消息。OpenClaw 会通过 Deepgram 对其进行转录，并将转录文本注入回复流水线中。
+
+
+
+## 配置选项
+
+| 选项 | 路径 | 说明 |
+| ----------------- | ------------------------------------------------------------ | ------------------------------------- |
+| `model` | `tools.media.audio.models[].model` | Deepgram 模型 ID（默认：`nova-3`） |
+| `language` | `tools.media.audio.models[].language` | 语言提示（可选） |
+| `detect_language` | `tools.media.audio.providerOptions.deepgram.detect_language` | 启用语言检测（可选） |
+| `punctuate` | `tools.media.audio.providerOptions.deepgram.punctuate` | 启用标点（可选） |
+| `smart_format` | `tools.media.audio.providerOptions.deepgram.smart_format` | 启用智能格式化（可选） |
+
+
+
+ ```json5
+ {
+ tools: {
+ media: {
+ audio: {
+ enabled: true,
+ models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
+ },
+ },
+ },
+ }
+ ```
+
+
+ ```json5
+ {
+ tools: {
+ media: {
+ audio: {
+ enabled: true,
+ providerOptions: {
+ deepgram: {
+ detect_language: true,
+ punctuate: true,
+ smart_format: true,
+ },
+ },
+ models: [{ provider: "deepgram", model: "nova-3" }],
+ },
+ },
+ },
+ }
+ ```
+
+
## 说明
-- 认证遵循标准提供商凭证顺序；`DEEPGRAM_API_KEY` 是最简单的方式。
-- 使用代理时，可通过 `tools.media.audio.baseUrl` 和 `tools.media.audio.headers` 覆盖端点或请求头。
-- 输出遵循与其他提供商相同的音频规则（大小上限、超时、转录文本注入）。
+
+
+ 身份验证遵循标准的提供商认证顺序。`DEEPGRAM_API_KEY` 是最简单的方式。
+
+
+ 使用代理时，可通过 `tools.media.audio.baseUrl` 和 `tools.media.audio.headers` 覆盖端点或请求头。
+
+
+ 输出遵循与其他提供商相同的音频规则（大小上限、超时、转录文本注入）。
+
+
+
+
+Deepgram 转录**仅支持预录音**（不是实时分块流式传输）。OpenClaw 会上传完整的音频文件，并在将其注入对话之前等待完整的转录结果。
+
+
+## 相关内容
+
+
+
+ 音频、图像和视频处理流水线概览。
+
+
+ 完整的配置参考，包括媒体工具设置。
+
+
+ 常见问题和调试步骤。
+
+
+ 关于 OpenClaw 设置的常见问题。
+
+
diff --git a/docs/zh-CN/providers/synthetic.md b/docs/zh-CN/providers/synthetic.md
index bd7118cf9..baaaf45a5 100644
--- a/docs/zh-CN/providers/synthetic.md
+++ b/docs/zh-CN/providers/synthetic.md
@@ -5,33 +5,51 @@ read_when:
summary: 在 OpenClaw 中使用 Synthetic 的 Anthropic 兼容 API
title: Synthetic
x-i18n:
- generated_at: "2026-04-05T10:07:01Z"
+ generated_at: "2026-04-12T10:26:17Z"
model: gpt-5.4
provider: openai
- source_hash: 3495bca5cb134659cf6c54e31fa432989afe0cc04f53cf3e3146ce80a5e8af49
+ source_hash: 1c4d2c6635482e09acaf603a75c8a85f0782e42a4a68ef6166f423a48d184ffa
source_path: providers/synthetic.md
workflow: 15
---
# Synthetic
-Synthetic 提供 Anthropic 兼容端点。OpenClaw 将其注册为
-`synthetic` 提供商，并使用 Anthropic Messages API。
+[Synthetic](https://synthetic.new) 提供与 Anthropic 兼容的端点。
+OpenClaw 将其注册为 `synthetic` 提供商，并使用 Anthropic
+Messages API。
-## 快速设置
+| 属性 | 值 |
+| -------- | ------------------------------------- |
+| 提供商 | `synthetic` |
+| 认证 | `SYNTHETIC_API_KEY` |
+| API | Anthropic Messages |
+| Base URL | `https://api.synthetic.new/anthropic` |
-1. 设置 `SYNTHETIC_API_KEY`（或运行下方的向导）。
-2. 运行新手引导：
+## 入门指南
-```bash
-openclaw onboard --auth-choice synthetic-api-key
-```
+
+
+ 从你的 Synthetic 账户获取 `SYNTHETIC_API_KEY`，或者让新手引导向导提示你输入。
+
+
+ ```bash
+ openclaw onboard --auth-choice synthetic-api-key
+ ```
+
+
+ 完成新手引导后，默认模型将设置为：
+ ```
+ synthetic/hf:MiniMaxAI/MiniMax-M2.5
+ ```
+
+
-默认模型设置为：
-
-```
-synthetic/hf:MiniMaxAI/MiniMax-M2.5
-```
+
+OpenClaw 的 Anthropic 客户端会自动在 base URL 后追加 `/v1`，因此请使用
+`https://api.synthetic.new/anthropic`（而不是 `/anthropic/v1`）。如果 Synthetic
+更改了它的 base URL，请覆盖 `models.providers.synthetic.baseUrl`。
+
## 配置示例
@@ -68,41 +86,75 @@ synthetic/hf:MiniMaxAI/MiniMax-M2.5
}
```
-注意：OpenClaw 的 Anthropic 客户端会在 base URL 后附加 `/v1`，因此请使用
-`https://api.synthetic.new/anthropic`（而不是 `/anthropic/v1`）。如果 Synthetic 更改了
-其 base URL，请覆盖 `models.providers.synthetic.baseUrl`。
-
## 模型目录
-以下所有模型的成本均为 `0`（输入/输出/缓存）。
+所有 Synthetic 模型的成本均为 `0`（输入/输出/缓存）。
-| 模型 ID | 上下文窗口 | 最大令牌数 | 推理 | 输入 |
-| ------------------------------------------------------ | ---------- | ---------- | ---- | ------------ |
-| `hf:MiniMaxAI/MiniMax-M2.5` | 192000 | 65536 | false | text |
-| `hf:moonshotai/Kimi-K2-Thinking` | 256000 | 8192 | true | text |
-| `hf:zai-org/GLM-4.7` | 198000 | 128000 | false | text |
-| `hf:deepseek-ai/DeepSeek-R1-0528` | 128000 | 8192 | false | text |
-| `hf:deepseek-ai/DeepSeek-V3-0324` | 128000 | 8192 | false | text |
-| `hf:deepseek-ai/DeepSeek-V3.1` | 128000 | 8192 | false | text |
-| `hf:deepseek-ai/DeepSeek-V3.1-Terminus` | 128000 | 8192 | false | text |
-| `hf:deepseek-ai/DeepSeek-V3.2` | 159000 | 8192 | false | text |
-| `hf:meta-llama/Llama-3.3-70B-Instruct` | 128000 | 8192 | false | text |
-| `hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` | 524000 | 8192 | false | text |
-| `hf:moonshotai/Kimi-K2-Instruct-0905` | 256000 | 8192 | false | text |
-| `hf:moonshotai/Kimi-K2.5` | 256000 | 8192 | true | text + image |
-| `hf:openai/gpt-oss-120b` | 128000 | 8192 | false | text |
-| `hf:Qwen/Qwen3-235B-A22B-Instruct-2507` | 256000 | 8192 | false | text |
-| `hf:Qwen/Qwen3-Coder-480B-A35B-Instruct` | 256000 | 8192 | false | text |
-| `hf:Qwen/Qwen3-VL-235B-A22B-Instruct` | 250000 | 8192 | false | text + image |
-| `hf:zai-org/GLM-4.5` | 128000 | 128000 | false | text |
-| `hf:zai-org/GLM-4.6` | 198000 | 128000 | false | text |
-| `hf:zai-org/GLM-5` | 256000 | 128000 | true | text + image |
-| `hf:deepseek-ai/DeepSeek-V3` | 128000 | 8192 | false | text |
-| `hf:Qwen/Qwen3-235B-A22B-Thinking-2507` | 256000 | 8192 | true | text |
+| 模型 ID | 上下文窗口 | 最大 token 数 | 推理 | 输入 |
+| ------------------------------------------------------ | -------------- | ---------- | --------- | ------------ |
+| `hf:MiniMaxAI/MiniMax-M2.5` | 192,000 | 65,536 | 否 | 文本 |
+| `hf:moonshotai/Kimi-K2-Thinking` | 256,000 | 8,192 | 是 | 文本 |
+| `hf:zai-org/GLM-4.7` | 198,000 | 128,000 | 否 | 文本 |
+| `hf:deepseek-ai/DeepSeek-R1-0528` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:deepseek-ai/DeepSeek-V3-0324` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:deepseek-ai/DeepSeek-V3.1` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:deepseek-ai/DeepSeek-V3.1-Terminus` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:deepseek-ai/DeepSeek-V3.2` | 159,000 | 8,192 | 否 | 文本 |
+| `hf:meta-llama/Llama-3.3-70B-Instruct` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` | 524,000 | 8,192 | 否 | 文本 |
+| `hf:moonshotai/Kimi-K2-Instruct-0905` | 256,000 | 8,192 | 否 | 文本 |
+| `hf:moonshotai/Kimi-K2.5` | 256,000 | 8,192 | 是 | 文本 + 图像 |
+| `hf:openai/gpt-oss-120b` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:Qwen/Qwen3-235B-A22B-Instruct-2507` | 256,000 | 8,192 | 否 | 文本 |
+| `hf:Qwen/Qwen3-Coder-480B-A35B-Instruct` | 256,000 | 8,192 | 否 | 文本 |
+| `hf:Qwen/Qwen3-VL-235B-A22B-Instruct` | 250,000 | 8,192 | 否 | 文本 + 图像 |
+| `hf:zai-org/GLM-4.5` | 128,000 | 128,000 | 否 | 文本 |
+| `hf:zai-org/GLM-4.6` | 198,000 | 128,000 | 否 | 文本 |
+| `hf:zai-org/GLM-5` | 256,000 | 128,000 | 是 | 文本 + 图像 |
+| `hf:deepseek-ai/DeepSeek-V3` | 128,000 | 8,192 | 否 | 文本 |
+| `hf:Qwen/Qwen3-235B-A22B-Thinking-2507` | 256,000 | 8,192 | 是 | 文本 |
-## 说明
+
+模型引用使用 `synthetic/` 这种形式。使用
+`openclaw models list --provider synthetic` 查看你的账户上可用的所有模型。
+
-- 模型引用使用 `synthetic/`。
-- 如果你启用了模型 allowlist（`agents.defaults.models`），请添加你
- 计划使用的每一个模型。
-- 提供商规则请参见[模型提供商](/zh-CN/concepts/model-providers)。
+
+
+ 如果你启用了模型允许列表（`agents.defaults.models`），请添加你计划使用的每个
+ Synthetic 模型。不在允许列表中的模型将对智能体隐藏。
+
+
+
+ 如果 Synthetic 更改了其 API 端点，请在你的配置中覆盖 base URL：
+
+ ```json5
+ {
+ models: {
+ providers: {
+ synthetic: {
+ baseUrl: "https://new-api.synthetic.new/anthropic",
+ },
+ },
+ },
+ }
+ ```
+
+ 请记住，OpenClaw 会自动追加 `/v1`。
+
+
+
+
+## 相关内容
+
+
+
+ 提供商规则、模型引用和故障转移行为。
+
+
+ 完整的配置 schema，包括提供商设置。
+
+
+ Synthetic 控制台和 API 文档。
+
+
diff --git a/docs/zh-CN/providers/together.md b/docs/zh-CN/providers/together.md
index 5197ea9c0..c2039018e 100644
--- a/docs/zh-CN/providers/together.md
+++ b/docs/zh-CN/providers/together.md
@@ -1,48 +1,56 @@
---
read_when:
- - 你想将 Together AI 与 OpenClaw 搭配使用
- - 你需要 API 密钥环境变量或 CLI 凭证选项
-summary: Together AI 设置（凭证 + 模型选择）
+ - 你想在 OpenClaw 中使用 Together AI
+ - 你需要 API 密钥环境变量或 CLI 认证选项
+summary: Together AI 设置（认证 + 模型选择）
title: Together AI
x-i18n:
- generated_at: "2026-04-05T22:23:05Z"
+ generated_at: "2026-04-12T10:26:12Z"
model: gpt-5.4
provider: openai
- source_hash: b68fdc15bfcac8d59e3e0c06a39162abd48d9d41a9a64a0ac622cd8e3f80a595
+ source_hash: 33531a1646443ac2e46ee1fbfbb60ec71093611b022618106e8e5435641680ac
source_path: providers/together.md
workflow: 15
---
# Together AI
-[Together AI](https://together.ai) 通过统一的 API 提供对 Llama、DeepSeek、Kimi 等领先开源模型的访问。
+[Together AI](https://together.ai) 通过统一的 API 提供对领先开源模型的访问，包括 Llama、DeepSeek、Kimi 等。
-- 提供商：`together`
-- 凭证：`TOGETHER_API_KEY`
-- API：与 OpenAI 兼容
-- 基础 URL：`https://api.together.xyz/v1`
+| Property | Value |
+| -------- | ----------------------------- |
+| 提供商 | `together` |
+| 认证 | `TOGETHER_API_KEY` |
+| API | 与 OpenAI 兼容 |
+| Base URL | `https://api.together.xyz/v1` |
-## 快速开始
+## 入门指南
-1. 设置 API 密钥（推荐：为 Gateway 网关 存储它）：
+
+
+ 在
+ [api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys)
+ 创建一个 API 密钥。
+
+
+ ```bash
+ openclaw onboard --auth-choice together-api-key
+ ```
+
+
+ ```json5
+ {
+ agents: {
+ defaults: {
+ model: { primary: "together/moonshotai/Kimi-K2.5" },
+ },
+ },
+ }
+ ```
+
+
-```bash
-openclaw onboard --auth-choice together-api-key
-```
-
-2. 设置默认模型：
-
-```json5
-{
- agents: {
- defaults: {
- model: { primary: "together/moonshotai/Kimi-K2.5" },
- },
- },
-}
-```
-
-## 非交互式示例
+### 非交互式示例
```bash
openclaw onboard --non-interactive \
@@ -51,40 +59,36 @@ openclaw onboard --non-interactive \
--together-api-key "$TOGETHER_API_KEY"
```
-这会将 `together/moonshotai/Kimi-K2.5` 设置为默认模型。
-
-## 环境说明
-
-如果 Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保 `TOGETHER_API_KEY`
-对该进程可用（例如，在 `~/.openclaw/.env` 中或通过
-`env.shellEnv`）。
+
+新手引导预设会将 `together/moonshotai/Kimi-K2.5` 设置为默认模型。
+
## 内置目录
-OpenClaw 当前内置了以下 Together 模型目录：
+OpenClaw 附带以下 Together 目录：
| Model ref | Name | Input | Context | Notes |
| ------------------------------------------------------------ | -------------------------------------- | ----------- | ---------- | -------------------------------- |
-| `together/moonshotai/Kimi-K2.5` | Kimi K2.5 | 文本、图像 | 262,144 | 默认模型；已启用推理 |
-| `together/zai-org/GLM-4.7` | GLM 4.7 Fp8 | 文本 | 202,752 | 通用文本模型 |
-| `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | Llama 3.3 70B Instruct Turbo | 文本 | 131,072 | 快速指令模型 |
-| `together/meta-llama/Llama-4-Scout-17B-16E-Instruct` | Llama 4 Scout 17B 16E Instruct | 文本、图像 | 10,000,000 | 多模态 |
-| `together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` | Llama 4 Maverick 17B 128E Instruct FP8 | 文本、图像 | 20,000,000 | 多模态 |
-| `together/deepseek-ai/DeepSeek-V3.1` | DeepSeek V3.1 | 文本 | 131,072 | 通用文本模型 |
-| `together/deepseek-ai/DeepSeek-R1` | DeepSeek R1 | 文本 | 131,072 | 推理模型 |
-| `together/moonshotai/Kimi-K2-Instruct-0905` | Kimi K2-Instruct 0905 | 文本 | 262,144 | 次要 Kimi 文本模型 |
-
-新手引导预设会将 `together/moonshotai/Kimi-K2.5` 设置为默认模型。
+| `together/moonshotai/Kimi-K2.5` | Kimi K2.5 | 文本、图像 | 262,144 | 默认模型；已启用推理 |
+| `together/zai-org/GLM-4.7` | GLM 4.7 Fp8 | 文本 | 202,752 | 通用文本模型 |
+| `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | Llama 3.3 70B Instruct Turbo | 文本 | 131,072 | 快速指令模型 |
+| `together/meta-llama/Llama-4-Scout-17B-16E-Instruct` | Llama 4 Scout 17B 16E Instruct | 文本、图像 | 10,000,000 | 多模态 |
+| `together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` | Llama 4 Maverick 17B 128E Instruct FP8 | 文本、图像 | 20,000,000 | 多模态 |
+| `together/deepseek-ai/DeepSeek-V3.1` | DeepSeek V3.1 | 文本 | 131,072 | 通用文本模型 |
+| `together/deepseek-ai/DeepSeek-R1` | DeepSeek R1 | 文本 | 131,072 | 推理模型 |
+| `together/moonshotai/Kimi-K2-Instruct-0905` | Kimi K2-Instruct 0905 | 文本 | 262,144 | 次要 Kimi 文本模型 |
## 视频生成
-内置的 `together` 插件还通过共享的 `video_generate` 工具注册了视频生成功能。
+内置的 `together` 插件还会通过共享的 `video_generate` 工具注册视频生成功能。
-- 默认视频模型：`together/Wan-AI/Wan2.2-T2V-A14B`
-- 模式：文生视频和单图参考流程
-- 支持 `aspectRatio` 和 `resolution`
+| Property | Value |
+| -------------------- | ------------------------------------- |
+| 默认视频模型 | `together/Wan-AI/Wan2.2-T2V-A14B` |
+| 模式 | 文本到视频、单图参考 |
+| 支持的参数 | `aspectRatio`, `resolution` |
-要将 Together 设为默认视频提供商：
+要将 Together 用作默认视频提供商：
```json5
{
@@ -98,4 +102,44 @@ OpenClaw 当前内置了以下 Together 模型目录：
}
```
-有关共享工具参数、提供商选择和故障转移行为，请参阅[视频生成](/zh-CN/tools/video-generation)。
+
+参见 [视频生成](/zh-CN/tools/video-generation)，了解共享工具参数、提供商选择和故障切换行为。
+
+
+
+
+ 如果 Gateway 网关 作为守护进程运行（launchd/systemd），请确保
+ `TOGETHER_API_KEY` 对该进程可用（例如在
+ `~/.openclaw/.env` 中，或通过 `env.shellEnv`）。
+
+
+ 仅在你的交互式 shell 中设置的密钥对由守护进程管理的
+ Gateway 网关 进程不可见。请使用 `~/.openclaw/.env` 或
+ `env.shellEnv` 配置来确保持续可用。
+
+
+
+
+
+ - 验证你的密钥是否可用：`openclaw models list --provider together`
+ - 如果模型没有显示，请确认 API 密钥已在你的 Gateway 网关 进程对应的正确环境中设置。
+ - 模型引用使用 `together/` 这种格式。
+
+
+
+## 相关内容
+
+
+
+ 提供商规则、模型引用和故障切换行为。
+
+
+ 共享视频生成工具参数和提供商选择。
+
+
+ 完整的配置 schema，包括提供商设置。
+
+
+ Together AI 控制台、API 文档和定价。
+
+
diff --git a/docs/zh-CN/providers/volcengine.md b/docs/zh-CN/providers/volcengine.md
index 4609b136c..d1cdbe473 100644
--- a/docs/zh-CN/providers/volcengine.md
+++ b/docs/zh-CN/providers/volcengine.md
@@ -1,47 +1,62 @@
---
read_when:
- - 你想在 OpenClaw 中使用 Volcano Engine 或 Doubao 模型
- - 你需要 Volcengine API 密钥设置
-summary: Volcano Engine 设置（Doubao 模型，通用 + 编码端点）
-title: Volcengine（Doubao）
+ - 你想在 OpenClaw 中使用火山引擎或 Doubao 模型
+ - 你需要设置 Volcengine API 密钥
+summary: 火山引擎设置（Doubao 模型，通用 + 编程端点）
+title: 火山引擎（Doubao）
x-i18n:
- generated_at: "2026-04-05T10:07:10Z"
+ generated_at: "2026-04-12T10:26:13Z"
model: gpt-5.4
provider: openai
- source_hash: 85d9e737e906cd705fb31479d6b78d92b68c9218795ea9667516c1571dcaaf3a
+ source_hash: a21f390da719f79c88c6d55a7d952d35c2ce5ff26d910c9f10020132cd7d2f4c
source_path: providers/volcengine.md
workflow: 15
---
-# Volcengine（Doubao）
+# 火山引擎（Doubao）
-Volcengine 提供商可访问 Doubao 模型和托管在 Volcano Engine 上的第三方模型，并为通用工作负载和编码工作负载提供独立端点。
+Volcengine 提供商可让你访问部署在火山引擎上的 Doubao 模型和第三方模型，并为通用工作负载和编程工作负载提供分别独立的端点。
-- 提供商：`volcengine`（通用）+ `volcengine-plan`（编码）
-- 认证：`VOLCANO_ENGINE_API_KEY`
-- API：OpenAI-compatible
+| 详情 | 值 |
+| --------- | --------------------------------------------------- |
+| 提供商 | `volcengine`（通用）+ `volcengine-plan`（编程） |
+| 认证 | `VOLCANO_ENGINE_API_KEY` |
+| API | 与 OpenAI 兼容 |
-## 快速开始
+## 入门指南
-1. 设置 API 密钥：
+
+
+ 运行交互式新手引导：
-```bash
-openclaw onboard --auth-choice volcengine-api-key
-```
+ ```bash
+ openclaw onboard --auth-choice volcengine-api-key
+ ```
-2. 设置默认模型：
+ 这会通过一个 API 密钥同时注册通用提供商（`volcengine`）和编程提供商（`volcengine-plan`）。
-```json5
-{
- agents: {
- defaults: {
- model: { primary: "volcengine-plan/ark-code-latest" },
- },
- },
-}
-```
+
+
+ ```json5
+ {
+ agents: {
+ defaults: {
+ model: { primary: "volcengine-plan/ark-code-latest" },
+ },
+ },
+ }
+ ```
+
+
+ ```bash
+ openclaw models list --provider volcengine
+ openclaw models list --provider volcengine-plan
+ ```
+
+
-## 非交互式示例
+
+对于非交互式设置（CI、脚本），可直接传入密钥：
```bash
openclaw onboard --non-interactive \
@@ -50,46 +65,81 @@ openclaw onboard --non-interactive \
--volcengine-api-key "$VOLCANO_ENGINE_API_KEY"
```
+
+
## 提供商和端点
-| 提供商 | 端点 | 使用场景 |
-| ----------------- | ----------------------------------------- | ---------- |
-| `volcengine` | `ark.cn-beijing.volces.com/api/v3` | 通用模型 |
-| `volcengine-plan` | `ark.cn-beijing.volces.com/api/coding/v3` | 编码模型 |
+| 提供商 | 端点 | 使用场景 |
+| ----------------- | ----------------------------------------- | ------------ |
+| `volcengine` | `ark.cn-beijing.volces.com/api/v3` | 通用模型 |
+| `volcengine-plan` | `ark.cn-beijing.volces.com/api/coding/v3` | 编程模型 |
-两个提供商都通过同一个 API 密钥进行配置。设置时会自动同时注册二者。
+
+这两个提供商都通过同一个 API 密钥进行配置。设置时会自动同时注册两者。
+
## 可用模型
-通用提供商（`volcengine`）：
+
+
+ | Model ref | 名称 | 输入 | 上下文 |
+ | -------------------------------------------- | ------------------------------- | ----------- | ------ |
+ | `volcengine/doubao-seed-1-8-251228` | Doubao Seed 1.8 | 文本、图像 | 256,000 |
+ | `volcengine/doubao-seed-code-preview-251028` | doubao-seed-code-preview-251028 | 文本、图像 | 256,000 |
+ | `volcengine/kimi-k2-5-260127` | Kimi K2.5 | 文本、图像 | 256,000 |
+ | `volcengine/glm-4-7-251222` | GLM 4.7 | 文本、图像 | 200,000 |
+ | `volcengine/deepseek-v3-2-251201` | DeepSeek V3.2 | 文本、图像 | 128,000 |
+
+
+ | Model ref | 名称 | 输入 | 上下文 |
+ | ------------------------------------------------- | ------------------------ | ---- | ------ |
+ | `volcengine-plan/ark-code-latest` | Ark Coding Plan | 文本 | 256,000 |
+ | `volcengine-plan/doubao-seed-code` | Doubao Seed Code | 文本 | 256,000 |
+ | `volcengine-plan/glm-4.7` | GLM 4.7 Coding | 文本 | 200,000 |
+ | `volcengine-plan/kimi-k2-thinking` | Kimi K2 Thinking | 文本 | 256,000 |
+ | `volcengine-plan/kimi-k2.5` | Kimi K2.5 Coding | 文本 | 256,000 |
+ | `volcengine-plan/doubao-seed-code-preview-251028` | Doubao Seed Code Preview | 文本 | 256,000 |
+
+
-| 模型引用 | 名称 | 输入 | 上下文 |
-| -------------------------------------------- | ------------------------------- | ----------- | ------- |
-| `volcengine/doubao-seed-1-8-251228` | Doubao Seed 1.8 | text, image | 256,000 |
-| `volcengine/doubao-seed-code-preview-251028` | doubao-seed-code-preview-251028 | text, image | 256,000 |
-| `volcengine/kimi-k2-5-260127` | Kimi K2.5 | text, image | 256,000 |
-| `volcengine/glm-4-7-251222` | GLM 4.7 | text, image | 200,000 |
-| `volcengine/deepseek-v3-2-251201` | DeepSeek V3.2 | text, image | 128,000 |
+## 高级说明
-编码提供商（`volcengine-plan`）：
+
+
+ `openclaw onboard --auth-choice volcengine-api-key` 当前会将
+ `volcengine-plan/ark-code-latest` 设为默认模型，同时也会注册通用的 `volcengine` 模型目录。
+
-| 模型引用 | 名称 | 输入 | 上下文 |
-| ------------------------------------------------- | ------------------------ | ----- | ------- |
-| `volcengine-plan/ark-code-latest` | Ark Coding Plan | text | 256,000 |
-| `volcengine-plan/doubao-seed-code` | Doubao Seed Code | text | 256,000 |
-| `volcengine-plan/glm-4.7` | GLM 4.7 Coding | text | 200,000 |
-| `volcengine-plan/kimi-k2-thinking` | Kimi K2 Thinking | text | 256,000 |
-| `volcengine-plan/kimi-k2.5` | Kimi K2.5 Coding | text | 256,000 |
-| `volcengine-plan/doubao-seed-code-preview-251028` | Doubao Seed Code Preview | text | 256,000 |
+
+ 在新手引导/配置模型选择期间，Volcengine 认证选项会优先显示
+ `volcengine/*` 和 `volcengine-plan/*` 条目。如果这些模型尚未加载，
+ OpenClaw 会回退到未筛选的模型目录，而不是显示一个空的按提供商范围筛选的选择器。
+
-`openclaw onboard --auth-choice volcengine-api-key` 当前会将
-`volcengine-plan/ark-code-latest` 设为默认模型，同时也会注册通用的 `volcengine` 目录。
+
+ 如果 Gateway 网关以守护进程方式运行（launchd/systemd），请确保
+ `VOLCANO_ENGINE_API_KEY` 对该进程可用（例如放在
+ `~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。
+
+
-在新手引导/配置的模型选择过程中，Volcengine 认证选项会优先显示
-`volcengine/*` 和 `volcengine-plan/*` 条目。如果这些模型尚未加载，OpenClaw 会回退到未过滤的目录，而不是显示一个空的按提供商限定的选择器。
+
+当 OpenClaw 作为后台服务运行时，你在交互式 shell 中设置的环境变量不会被自动继承。请参阅上面的守护进程说明。
+
-## 环境说明
+## 相关内容
-如果 Gateway 网关以守护进程方式运行（launchd/systemd），请确保
-`VOLCANO_ENGINE_API_KEY` 对该进程可用（例如放在
-`~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。
+
+
+ 选择提供商、模型引用以及故障切换行为。
+
+
+ 关于智能体、模型和提供商的完整配置参考。
+
+
+ 常见问题和调试步骤。
+
+
+ 关于 OpenClaw 设置的常见问题解答。
+
+