chore(i18n): refresh zh-CN translations

2026-04-25 21:41:41 +00:00 · 2026-04-25 21:41:41 +00:00 · 4775ffa5c6
commit 4775ffa5c6
parent cd008f35b6
3 changed files with 284 additions and 155 deletions
--- a/docs/zh-CN/providers/inworld.md
+++ b/docs/zh-CN/providers/inworld.md
@ -0,0 +1,104 @@
+---
+read_when:
+    - 你希望为外发回复使用 Inworld 语音合成
+    - 你需要来自 Inworld 的 PCM 电话语音或 OGG_OPUS 语音便笺输出
+summary: 用于 OpenClaw 回复的 Inworld 流式文本转语音
+title: Inworld
+x-i18n:
+    generated_at: "2026-04-25T21:40:05Z"
+    model: gpt-5.4
+    provider: openai
+    source_hash: 4c3908b6ab11fd7bd2e18e5c56d1fdc1ac2e52448538d31cc6c83c2c97917641
+    source_path: providers/inworld.md
+    workflow: 15
+---
+
+Inworld 是一个流式文本转语音（TTS）提供商。在 OpenClaw 中，它会为外发回复合成音频（默认是 MP3，语音便笺使用 OGG_OPUS），并为 Voice Call 等电话语音渠道合成 PCM 音频。
+
+OpenClaw 会向 Inworld 的流式 TTS 端点发送请求，将返回的 base64 音频分块拼接为一个单独的缓冲区，然后将结果交给标准的回复音频处理管线。
+
+| 详情 | 值 |
+| ------------- | ----------------------------------------------------------- |
+| 网站 | [inworld.ai](https://inworld.ai) |
+| 文档 | [docs.inworld.ai/tts/tts](https://docs.inworld.ai/tts/tts) |
+| 认证 | `INWORLD_API_KEY`（HTTP Basic，来自控制台的 Base64 凭证） |
+| 默认语音 | `Sarah` |
+| 默认模型 | `inworld-tts-1.5-max` |
+
+## 入门指南
+
+<Steps>
+  <Step title="设置你的 API 密钥">
+    从你的 Inworld 控制台复制凭证（Workspace > API Keys），并将其设置为环境变量。该值会原样作为 HTTP Basic 凭证发送，因此不要再次对它进行 Base64 编码，也不要将其转换为 bearer token。
+
+    ```
+    INWORLD_API_KEY=<base64-credential-from-dashboard>
+    ```
+
+  </Step>
+  <Step title="在 messages.tts 中选择 Inworld">
+    ```json5
+    {
+      messages: {
+        tts: {
+          auto: "always",
+          provider: "inworld",
+          providers: {
+            inworld: {
+              voiceId: "Sarah",
+              modelId: "inworld-tts-1.5-max",
+            },
+          },
+        },
+      },
+    }
+    ```
+  </Step>
+  <Step title="发送一条消息">
+    通过任何已连接的渠道发送回复。OpenClaw 会使用 Inworld 合成音频，并将其作为 MP3 发送（如果渠道需要语音便笺，则发送为 OGG_OPUS）。
+  </Step>
+</Steps>
+
+## 配置选项
+
+| 选项 | 路径 | 说明 |
+| ------------- | -------------------------------------------- | ----------------------------------------------------------------- |
+| `apiKey` | `messages.tts.providers.inworld.apiKey` | Base64 控制台凭证。未设置时回退到 `INWORLD_API_KEY`。 |
+| `baseUrl` | `messages.tts.providers.inworld.baseUrl` | 覆盖 Inworld API 基础 URL（默认 `https://api.inworld.ai`）。 |
+| `voiceId` | `messages.tts.providers.inworld.voiceId` | 语音标识符（默认 `Sarah`）。 |
+| `modelId` | `messages.tts.providers.inworld.modelId` | TTS 模型 id（默认 `inworld-tts-1.5-max`）。 |
+| `temperature` | `messages.tts.providers.inworld.temperature` | 采样温度 `0..2`（可选）。 |
+
+## 说明
+
+<AccordionGroup>
+  <Accordion title="身份验证">
+    Inworld 使用 HTTP Basic 认证，并采用单个经过 Base64 编码的凭证字符串。请从 Inworld 控制台原样复制它。提供商会将其作为 `Authorization: Basic <apiKey>` 发送，不会进行任何额外编码，因此不要自行对它进行 Base64 编码，也不要传入 bearer 风格的 token。相同说明见 [TTS 认证说明](/zh-CN/tools/tts#inworld-primary)。
+  </Accordion>
+  <Accordion title="模型">
+    支持的模型 id：`inworld-tts-1.5-max`（默认）、`inworld-tts-1.5-mini`、`inworld-tts-1-max`、`inworld-tts-1`。
+  </Accordion>
+  <Accordion title="音频输出">
+    回复默认使用 MP3。当渠道目标为 `voice-note` 时，OpenClaw 会请求 Inworld 返回 `OGG_OPUS`，这样音频会以原生语音气泡的形式播放。电话语音合成则使用 22050 Hz 的原始 `PCM` 以供电话桥接使用。
+  </Accordion>
+  <Accordion title="自定义端点">
+    使用 `messages.tts.providers.inworld.baseUrl` 覆盖 API 主机。发送请求前会去掉末尾斜杠。
+  </Accordion>
+</AccordionGroup>
+
+## 相关内容
+
+<CardGroup cols={2}>
+  <Card title="文本转语音" href="/zh-CN/tools/tts" icon="waveform-lines">
+    TTS 概览、提供商以及 `messages.tts` 配置。
+  </Card>
+  <Card title="配置" href="/zh-CN/gateway/configuration" icon="gear">
+    包括 `messages.tts` 设置在内的完整配置参考。
+  </Card>
+  <Card title="提供商" href="/zh-CN/providers" icon="grid">
+    所有内置的 OpenClaw 提供商。
+  </Card>
+  <Card title="故障排除" href="/zh-CN/help/troubleshooting" icon="wrench">
+    常见问题和调试步骤。
+  </Card>
+</CardGroup>
--- a/docs/zh-CN/tools/ollama-search.md
+++ b/docs/zh-CN/tools/ollama-search.md
@ -1,34 +1,31 @@
 ---
 read_when:
-    - 你想将 Ollama 用于 `web_search` to=final code omitted
-    - 你想要一个无需密钥的 `web_search` 提供商 to=final code omitted
-    - 你需要 Ollama Web 搜索的设置指引 to=final code omitted
-summary: 通过你已配置的 Ollama 主机使用 Ollama Web 搜索
-title: Ollama Web 搜索 to=final code omitted
+    - 你想使用 Ollama 进行 web_search
+    - 你想要一个无需密钥的 web_search 提供商
+    - 你需要 Ollama Web 搜索的设置指南
+summary: 通过你配置的 Ollama 主机使用 Ollama Web 搜索
+title: Ollama Web 搜索
 x-i18n:
-    generated_at: "2026-04-23T21:09:27Z"
+    generated_at: "2026-04-25T21:40:06Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 68d486c43d80319427302fa77fb77e34b7ffd50e8f096f9cb50ccb8dd77bc0da
+    source_hash: dadee473d4e0674d9261b93adb1ddf77221e949d385fb522ccb630ed0e73d340
    source_path: tools/ollama-search.md
    workflow: 15
 ---

-OpenClaw 支持 **Ollama Web 搜索**，它是一个内置的 `web_search` 提供商。
-它使用 Ollama 的实验性 Web 搜索 API，并返回带有标题、
-URL 和摘要的结构化结果。
+OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商。它使用 Ollama 的网页搜索 API，并返回包含标题、URL 和摘要的结构化结果。

-与 Ollama 模型提供商不同，此设置默认不需要 API 密钥。
-但它确实需要：
+与 Ollama 模型提供商不同，此设置默认不需要 API 密钥。但它需要：

- 一个可被 OpenClaw 访问的 Ollama 主机
+- 一个可从 OpenClaw 访问的 Ollama 主机
 - `ollama signin`

 ## 设置

 <Steps>
  <Step title="启动 Ollama">
-    确保已安装并运行 Ollama。
+    确保 Ollama 已安装并正在运行。
  </Step>
  <Step title="登录">
    运行：
@ -50,8 +47,7 @@ URL 和摘要的结构化结果。
  </Step>
 </Steps>

-如果你已经使用 Ollama 作为模型提供商，Ollama Web 搜索会复用同一个
-已配置主机。
+如果你已经使用 Ollama 作为模型，Ollama Web 搜索会复用同一个已配置的主机。

 ## 配置

@ -67,7 +63,7 @@ URL 和摘要的结构化结果。
 }
 ```

-可选的 Ollama 主机覆盖项：
+可选的 Ollama 主机覆盖：

 ```json5
 {
@ -83,22 +79,17 @@ URL 和摘要的结构化结果。

 如果未显式设置 Ollama base URL，OpenClaw 会使用 `http://127.0.0.1:11434`。

-如果你的 Ollama 主机需要 bearer 认证，OpenClaw 也会将
-`models.providers.ollama.apiKey`（或匹配的、由环境变量支持的提供商认证）
-复用于 Web 搜索请求。
+如果你的 Ollama 主机要求 bearer 身份验证，OpenClaw 也会将 `models.providers.ollama.apiKey`（或对应的由环境变量支持的提供商身份验证）复用于网页搜索请求。

 ## 说明

- 该提供商不需要专门的 Web 搜索 API 密钥字段。
- 如果 Ollama 主机受认证保护，OpenClaw 会在存在时复用常规 Ollama
-  提供商 API 密钥。
- 在设置期间，如果 Ollama 不可达或尚未登录，OpenClaw 会发出警告，但
-  不会阻止选择该提供商。
- 当未配置更高优先级、已带凭证的提供商时，运行时自动检测可以回退到 Ollama Web 搜索。
- 该提供商使用 Ollama 的实验性 `/api/experimental/web_search`
-  端点。
+- 此提供商不需要专门的网页搜索 API 密钥字段。
+- 如果 Ollama 主机受身份验证保护，OpenClaw 会在存在时复用常规 Ollama 提供商 API 密钥。
+- 如果 Ollama 不可访问或尚未登录，OpenClaw 会在设置期间发出警告，但不会阻止选择。
+- 当未配置更高优先级的带凭证提供商时，运行时自动检测可以回退到 Ollama Web 搜索。
+- 该提供商使用 Ollama 的 `/api/web_search` 端点。

 ## 相关内容

- [Web 搜索概览](/zh-CN/tools/web) —— 所有提供商与自动检测
- [Ollama](/zh-CN/providers/ollama) —— Ollama 模型设置与云端/本地模式
+- [Web 搜索概览](/zh-CN/tools/web) -- 所有提供商和自动检测
+- [Ollama](/zh-CN/providers/ollama) -- Ollama 模型设置以及云端/本地模式
--- a/docs/zh-CN/tools/tts.md
+++ b/docs/zh-CN/tools/tts.md
@ -6,77 +6,80 @@ read_when:
 summary: 用于发送回复的文本转语音（TTS）
 title: 文本转语音
 x-i18n:
-    generated_at: "2026-04-25T20:41:59Z"
+    generated_at: "2026-04-25T21:40:07Z"
    model: gpt-5.4
    provider: openai
-    source_hash: b780ad48492ebc91a28d252bec53116a265eabde7ff658b031d9785fba8df34e
+    source_hash: 2c428bb47d626446ca0a8cafac66f3c244af83df921dd3ab9a16c3cb8e321f6b
    source_path: tools/tts.md
    workflow: 15
 ---

-OpenClaw 可以使用 ElevenLabs、Google Gemini、Gradium、Local CLI、Microsoft、MiniMax、OpenAI、Vydra、xAI 或 Xiaomi MiMo 将发送出去的回复转换为音频。
-它适用于 OpenClaw 能发送音频的任何地方。
+OpenClaw 可以使用 ElevenLabs、Google Gemini、Gradium、Inworld、Local CLI、Microsoft、MiniMax、OpenAI、Vydra、xAI 或 Xiaomi MiMo，将发送出去的回复转换为音频。
+它适用于 OpenClaw 可以发送音频的任何地方。

 ## 支持的服务

- **ElevenLabs**（主要或回退提供商）
- **Google Gemini**（主要或回退提供商；使用 Gemini API TTS）
- **Gradium**（主要或回退提供商；支持语音便笺和电话输出）
- **Local CLI**（主要或回退提供商；运行已配置的本地 TTS 命令）
- **Microsoft**（主要或回退提供商；当前内置实现使用 `node-edge-tts`）
- **MiniMax**（主要或回退提供商；使用 T2A v2 API）
- **OpenAI**（主要或回退提供商；也用于摘要）
- **Vydra**（主要或回退提供商；共享的图像、视频和语音提供商）
- **xAI**（主要或回退提供商；使用 xAI TTS API）
- **Xiaomi MiMo**（主要或回退提供商；通过 Xiaomi 聊天补全使用 MiMo TTS）
+- **ElevenLabs**（主提供商或回退提供商）
+- **Google Gemini**（主提供商或回退提供商；使用 Gemini API TTS）
+- **Gradium**（主提供商或回退提供商；支持语音便笺和电话输出）
+- **Inworld**（主提供商或回退提供商；使用 Inworld 流式 TTS API）
+- **Local CLI**（主提供商或回退提供商；运行已配置的本地 TTS 命令）
+- **Microsoft**（主提供商或回退提供商；当前内置实现使用 `node-edge-tts`）
+- **MiniMax**（主提供商或回退提供商；使用 T2A v2 API）
+- **OpenAI**（主提供商或回退提供商；也用于摘要）
+- **Vydra**（主提供商或回退提供商；共享的图像、视频和语音提供商）
+- **xAI**（主提供商或回退提供商；使用 xAI TTS API）
+- **Xiaomi MiMo**（主提供商或回退提供商；通过 Xiaomi chat completions 使用 MiMo TTS）

 ### Microsoft 语音说明

-内置的 Microsoft 语音提供商当前通过 `node-edge-tts` 库使用 Microsoft Edge 的在线神经网络 TTS 服务。它是一个托管服务（不是本地服务），使用 Microsoft 的端点，并且不需要 API 密钥。
-`node-edge-tts` 提供语音配置选项和输出格式，但并非所有选项都受该服务支持。使用 `edge` 的旧版配置和指令输入仍然可用，并会规范化为 `microsoft`。
+当前内置的 Microsoft 语音提供商通过 `node-edge-tts` 库，使用 Microsoft Edge 在线神经网络 TTS 服务。它是托管服务（不是本地服务），使用 Microsoft 端点，并且不需要 API 密钥。
+`node-edge-tts` 提供语音配置选项和输出格式，但并非所有选项都受该服务支持。使用 `edge` 的旧版配置和指令输入仍然有效，并会被规范化为 `microsoft`。

-由于这一路径是没有公开 SLA 或配额说明的公共 Web 服务，请将其视为尽力而为的服务。如果你需要有保证的限制和支持，请使用 OpenAI 或 ElevenLabs。
+由于这一路径是公共 Web 服务，没有公开发布的 SLA 或配额，因此应将其视为尽力而为的服务。如果你需要有保证的限额和支持，请使用 OpenAI 或 ElevenLabs。

 ## 可选键

-如果你想使用 OpenAI、ElevenLabs、Google Gemini、Gradium、MiniMax、Vydra、xAI 或 Xiaomi MiMo：
+如果你想使用 ElevenLabs、Google Gemini、Gradium、Inworld、MiniMax、OpenAI、Vydra、xAI 或 Xiaomi MiMo：

 - `ELEVENLABS_API_KEY`（或 `XI_API_KEY`）
 - `GEMINI_API_KEY`（或 `GOOGLE_API_KEY`）
 - `GRADIUM_API_KEY`
+- `INWORLD_API_KEY`
 - `MINIMAX_API_KEY`；MiniMax TTS 也接受通过 `MINIMAX_OAUTH_TOKEN`、`MINIMAX_CODE_PLAN_KEY` 或 `MINIMAX_CODING_API_KEY` 提供的 Token Plan 认证
 - `OPENAI_API_KEY`
 - `VYDRA_API_KEY`
 - `XAI_API_KEY`
 - `XIAOMI_API_KEY`

-Local CLI 和 Microsoft 语音**不**需要 API 密钥。
+Local CLI 和 Microsoft 语音 **不** 需要 API 密钥。

-如果配置了多个提供商，将优先使用所选提供商，其他提供商作为回退选项。
-自动摘要使用已配置的 `summaryModel`（或 `agents.defaults.model.primary`），因此如果你启用摘要，那个提供商也必须完成身份验证。
+如果配置了多个提供商，则会优先使用选定的提供商，其他提供商将作为回退选项。
+自动摘要使用已配置的 `summaryModel`（或 `agents.defaults.model.primary`），因此如果你启用摘要，该提供商也必须完成认证。

 ## 服务链接

- [OpenAI 文本转语音指南](https://platform.openai.com/docs/guides/text-to-speech)
- [OpenAI 音频 API 参考](https://platform.openai.com/docs/api-reference/audio)
- [ElevenLabs 文本转语音](https://elevenlabs.io/docs/api-reference/text-to-speech)
- [ElevenLabs 身份验证](https://elevenlabs.io/docs/api-reference/authentication)
+- [OpenAI Text-to-Speech guide](https://platform.openai.com/docs/guides/text-to-speech)
+- [OpenAI Audio API reference](https://platform.openai.com/docs/api-reference/audio)
+- [ElevenLabs Text to Speech](https://elevenlabs.io/docs/api-reference/text-to-speech)
+- [ElevenLabs Authentication](https://elevenlabs.io/docs/api-reference/authentication)
 - [Gradium](/zh-CN/providers/gradium)
+- [Inworld TTS API](https://docs.inworld.ai/tts/tts)
 - [MiniMax T2A v2 API](https://platform.minimaxi.com/document/T2A%20V2)
- [Xiaomi MiMo 语音合成](/zh-CN/providers/xiaomi#text-to-speech)
+- [Xiaomi MiMo speech synthesis](/zh-CN/providers/xiaomi#text-to-speech)
 - [node-edge-tts](https://github.com/SchneeHertz/node-edge-tts)
- [Microsoft Speech 输出格式](https://learn.microsoft.com/azure/ai-services/speech-service/rest-text-to-speech#audio-outputs)
- [xAI 文本转语音](https://docs.x.ai/developers/rest-api-reference/inference/voice#text-to-speech-rest)
+- [Microsoft Speech output formats](https://learn.microsoft.com/azure/ai-services/speech-service/rest-text-to-speech#audio-outputs)
+- [xAI Text to Speech](https://docs.x.ai/developers/rest-api-reference/inference/voice#text-to-speech-rest)

 ## 默认启用吗？

-不是。自动 TTS 默认**关闭**。可通过配置中的 `messages.tts.auto` 或本地使用 `/tts on` 启用。
+不是。自动 TTS 默认 **关闭**。可在配置中通过 `messages.tts.auto` 启用，或在本地通过 `/tts on` 启用。

-当 `messages.tts.provider` 未设置时，OpenClaw 会按照注册表自动选择顺序，选取第一个已配置的语音提供商。
+当未设置 `messages.tts.provider` 时，OpenClaw 会按照注册表自动选择顺序，选择第一个已配置的语音提供商。

 ## 配置

-TTS 配置位于 `openclaw.json` 中的 `messages.tts` 下。
+TTS 配置位于 `openclaw.json` 的 `messages.tts` 下。
 完整 schema 见 [Gateway 网关配置](/zh-CN/gateway/configuration)。

 ### 最小配置（启用 + 提供商）
@ -92,7 +95,7 @@ TTS 配置位于 `openclaw.json` 中的 `messages.tts` 下。
 }
 ```

-### OpenAI 作为主提供商，ElevenLabs 作为回退
+### OpenAI 主提供商，ElevenLabs 回退

 ```json5
 {
@ -133,7 +136,7 @@ TTS 配置位于 `openclaw.json` 中的 `messages.tts` 下。
 }
 ```

-### Microsoft 作为主提供商（无 API 密钥）
+### Microsoft 主提供商（无 API 密钥）

 ```json5
 {
@ -156,7 +159,7 @@ TTS 配置位于 `openclaw.json` 中的 `messages.tts` 下。
 }
 ```

-### MiniMax 作为主提供商
+### MiniMax 主提供商

 ```json5
 {
@ -180,9 +183,9 @@ TTS 配置位于 `openclaw.json` 中的 `messages.tts` 下。
 }
 ```

-MiniMax TTS 认证解析顺序为 `messages.tts.providers.minimax.apiKey`，然后是已存储的 `minimax-portal` OAuth/token 配置文件，再然后是 Token Plan 环境变量键（`MINIMAX_OAUTH_TOKEN`、`MINIMAX_CODE_PLAN_KEY`、`MINIMAX_CODING_API_KEY`），最后是 `MINIMAX_API_KEY`。当未显式设置 TTS `baseUrl` 时，OpenClaw 可以复用已配置的 `minimax-portal` OAuth 主机用于 Token Plan 语音。
+MiniMax TTS 的认证解析顺序为 `messages.tts.providers.minimax.apiKey`，然后是已存储的 `minimax-portal` OAuth/token 配置文件，然后是 Token Plan 环境变量键（`MINIMAX_OAUTH_TOKEN`、`MINIMAX_CODE_PLAN_KEY`、`MINIMAX_CODING_API_KEY`），最后是 `MINIMAX_API_KEY`。当未显式设置 TTS `baseUrl` 时，OpenClaw 可以复用已配置的 `minimax-portal` OAuth 主机用于 Token Plan 语音。

-### Google Gemini 作为主提供商
+### Google Gemini 主提供商

 ```json5
 {
@ -202,9 +205,33 @@ MiniMax TTS 认证解析顺序为 `messages.tts.providers.minimax.apiKey`，然
 }
 ```

-Google Gemini TTS 使用 Gemini API 密钥路径。这里可使用限制为 Gemini API 的 Google Cloud Console API 密钥，其样式与内置 Google 图像生成提供商使用的密钥相同。解析顺序为 `messages.tts.providers.google.apiKey` -> `models.providers.google.apiKey` -> `GEMINI_API_KEY` -> `GOOGLE_API_KEY`。
+Google Gemini TTS 使用 Gemini API 密钥路径。这里可以使用限制为 Gemini API 的 Google Cloud Console API 密钥，其密钥样式与内置 Google 图像生成提供商使用的相同。解析顺序为 `messages.tts.providers.google.apiKey` -> `models.providers.google.apiKey` -> `GEMINI_API_KEY` -> `GOOGLE_API_KEY`。

-### xAI 作为主提供商
+### Inworld 主提供商
+
+```json5
+{
+  messages: {
+    tts: {
+      auto: "always",
+      provider: "inworld",
+      providers: {
+        inworld: {
+          apiKey: "inworld_api_key",
+          baseUrl: "https://api.inworld.ai",
+          voiceId: "Sarah",
+          modelId: "inworld-tts-1.5-max",
+          temperature: 0.8,
+        },
+      },
+    },
+  },
+}
+```
+
+`apiKey` 值必须是从 Inworld 控制台（Workspace > API Keys）原样复制的 Base64 编码凭证字符串。提供商会将它作为 `Authorization: Basic <apiKey>` 发送，而不会进行任何额外编码，因此不要传入原始 bearer token，也不要自行进行 Base64 编码。该密钥会回退到 `INWORLD_API_KEY` 环境变量。完整设置请参见 [Inworld provider](/zh-CN/providers/inworld)。
+
+### xAI 主提供商

 ```json5
 {
@ -226,9 +253,9 @@ Google Gemini TTS 使用 Gemini API 密钥路径。这里可使用限制为 Gemi
 }
 ```

-xAI TTS 使用与内置 Grok 模型提供商相同的 `XAI_API_KEY` 路径。解析顺序为 `messages.tts.providers.xai.apiKey` -> `XAI_API_KEY`。当前可用的语音为 `ara`、`eve`、`leo`、`rex`、`sal` 和 `una`；默认值为 `eve`。`language` 接受 BCP-47 标签或 `auto`。
+xAI TTS 使用与内置 Grok 模型提供商相同的 `XAI_API_KEY` 路径。解析顺序为 `messages.tts.providers.xai.apiKey` -> `XAI_API_KEY`。当前可用语音为 `ara`、`eve`、`leo`、`rex`、`sal` 和 `una`；默认值是 `eve`。`language` 接受 BCP-47 标签或 `auto`。

-### Xiaomi MiMo 作为主提供商
+### Xiaomi MiMo 主提供商

 ```json5
 {
@ -251,9 +278,9 @@ xAI TTS 使用与内置 Grok 模型提供商相同的 `XAI_API_KEY` 路径。解
 }
 ```

-Xiaomi MiMo TTS 使用与内置 Xiaomi 模型提供商相同的 `XIAOMI_API_KEY` 路径。语音提供商 id 是 `xiaomi`；`mimo` 可作为别名。目标文本会作为 assistant 消息发送，符合 Xiaomi 的 TTS 协议。可选的 `style` 会作为用户指令发送，不会被朗读。
+Xiaomi MiMo TTS 使用与内置 Xiaomi 模型提供商相同的 `XIAOMI_API_KEY` 路径。语音提供商 id 为 `xiaomi`；`mimo` 也可作为别名使用。目标文本会作为 assistant message 发送，以匹配 Xiaomi 的 TTS 契约。可选的 `style` 会作为用户指令发送，不会被朗读。

-### OpenRouter 作为主提供商
+### OpenRouter 主提供商

 ```json5
 {
@ -276,7 +303,7 @@ Xiaomi MiMo TTS 使用与内置 Xiaomi 模型提供商相同的 `XIAOMI_API_KEY`

 OpenRouter TTS 使用与内置 OpenRouter 模型提供商相同的 `OPENROUTER_API_KEY` 路径。解析顺序为 `messages.tts.providers.openrouter.apiKey` -> `models.providers.openrouter.apiKey` -> `OPENROUTER_API_KEY`。

-### Local CLI 作为主提供商
+### Local CLI 主提供商

 ```json5
 {
@ -297,10 +324,10 @@ OpenRouter TTS 使用与内置 OpenRouter 模型提供商相同的 `OPENROUTER_A
 }
 ```

-Local CLI TTS 会在 Gateway 网关主机上运行已配置的命令。`{{Text}}`、`{{OutputPath}}`、`{{OutputDir}}` 和 `{{OutputBase}}` 占位符会在 `args` 中展开；如果不存在 `{{Text}}` 占位符，OpenClaw 会将要朗读的文本写入 stdin。`outputFormat` 接受 `mp3`、`opus` 或 `wav`。
+Local CLI TTS 会在 Gateway 网关主机上运行已配置的命令。`{{Text}}`、`{{OutputPath}}`、`{{OutputDir}}` 和 `{{OutputBase}}` 占位符会在 `args` 中展开；如果不存在 `{{Text}}` 占位符，OpenClaw 会将待朗读文本写入 stdin。`outputFormat` 接受 `mp3`、`opus` 或 `wav`。
 语音便笺目标会被转码为 Ogg/Opus，电话输出会使用 `ffmpeg` 转码为原始 16 kHz 单声道 PCM。旧版提供商别名 `cli` 仍然可用，但新配置应使用 `tts-local-cli`。

-### Gradium 作为主提供商
+### Gradium 主提供商

 ```json5
 {
@ -351,7 +378,7 @@ Local CLI TTS 会在 Gateway 网关主机上运行已配置的命令。`{{Text}}
 }
 ```

-### 仅在收到入站语音消息后用音频回复
+### 仅在收到语音消息后用音频回复

 ```json5
 {
@ -384,53 +411,57 @@ Local CLI TTS 会在 Gateway 网关主机上运行已配置的命令。`{{Text}}
 ### 字段说明

 - `auto`：自动 TTS 模式（`off`、`always`、`inbound`、`tagged`）。
-  - `inbound` 仅在收到入站语音消息后发送音频。
-  - `tagged` 仅在回复包含 `[[tts:key=value]]` 指令或 `[[tts:text]]...[[/tts:text]]` 块时发送音频。
- `enabled`：旧版开关（`doctor` 会将其迁移到 `auto`）。
+  - `inbound` 仅会在收到语音消息后发送音频。
+  - `tagged` 仅会在回复包含 `[[tts:key=value]]` 指令或 `[[tts:text]]...[[/tts:text]]` 块时发送音频。
+- `enabled`：旧版开关（`doctor` 会将其迁移为 `auto`）。
 - `mode`：`"final"`（默认）或 `"all"`（包含工具/分块回复）。
- `provider`：语音提供商 id，例如 `"elevenlabs"`、`"google"`、`"gradium"`、`"microsoft"`、`"minimax"`、`"openai"`、`"vydra"`、`"xai"` 或 `"xiaomi"`（回退会自动处理）。
- 如果 `provider` **未设置**，OpenClaw 会按照注册表自动选择顺序使用第一个已配置的语音提供商。
- 旧版 `provider: "edge"` 配置可通过 `openclaw doctor --fix` 修复，并重写为 `provider: "microsoft"`。
- `summaryModel`：用于自动摘要的可选低成本模型；默认是 `agents.defaults.model.primary`。
+- `provider`：语音提供商 id，例如 `"elevenlabs"`、`"google"`、`"gradium"`、`"inworld"`、`"microsoft"`、`"minimax"`、`"openai"`、`"vydra"`、`"xai"` 或 `"xiaomi"`（回退会自动处理）。
+- 如果未设置 `provider`，OpenClaw 会按注册表自动选择顺序使用第一个已配置的语音提供商。
+- 旧版 `provider: "edge"` 配置可由 `openclaw doctor --fix` 修复，并重写为 `provider: "microsoft"`。
+- `summaryModel`：用于自动摘要的可选低成本模型；默认值为 `agents.defaults.model.primary`。
  - 接受 `provider/model` 或已配置的模型别名。
 - `modelOverrides`：允许模型发出 TTS 指令（默认开启）。
-  - `allowProvider` 默认为 `false`（提供商切换需要显式启用）。
- `providers.<id>`：按语音提供商 id 键控的提供商自有设置。
- 旧版直接提供商块（`messages.tts.openai`、`messages.tts.elevenlabs`、`messages.tts.microsoft`、`messages.tts.edge`）可通过 `openclaw doctor --fix` 修复；已提交的配置应使用 `messages.tts.providers.<id>`。
- 旧版 `messages.tts.providers.edge` 也可通过 `openclaw doctor --fix` 修复；已提交的配置应使用 `messages.tts.providers.microsoft`。
- `maxTextLength`：TTS 输入的硬性上限（字符数）。超出时，`/tts audio` 会失败。
- `timeoutMs`：请求超时（毫秒）。
- `prefsPath`：覆盖本地 prefs JSON 路径（提供商/限制/摘要）。
- `apiKey` 值会回退到环境变量（`ELEVENLABS_API_KEY`/`XI_API_KEY`、`GEMINI_API_KEY`/`GOOGLE_API_KEY`、`GRADIUM_API_KEY`、`MINIMAX_API_KEY`、`OPENAI_API_KEY`、`VYDRA_API_KEY`、`XAI_API_KEY`、`XIAOMI_API_KEY`）。
+  - `allowProvider` 默认是 `false`（切换提供商需要显式启用）。
+- `providers.<id>`：由提供商自行管理的设置，按语音提供商 id 键控。
+- 旧版直接提供商块（`messages.tts.openai`、`messages.tts.elevenlabs`、`messages.tts.microsoft`、`messages.tts.edge`）可由 `openclaw doctor --fix` 修复；已提交的配置应使用 `messages.tts.providers.<id>`。
+- 旧版 `messages.tts.providers.edge` 也可由 `openclaw doctor --fix` 修复；已提交的配置应使用 `messages.tts.providers.microsoft`。
+- `maxTextLength`：TTS 输入的硬性上限（字符数）。超过时，`/tts audio` 会失败。
+- `timeoutMs`：请求超时时间（毫秒）。
+- `prefsPath`：覆盖本地 prefs JSON 路径（provider/limit/summary）。
+- `apiKey` 值会回退到环境变量（`ELEVENLABS_API_KEY`/`XI_API_KEY`、`GEMINI_API_KEY`/`GOOGLE_API_KEY`、`GRADIUM_API_KEY`、`INWORLD_API_KEY`、`MINIMAX_API_KEY`、`OPENAI_API_KEY`、`VYDRA_API_KEY`、`XAI_API_KEY`、`XIAOMI_API_KEY`）。
 - `providers.elevenlabs.baseUrl`：覆盖 ElevenLabs API 基础 URL。
 - `providers.openai.baseUrl`：覆盖 OpenAI TTS 端点。
  - 解析顺序：`messages.tts.providers.openai.baseUrl` -> `OPENAI_TTS_BASE_URL` -> `https://api.openai.com/v1`
-  - 非默认值会被视为与 OpenAI 兼容的 TTS 端点，因此接受自定义模型名和语音名。
+  - 非默认值会被视为与 OpenAI 兼容的 TTS 端点，因此可接受自定义模型名和语音名。
 - `providers.elevenlabs.voiceSettings`：
  - `stability`、`similarityBoost`、`style`：`0..1`
  - `useSpeakerBoost`：`true|false`
  - `speed`：`0.5..2.0`（1.0 = 正常）
 - `providers.elevenlabs.applyTextNormalization`：`auto|on|off`
- `providers.elevenlabs.languageCode`：2 字母 ISO 639-1 代码（例如 `en`、`de`）
+- `providers.elevenlabs.languageCode`：2 位 ISO 639-1 代码（例如 `en`、`de`）
 - `providers.elevenlabs.seed`：整数 `0..4294967295`（尽力实现确定性）
 - `providers.minimax.baseUrl`：覆盖 MiniMax API 基础 URL（默认 `https://api.minimax.io`，环境变量：`MINIMAX_API_HOST`）。
 - `providers.minimax.model`：TTS 模型（默认 `speech-2.8-hd`，环境变量：`MINIMAX_TTS_MODEL`）。
 - `providers.minimax.voiceId`：语音标识符（默认 `English_expressive_narrator`，环境变量：`MINIMAX_TTS_VOICE_ID`）。
 - `providers.minimax.speed`：播放速度 `0.5..2.0`（默认 1.0）。
 - `providers.minimax.vol`：音量 `(0, 10]`（默认 1.0；必须大于 0）。
- `providers.minimax.pitch`：整数音高偏移 `-12..12`（默认 0）。在调用 MiniMax T2A 前，小数值会被截断，因为 API 不接受非整数的音高值。
+- `providers.minimax.pitch`：整数音高偏移 `-12..12`（默认 0）。小数值在调用 MiniMax T2A 之前会被截断，因为 API 会拒绝非整数音高值。
 - `providers.tts-local-cli.command`：用于 CLI TTS 的本地可执行文件或命令字符串。
 - `providers.tts-local-cli.args`：命令参数；支持 `{{Text}}`、`{{OutputPath}}`、`{{OutputDir}}` 和 `{{OutputBase}}` 占位符。
- `providers.tts-local-cli.outputFormat`：预期的 CLI 输出格式（`mp3`、`opus` 或 `wav`；音频附件默认 `mp3`）。
+- `providers.tts-local-cli.outputFormat`：预期的 CLI 输出格式（`mp3`、`opus` 或 `wav`；音频附件默认值为 `mp3`）。
 - `providers.tts-local-cli.timeoutMs`：命令超时时间（毫秒，默认 `120000`）。
 - `providers.tts-local-cli.cwd`：可选的命令工作目录。
 - `providers.tts-local-cli.env`：命令的可选字符串环境变量覆盖。
+- `providers.inworld.baseUrl`：覆盖 Inworld API 基础 URL（默认 `https://api.inworld.ai`）。
+- `providers.inworld.voiceId`：Inworld 语音标识符（默认 `Sarah`）。
+- `providers.inworld.modelId`：Inworld TTS 模型（默认 `inworld-tts-1.5-max`；也支持 `inworld-tts-1.5-mini`、`inworld-tts-1-max`、`inworld-tts-1`）。
+- `providers.inworld.temperature`：采样温度 `0..2`（可选）。
 - `providers.google.model`：Gemini TTS 模型（默认 `gemini-3.1-flash-tts-preview`）。
- `providers.google.voiceName`：Gemini 预设语音名称（默认 `Kore`；也接受 `voice`）。
+- `providers.google.voiceName`：Gemini 预置语音名称（默认 `Kore`；也接受 `voice`）。
 - `providers.google.audioProfile`：在朗读文本前附加的自然语言风格提示。
- `providers.google.speakerName`：当你的 TTS 提示使用命名说话人时，在朗读文本前附加的可选说话人标签。
+- `providers.google.speakerName`：当你的 TTS 提示使用具名说话人时，在朗读文本前附加的可选说话人标签。
 - `providers.google.baseUrl`：覆盖 Gemini API 基础 URL。仅接受 `https://generativelanguage.googleapis.com`。
-  - 如果省略 `messages.tts.providers.google.apiKey`，TTS 可在回退到环境变量前复用 `models.providers.google.apiKey`。
+  - 如果省略 `messages.tts.providers.google.apiKey`，则 TTS 可以在回退到环境变量前复用 `models.providers.google.apiKey`。
 - `providers.gradium.baseUrl`：覆盖 Gradium API 基础 URL（默认 `https://api.gradium.ai`）。
 - `providers.gradium.voiceId`：Gradium 语音标识符（默认 Emma，`YTpq7expH9539ERJ`）。
 - `providers.xai.apiKey`：xAI TTS API 密钥（环境变量：`XAI_API_KEY`）。
@ -438,38 +469,38 @@ Local CLI TTS 会在 Gateway 网关主机上运行已配置的命令。`{{Text}}
 - `providers.xai.voiceId`：xAI 语音 id（默认 `eve`；当前在线语音：`ara`、`eve`、`leo`、`rex`、`sal`、`una`）。
 - `providers.xai.language`：BCP-47 语言代码或 `auto`（默认 `en`）。
 - `providers.xai.responseFormat`：`mp3`、`wav`、`pcm`、`mulaw` 或 `alaw`（默认 `mp3`）。
- `providers.xai.speed`：提供商原生速度覆盖值。
+- `providers.xai.speed`：提供商原生速度覆盖。
 - `providers.xiaomi.apiKey`：Xiaomi MiMo API 密钥（环境变量：`XIAOMI_API_KEY`）。
 - `providers.xiaomi.baseUrl`：覆盖 Xiaomi MiMo API 基础 URL（默认 `https://api.xiaomimimo.com/v1`，环境变量：`XIAOMI_BASE_URL`）。
 - `providers.xiaomi.model`：TTS 模型（默认 `mimo-v2.5-tts`，环境变量：`XIAOMI_TTS_MODEL`；也支持 `mimo-v2-tts`）。
 - `providers.xiaomi.voice`：MiMo 语音 id（默认 `mimo_default`，环境变量：`XIAOMI_TTS_VOICE`）。
 - `providers.xiaomi.format`：`mp3` 或 `wav`（默认 `mp3`，环境变量：`XIAOMI_TTS_FORMAT`）。
- `providers.xiaomi.style`：作为 user 消息发送的可选自然语言风格指令；不会被朗读。
+- `providers.xiaomi.style`：可选的自然语言风格指令，会作为用户消息发送；不会被朗读。
 - `providers.openrouter.apiKey`：OpenRouter API 密钥（环境变量：`OPENROUTER_API_KEY`；可复用 `models.providers.openrouter.apiKey`）。
 - `providers.openrouter.baseUrl`：覆盖 OpenRouter TTS 基础 URL（默认 `https://openrouter.ai/api/v1`；旧版 `https://openrouter.ai/v1` 会被规范化）。
 - `providers.openrouter.model`：OpenRouter TTS 模型 id（默认 `hexgrad/kokoro-82m`；也接受 `modelId`）。
 - `providers.openrouter.voice`：提供商特定语音 id（默认 `af_alloy`；也接受 `voiceId`）。
 - `providers.openrouter.responseFormat`：`mp3` 或 `pcm`（默认 `mp3`）。
- `providers.openrouter.speed`：提供商原生速度覆盖值。
- `providers.microsoft.enabled`：允许使用 Microsoft 语音（默认 `true`；无需 API 密钥）。
- `providers.microsoft.voice`：Microsoft 神经网络语音名称（例如 `en-US-MichelleNeural`）。
+- `providers.openrouter.speed`：提供商原生速度覆盖。
+- `providers.microsoft.enabled`：允许使用 Microsoft 语音（默认 `true`；无 API 密钥）。
+- `providers.microsoft.voice`：Microsoft 神经语音名称（例如 `en-US-MichelleNeural`）。
 - `providers.microsoft.lang`：语言代码（例如 `en-US`）。
 - `providers.microsoft.outputFormat`：Microsoft 输出格式（例如 `audio-24khz-48kbitrate-mono-mp3`）。
-  - 有效值请参见 Microsoft Speech 输出格式；并非所有格式都受内置的 Edge 后端传输支持。
+  - 有效值请参见 Microsoft Speech output formats；并非所有格式都受内置的 Edge 后端传输支持。
 - `providers.microsoft.rate` / `providers.microsoft.pitch` / `providers.microsoft.volume`：百分比字符串（例如 `+10%`、`-5%`）。
 - `providers.microsoft.saveSubtitles`：在音频文件旁写入 JSON 字幕。
- `providers.microsoft.proxy`：用于 Microsoft 语音请求的代理 URL。
- `providers.microsoft.timeoutMs`：请求超时覆盖值（毫秒）。
- `edge.*`：同一组 Microsoft 设置的旧版别名。运行 `openclaw doctor --fix` 可将持久化配置重写为 `providers.microsoft`。
+- `providers.microsoft.proxy`：Microsoft 语音请求的代理 URL。
+- `providers.microsoft.timeoutMs`：请求超时覆盖（毫秒）。
+- `edge.*`：同一组 Microsoft 设置的旧版别名。运行 `openclaw doctor --fix` 可将已持久化配置重写为 `providers.microsoft`。

-## 模型驱动的覆盖项（默认开启）
+## 模型驱动的覆盖（默认开启）

 默认情况下，模型**可以**为单条回复发出 TTS 指令。
-当 `messages.tts.auto` 为 `tagged` 时，必须有这些指令才能触发音频。
+当 `messages.tts.auto` 为 `tagged` 时，必须使用这些指令才能触发音频。

-启用后，模型可以发出 `[[tts:...]]` 指令来覆盖单条回复的语音设置，还可以附带可选的 `[[tts:text]]...[[/tts:text]]` 块，以提供只应出现在音频中的表现性标签（笑声、唱歌提示等）。
+启用后，模型可以发出 `[[tts:...]]` 指令来覆盖单条回复的语音设置，还可以附带一个可选的 `[[tts:text]]...[[/tts:text]]` 块，用于提供仅应出现在音频中的表现性标签（笑声、唱歌提示等）。

-除非设置了 `modelOverrides.allowProvider: true`，否则 `provider=...` 指令会被忽略。
+除非设置 `modelOverrides.allowProvider: true`，否则 `provider=...` 指令会被忽略。

 示例回复载荷：

@ -483,11 +514,11 @@ Here you go.
 可用的指令键（启用时）：

 - `provider`（已注册的语音提供商 id，例如 `openai`、`elevenlabs`、`google`、`gradium`、`minimax`、`microsoft`、`vydra`、`xai` 或 `xiaomi`；需要 `allowProvider: true`）
- `voice`（OpenAI、Gradium 或 Xiaomi 语音）、`voiceName` / `voice_name` / `google_voice`（Google 语音），或 `voiceId`（ElevenLabs / Gradium / MiniMax / xAI）
- `model`（OpenAI TTS 模型、ElevenLabs model id、MiniMax 模型或 Xiaomi MiMo TTS 模型）或 `google_model`（Google TTS 模型）
+- `voice`（OpenAI、Gradium 或 Xiaomi 语音）、`voiceName` / `voice_name` / `google_voice`（Google 语音）或 `voiceId`（ElevenLabs / Gradium / MiniMax / xAI）
+- `model`（OpenAI TTS 模型、ElevenLabs 模型 id、MiniMax 模型或 Xiaomi MiMo TTS 模型）或 `google_model`（Google TTS 模型）
 - `stability`、`similarityBoost`、`style`、`speed`、`useSpeakerBoost`
 - `vol` / `volume`（MiniMax 音量，0-10）
- `pitch`（MiniMax 整数音高，-12 到 12；在发起 MiniMax 请求前，小数值会被截断）
+- `pitch`（MiniMax 整数音高，-12 到 12；小数值会在发起 MiniMax 请求前被截断）
 - `applyTextNormalization`（`auto|on|off`）
 - `languageCode`（ISO 639-1）
 - `seed`
@ -506,7 +537,7 @@ Here you go.
 }
 ```

-可选允许列表（在保留其他旋钮可配置的同时启用提供商切换）：
+可选允许列表（启用提供商切换，同时保留其他旋钮可配置）：

 ```json5
 {
@ -522,9 +553,11 @@ Here you go.
 }
 ```

-## 按用户偏好设置
+## 每用户偏好设置

-斜杠命令会将本地覆盖写入 `prefsPath`（默认：`~/.openclaw/settings/tts.json`，可通过 `OPENCLAW_TTS_PREFS` 或 `messages.tts.prefsPath` 覆盖）。
+斜杠命令会将本地覆盖写入 `prefsPath`（默认：
+`~/.openclaw/settings/tts.json`，可通过 `OPENCLAW_TTS_PREFS` 或
+`messages.tts.prefsPath` 覆盖）。

 存储字段：

@ -533,28 +566,29 @@ Here you go.
 - `maxLength`（摘要阈值；默认 1500 个字符）
 - `summarize`（默认 `true`）

-这些字段会覆盖该主机上的 `messages.tts.*`。
+这些设置会覆盖该主机上的 `messages.tts.*`。

 ## 输出格式（固定）

 - **Feishu / Matrix / Telegram / WhatsApp**：语音便笺回复优先使用 Opus（ElevenLabs 使用 `opus_48000_64`，OpenAI 使用 `opus`）。
-  - 48 kHz / 64 kbps 是语音消息中较好的平衡点。
- **Feishu**：当语音便笺回复生成为 MP3/WAV/M4A 或其他可能的音频文件时，Feishu 插件会在发送原生 `audio` 气泡前，使用 `ffmpeg` 将其转码为 48 kHz Ogg/Opus。如果转换失败，Feishu 将收到原始文件作为附件。
+  - 48 kHz / 64 kbps 是语音消息中兼顾效果与体积的较好折中。
+- **Feishu**：当语音便笺回复生成结果为 MP3/WAV/M4A 或其他可能的音频文件时，Feishu 插件会在发送原生 `audio` 气泡前，使用 `ffmpeg` 将其转码为 48 kHz Ogg/Opus。如果转换失败，Feishu 会收到原始文件作为附件。
 - **其他渠道**：MP3（ElevenLabs 使用 `mp3_44100_128`，OpenAI 使用 `mp3`）。
-  - 44.1 kHz / 128 kbps 是语音清晰度的默认平衡设置。
- **MiniMax**：普通音频附件使用 MP3（`speech-2.8-hd` 模型，32 kHz 采样率）。对于 Feishu 和 Telegram 等语音便笺目标，OpenClaw 会在发送前使用 `ffmpeg` 将 MiniMax 的 MP3 转码为 48 kHz Opus。
- **Xiaomi MiMo**：默认使用 MP3，或在配置时使用 WAV。对于 Feishu 和 Telegram 等语音便笺目标，OpenClaw 会在发送前使用 `ffmpeg` 将 Xiaomi 输出转码为 48 kHz Opus。
+  - 44.1 kHz / 128 kbps 是语音清晰度的默认平衡选择。
+- **MiniMax**：普通音频附件使用 MP3（`speech-2.8-hd` 模型，32 kHz 采样率）。对于 Feishu 和 Telegram 等语音便笺目标，OpenClaw 会在发送前使用 `ffmpeg` 将 MiniMax MP3 转码为 48 kHz Opus。
+- **Xiaomi MiMo**：默认使用 MP3，配置时也可使用 WAV。对于 Feishu 和 Telegram 等语音便笺目标，OpenClaw 会在发送前使用 `ffmpeg` 将 Xiaomi 输出转码为 48 kHz Opus。
 - **Local CLI**：使用已配置的 `outputFormat`。语音便笺目标会被转换为 Ogg/Opus，电话输出会使用 `ffmpeg` 转换为原始 16 kHz 单声道 PCM。
- **Google Gemini**：Gemini API TTS 返回原始 24 kHz PCM。OpenClaw 会将其封装为 WAV 用于音频附件，将其转码为 48 kHz Opus 用于语音便笺目标，并为 Talk/电话直接返回 PCM。
- **Gradium**：音频附件使用 WAV，语音便笺目标使用 Opus，电话使用 8 kHz 的 `ulaw_8000`。
+- **Google Gemini**：Gemini API TTS 返回原始 24 kHz PCM。OpenClaw 会将其封装为 WAV 用于音频附件，为语音便笺目标转码为 48 kHz Opus，并为 Talk/电话场景直接返回 PCM。
+- **Gradium**：音频附件使用 WAV，语音便笺目标使用 Opus，电话场景使用 8 kHz 的 `ulaw_8000`。
+- **Inworld**：普通音频附件使用 MP3，语音便笺目标使用原生 `OGG_OPUS`，Talk/电话场景使用 22050 Hz 的原始 `PCM`。
 - **xAI**：默认使用 MP3；`responseFormat` 可为 `mp3`、`wav`、`pcm`、`mulaw` 或 `alaw`。OpenClaw 使用 xAI 的批处理 REST TTS 端点，并返回完整音频附件；此提供商路径不使用 xAI 的流式 TTS WebSocket。此路径不支持原生 Opus 语音便笺格式。
 - **Microsoft**：使用 `microsoft.outputFormat`（默认 `audio-24khz-48kbitrate-mono-mp3`）。
-  - 内置传输支持 `outputFormat`，但并非所有格式都可从该服务获取。
-  - 输出格式值遵循 Microsoft Speech 输出格式（包括 Ogg/WebM Opus）。
+  - 内置传输支持 `outputFormat`，但服务并不提供所有格式。
+  - 输出格式值遵循 Microsoft Speech output formats（包括 Ogg/WebM Opus）。
  - Telegram `sendVoice` 接受 OGG/MP3/M4A；如果你需要有保证的 Opus 语音消息，请使用 OpenAI/ElevenLabs。
-  - 如果配置的 Microsoft 输出格式失败，OpenClaw 会重试使用 MP3。
+  - 如果已配置的 Microsoft 输出格式失败，OpenClaw 会回退重试 MP3。

-OpenAI/ElevenLabs 输出格式按渠道固定（见上文）。
+OpenAI/ElevenLabs 的输出格式按渠道固定（见上文）。

 ## 自动 TTS 行为

@ -562,32 +596,32 @@ OpenAI/ElevenLabs 输出格式按渠道固定（见上文）。

 - 如果回复已包含媒体或 `MEDIA:` 指令，则跳过 TTS。
 - 跳过过短的回复（少于 10 个字符）。
- 启用时，使用 `agents.defaults.model.primary`（或 `summaryModel`）对较长回复生成摘要。
+- 在启用时，使用 `agents.defaults.model.primary`（或 `summaryModel`）对较长回复生成摘要。
 - 将生成的音频附加到回复中。

-如果回复超过 `maxLength`，并且摘要已关闭（或摘要模型没有 API 密钥），则会跳过音频并发送普通文本回复。
+如果回复超过 `maxLength` 且摘要关闭（或摘要模型没有 API 密钥），则会跳过音频，并发送普通文本回复。

 ## 流程图

 ```
-Reply -> TTS enabled?
-  no  -> send text
-  yes -> has media / MEDIA: / short?
-          yes -> send text
-          no  -> length > limit?
-                   no  -> TTS -> attach audio
-                   yes -> summary enabled?
-                            no  -> send text
-                            yes -> summarize (summaryModel or agents.defaults.model.primary)
-                                      -> TTS -> attach audio
+Reply -> 启用 TTS？
+  no  -> 发送文本
+  yes -> 有媒体 / MEDIA: / 太短？
+          yes -> 发送文本
+          no  -> 长度 > 限制？
+                   no  -> TTS -> 附加音频
+                   yes -> 启用摘要？
+                            no  -> 发送文本
+                            yes -> 生成摘要（summaryModel 或 agents.defaults.model.primary）
+                                      -> TTS -> 附加音频
 ```

-## 斜杠命令用法
+## Slash 命令用法

 只有一个命令：`/tts`。
-启用详情见 [斜杠命令](/zh-CN/tools/slash-commands)。
+启用细节请参见 [Slash commands](/zh-CN/tools/slash-commands)。

-Discord 说明：`/tts` 是 Discord 的内置命令，因此 OpenClaw 会在那里将 `/voice` 注册为原生命令。文本形式的 `/tts ...` 仍然可用。
+Discord 说明：`/tts` 是 Discord 内置命令，因此 OpenClaw 会在那里注册 `/voice` 作为原生命令。文本形式的 `/tts ...` 仍然可用。

 ```
 /tts off
@ -601,25 +635,25 @@ Discord 说明：`/tts` 是 Discord 的内置命令，因此 OpenClaw 会在那

 说明：

- 命令需要授权发送者（仍适用 allowlist/owner 规则）。
+- 命令需要已授权的发送者（仍适用 allowlist/owner 规则）。
 - 必须启用 `commands.text` 或原生命令注册。
 - 配置 `messages.tts.auto` 接受 `off|always|inbound|tagged`。
- `/tts on` 会将本地 TTS 偏好写为 `always`；`/tts off` 会将其写为 `off`。
+- `/tts on` 会将本地 TTS 偏好写为 `always`；`/tts off` 会写为 `off`。
 - 当你希望默认值为 `inbound` 或 `tagged` 时，请使用配置。
- `limit` 和 `summary` 存储在本地 prefs 中，而不是主配置中。
- `/tts audio` 会生成一次性音频回复（不会打开 TTS）。
+- `limit` 和 `summary` 存储在本地偏好中，而不是主配置中。
+- `/tts audio` 会生成一次性音频回复（不会切换 TTS 开关）。
 - `/tts status` 包含最近一次尝试的回退可见性：
-  - 成功回退：`Fallback: <primary> -> <used>` 加上 `Attempts: ...`
-  - 失败：`Error: ...` 加上 `Attempts: ...`
+  - 成功回退：`Fallback: <primary> -> <used>` 加 `Attempts: ...`
+  - 失败：`Error: ...` 加 `Attempts: ...`
  - 详细诊断：`Attempt details: provider:outcome(reasonCode) latency`
- OpenAI 和 ElevenLabs API 失败现在会包含解析后的提供商错误详情和请求 id（当提供商返回时），这些信息会显示在 TTS 错误/日志中。
+- OpenAI 和 ElevenLabs API 失败现在会包含已解析的提供商错误详情和请求 id（如果提供商返回），这些信息会显示在 TTS 错误/日志中。

 ## 智能体工具

-`tts` 工具会将文本转换为语音，并返回用于回复投递的音频附件。当渠道为 Feishu、Matrix、Telegram 或 WhatsApp 时，音频会作为语音消息而不是文件附件发送。
-当 `ffmpeg` 可用时，Feishu 在此路径上可以对非 Opus 的 TTS 输出进行转码。
-WhatsApp 会将可见文本与 PTT 语音便笺音频分开发送，因为客户端对语音便笺上的字幕显示并不一致。
-它接受可选的 `channel` 和 `timeoutMs` 字段；`timeoutMs` 是每次调用的提供商请求超时时间（毫秒）。
+`tts` 工具可将文本转换为语音，并返回用于回复投递的音频附件。当渠道为 Feishu、Matrix、Telegram 或 WhatsApp 时，音频会作为语音消息而不是文件附件发送。
+当 `ffmpeg` 可用时，Feishu 可在此路径上转码非 Opus 的 TTS 输出。
+WhatsApp 会将可见文本与 PTT 语音便笺音频分开发送，因为客户端对语音便笺字幕的渲染并不一致。
+它接受可选的 `channel` 和 `timeoutMs` 字段；`timeoutMs` 是单次调用的提供商请求超时时间，单位为毫秒。

 ## Gateway 网关 RPC