openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-12 10:26:36 +00:00
parent fec3a414f7
commit 0ff3fe9870
5 changed files with 523 additions and 285 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

159
docs/zh-CN/providers/chutes.md
View File

@ -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
<Tabs>
<Tab title="OAuth">
<Steps>
<Step title="运行 OAuth 新手引导流程">
```bash
openclaw onboard --auth-choice chutes
```
OpenClaw 会在本地启动浏览器流程，或者在远程 / 无头主机上显示 URL + 粘贴重定向地址的流程。OAuth 令牌会通过 OpenClaw 认证配置文件自动刷新。
</Step>
<Step title="验证默认模型">
完成新手引导后，默认模型会设置为
`chutes/zai-org/GLM-4.7-TEE`，并注册内置的 Chutes 目录。
</Step>
</Steps>
</Tab>
<Tab title="API 密钥">
<Steps>
<Step title="获取 API 密钥">
在
[chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys)
创建一个密钥。
</Step>
<Step title="运行 API 密钥新手引导流程">
```bash
openclaw onboard --auth-choice chutes-api-key
```
</Step>
<Step title="验证默认模型">
完成新手引导后，默认模型会设置为
`chutes/zai-org/GLM-4.7-TEE`，并注册内置的 Chutes 目录。
</Step>
</Steps>
</Tab>
</Tabs>
```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`。
<Note>
两种认证路径都会注册内置的 Chutes 目录，并将默认模型设置为
`chutes/zai-org/GLM-4.7-TEE`。运行时环境变量：`CHUTES_API_KEY`、
`CHUTES_OAUTH_TOKEN`。
</Note>
## 发现行为
当 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 目录注册了三个便捷别名：
}
```
## 说明
<AccordionGroup>
<Accordion title="OAuth 覆盖项">
你可以使用可选环境变量自定义 OAuth 流程：
- OAuth 帮助和重定向应用要求： [Chutes OAuth 文档](https://chutes.ai/docs/sign-in-with-chutes/overview)
- API 密钥和 OAuth 发现都使用相同的 `chutes` 提供商 id。
- Chutes 模型会注册为 `chutes/<model-id>`。
| 变量 | 用途 |
| -------- | ------- |
| `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)。
</Accordion>
<Accordion title="说明">
- API 密钥和 OAuth 发现都使用相同的 `chutes` 提供商 id。
- Chutes 模型会注册为 `chutes/<model-id>`。
- 如果启动时发现失败，会自动使用内置静态目录。
</Accordion>
</AccordionGroup>
## 相关内容
<CardGroup cols={2}>
<Card title="模型提供商" href="/zh-CN/concepts/model-providers" icon="layers">
提供商规则、模型引用和故障转移行为。
</Card>
<Card title="配置参考" href="/zh-CN/gateway/configuration-reference" icon="gear">
完整的配置 schema，包括提供商设置。
</Card>
<Card title="Chutes" href="https://chutes.ai" icon="arrow-up-right-from-square">
Chutes 控制台和 API 文档。
</Card>
<Card title="Chutes API keys" href="https://chutes.ai/settings/api-keys" icon="key">
创建和管理 Chutes API 密钥。
</Card>
</CardGroup>

187
docs/zh-CN/providers/deepgram.md
View File

@ -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 密钥：
<Steps>
<Step title="设置你的 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,
</Step>
<Step title="启用音频提供商">
```json5
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "deepgram", model: "nova-3" }],
},
},
models: [{ provider: "deepgram", model: "nova-3" }],
},
},
},
}
```
}
```
</Step>
<Step title="发送语音便笺">
通过任意已连接的渠道发送一条音频消息。OpenClaw 会通过 Deepgram 对其进行转录，并将转录文本注入回复流水线中。
</Step>
</Steps>
## 配置选项
| 选项 | 路径 | 说明 |
| ----------------- | ------------------------------------------------------------ | ------------------------------------- |
| `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` | 启用智能格式化（可选） |
<Tabs>
<Tab title="带语言提示">
```json5
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
},
},
},
}
```
</Tab>
<Tab title="带 Deepgram 选项">
```json5
{
tools: {
media: {
audio: {
enabled: true,
providerOptions: {
deepgram: {
detect_language: true,
punctuate: true,
smart_format: true,
},
},
models: [{ provider: "deepgram", model: "nova-3" }],
},
},
},
}
```
</Tab>
</Tabs>
## 说明
- 认证遵循标准提供商凭证顺序；`DEEPGRAM_API_KEY` 是最简单的方式。
- 使用代理时，可通过 `tools.media.audio.baseUrl` 和 `tools.media.audio.headers` 覆盖端点或请求头。
- 输出遵循与其他提供商相同的音频规则（大小上限、超时、转录文本注入）。
<AccordionGroup>
<Accordion title="身份验证">
身份验证遵循标准的提供商认证顺序。`DEEPGRAM_API_KEY` 是最简单的方式。
</Accordion>
<Accordion title="代理和自定义端点">
使用代理时，可通过 `tools.media.audio.baseUrl` 和 `tools.media.audio.headers` 覆盖端点或请求头。
</Accordion>
<Accordion title="输出行为">
输出遵循与其他提供商相同的音频规则（大小上限、超时、转录文本注入）。
</Accordion>
</AccordionGroup>
<Note>
Deepgram 转录**仅支持预录音**（不是实时分块流式传输）。OpenClaw 会上传完整的音频文件，并在将其注入对话之前等待完整的转录结果。
</Note>
## 相关内容
<CardGroup cols={2}>
<Card title="媒体工具" href="/tools/media" icon="photo-film">
音频、图像和视频处理流水线概览。
</Card>
<Card title="配置" href="/zh-CN/gateway/configuration" icon="gear">
完整的配置参考，包括媒体工具设置。
</Card>
<Card title="故障排除" href="/zh-CN/help/troubleshooting" icon="wrench">
常见问题和调试步骤。
</Card>
<Card title="常见问题" href="/zh-CN/help/faq" icon="circle-question">
关于 OpenClaw 设置的常见问题。
</Card>
</CardGroup>

148
docs/zh-CN/providers/synthetic.md
View File

@ -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
```
<Steps>
<Step title="获取 API 密钥">
从你的 Synthetic 账户获取 `SYNTHETIC_API_KEY`，或者让新手引导向导提示你输入。
</Step>
<Step title="运行新手引导">
```bash
openclaw onboard --auth-choice synthetic-api-key
```
</Step>
<Step title="验证默认模型">
完成新手引导后，默认模型将设置为：
```
synthetic/hf:MiniMaxAI/MiniMax-M2.5
```
</Step>
</Steps>
默认模型设置为：
```
synthetic/hf:MiniMaxAI/MiniMax-M2.5
```
<Warning>
OpenClaw 的 Anthropic 客户端会自动在 base URL 后追加 `/v1`，因此请使用
`https://api.synthetic.new/anthropic`（而不是 `/anthropic/v1`）。如果 Synthetic
更改了它的 base URL，请覆盖 `models.providers.synthetic.baseUrl`。
</Warning>
## 配置示例
@ -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 | 是 | 文本 |
## 说明
<Tip>
模型引用使用 `synthetic/<modelId>` 这种形式。使用
`openclaw models list --provider synthetic` 查看你的账户上可用的所有模型。
</Tip>
- 模型引用使用 `synthetic/<modelId>`。
- 如果你启用了模型 allowlist（`agents.defaults.models`），请添加你
计划使用的每一个模型。
- 提供商规则请参见[模型提供商](/zh-CN/concepts/model-providers)。
<AccordionGroup>
<Accordion title="模型允许列表">
如果你启用了模型允许列表（`agents.defaults.models`），请添加你计划使用的每个
Synthetic 模型。不在允许列表中的模型将对智能体隐藏。
</Accordion>
<Accordion title="Base URL 覆盖">
如果 Synthetic 更改了其 API 端点，请在你的配置中覆盖 base URL：
```json5
{
models: {
providers: {
synthetic: {
baseUrl: "https://new-api.synthetic.new/anthropic",
},
},
},
}
```
请记住，OpenClaw 会自动追加 `/v1`。
</Accordion>
</AccordionGroup>
## 相关内容
<CardGroup cols={2}>
<Card title="模型提供商" href="/zh-CN/concepts/model-providers" icon="layers">
提供商规则、模型引用和故障转移行为。
</Card>
<Card title="配置参考" href="/zh-CN/gateway/configuration-reference" icon="gear">
完整的配置 schema，包括提供商设置。
</Card>
<Card title="Synthetic" href="https://synthetic.new" icon="arrow-up-right-from-square">
Synthetic 控制台和 API 文档。
</Card>
</CardGroup>

150
docs/zh-CN/providers/together.md
View File

@ -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 网关 存储它）：
<Steps>
<Step title="获取 API 密钥">
在
[api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys)
创建一个 API 密钥。
</Step>
<Step title="运行新手引导">
```bash
openclaw onboard --auth-choice together-api-key
```
</Step>
<Step title="设置默认模型">
```json5
{
agents: {
defaults: {
model: { primary: "together/moonshotai/Kimi-K2.5" },
},
},
}
```
</Step>
</Steps>
```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`）。
<Note>
新手引导预设会将 `together/moonshotai/Kimi-K2.5` 设置为默认模型。
</Note>
## 内置目录
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)。
<Tip>
参见 [视频生成](/zh-CN/tools/video-generation)，了解共享工具参数、提供商选择和故障切换行为。
</Tip>
<AccordionGroup>
<Accordion title="环境说明">
如果 Gateway 网关 作为守护进程运行（launchd/systemd），请确保
`TOGETHER_API_KEY` 对该进程可用（例如在
`~/.openclaw/.env` 中，或通过 `env.shellEnv`）。
<Warning>
仅在你的交互式 shell 中设置的密钥对由守护进程管理的
Gateway 网关 进程不可见。请使用 `~/.openclaw/.env` 或
`env.shellEnv` 配置来确保持续可用。
</Warning>
</Accordion>
<Accordion title="故障排除">
- 验证你的密钥是否可用：`openclaw models list --provider together`
- 如果模型没有显示，请确认 API 密钥已在你的 Gateway 网关 进程对应的正确环境中设置。
- 模型引用使用 `together/<model-id>` 这种格式。
</Accordion>
</AccordionGroup>
## 相关内容
<CardGroup cols={2}>
<Card title="模型提供商" href="/zh-CN/concepts/model-providers" icon="layers">
提供商规则、模型引用和故障切换行为。
</Card>
<Card title="视频生成" href="/zh-CN/tools/video-generation" icon="video">
共享视频生成工具参数和提供商选择。
</Card>
<Card title="配置参考" href="/zh-CN/gateway/configuration-reference" icon="gear">
完整的配置 schema，包括提供商设置。
</Card>
<Card title="Together AI" href="https://together.ai" icon="arrow-up-right-from-square">
Together AI 控制台、API 文档和定价。
</Card>
</CardGroup>

164
docs/zh-CN/providers/volcengine.md
View File

@ -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 密钥：
<Steps>
<Step title="设置 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" },
},
},
}
```
</Step>
<Step title="设置默认模型">
```json5
{
agents: {
defaults: {
model: { primary: "volcengine-plan/ark-code-latest" },
},
},
}
```
</Step>
<Step title="验证模型可用">
```bash
openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
```
</Step>
</Steps>
## 非交互式示例
<Tip>
对于非交互式设置（CI、脚本），可直接传入密钥：
```bash
openclaw onboard --non-interactive \
@ -50,46 +65,81 @@ openclaw onboard --non-interactive \
--volcengine-api-key "$VOLCANO_ENGINE_API_KEY"
```
</Tip>
## 提供商和端点
| 提供商 | 端点 | 使用场景 |
| ----------------- | ----------------------------------------- | ---------- |
| `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 密钥进行配置。设置时会自动同时注册二者。
<Note>
这两个提供商都通过同一个 API 密钥进行配置。设置时会自动同时注册两者。
</Note>
## 可用模型
通用提供商（`volcengine`）：
<Tabs>
<Tab title="通用（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 |
</Tab>
<Tab title="编程（volcengine-plan)">
| 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 |
</Tab>
</Tabs>
| 模型引用 | 名称 | 输入 | 上下文 |
| -------------------------------------------- | ------------------------------- | ----------- | ------- |
| `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`）：
<AccordionGroup>
<Accordion title="新手引导后的默认模型">
`openclaw onboard --auth-choice volcengine-api-key` 当前会将
`volcengine-plan/ark-code-latest` 设为默认模型，同时也会注册通用的 `volcengine` 模型目录。
</Accordion>
| 模型引用 | 名称 | 输入 | 上下文 |
| ------------------------------------------------- | ------------------------ | ----- | ------- |
| `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 |
<Accordion title="模型选择器的回退行为">
在新手引导/配置模型选择期间，Volcengine 认证选项会优先显示
`volcengine/*` 和 `volcengine-plan/*` 条目。如果这些模型尚未加载，
OpenClaw 会回退到未筛选的模型目录，而不是显示一个空的按提供商范围筛选的选择器。
</Accordion>
`openclaw onboard --auth-choice volcengine-api-key` 当前会将
`volcengine-plan/ark-code-latest` 设为默认模型，同时也会注册通用的 `volcengine` 目录。
<Accordion title="守护进程的环境变量">
如果 Gateway 网关以守护进程方式运行（launchd/systemd），请确保
`VOLCANO_ENGINE_API_KEY` 对该进程可用（例如放在
`~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。
</Accordion>
</AccordionGroup>
在新手引导/配置的模型选择过程中，Volcengine 认证选项会优先显示
`volcengine/*` 和 `volcengine-plan/*` 条目。如果这些模型尚未加载，OpenClaw 会回退到未过滤的目录，而不是显示一个空的按提供商限定的选择器。
<Warning>
当 OpenClaw 作为后台服务运行时，你在交互式 shell 中设置的环境变量不会被自动继承。请参阅上面的守护进程说明。
</Warning>
## 环境说明
## 相关内容
如果 Gateway 网关以守护进程方式运行（launchd/systemd），请确保
`VOLCANO_ENGINE_API_KEY` 对该进程可用（例如放在
`~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。
<CardGroup cols={2}>
<Card title="模型选择" href="/zh-CN/concepts/model-providers" icon="layers">
选择提供商、模型引用以及故障切换行为。
</Card>
<Card title="配置" href="/zh-CN/gateway/configuration" icon="gear">
关于智能体、模型和提供商的完整配置参考。
</Card>
<Card title="故障排除" href="/zh-CN/help/troubleshooting" icon="wrench">
常见问题和调试步骤。
</Card>
<Card title="常见问题" href="/zh-CN/help/faq" icon="circle-question">
关于 OpenClaw 设置的常见问题解答。
</Card>
</CardGroup>