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-05-02 04:53:53 +00:00
parent c86772259e
commit 2eca65c04f
2 changed files with 141 additions and 145 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
docs/zh-CN/concepts/usage-tracking.md
View File

@ -1,56 +1,51 @@
---
read_when:
- 你正在接入提供商用量 / 配额界面
- 你需要解释用量跟踪行为或认证要求
- 你正在连接提供商用量/配额界面
- 你需要解释使用情况跟踪行为或身份验证要求
summary: 用量跟踪界面和凭证要求
title: 用量跟踪
title: 使用情况跟踪
x-i18n:
generated_at: "2026-04-23T22:57:41Z"
model: gpt-5.4
generated_at: "2026-05-02T04:52:57Z"
model: gpt-5.5
provider: openai
source_hash: 21c2ae0c32d9f28b301abed22d6edcb423d46831cb1d78f4c2908df0ecf82854
source_hash: 4faa5daff55668a6be73981b730edece51939d99954e784907c99fb101fcaaa7
source_path: concepts/usage-tracking.md
workflow: 15
workflow: 16
---
## 它是什么
- 直接从提供商的用量端点拉取提供商用量 / 配额。
- 不提供估算成本；只使用提供商报告的时间窗口。
- 人类可读的状态输出会统一规范为 `X% left`，即使上游 API 报告的是已消费配额、剩余配额，或仅提供原始计数。
- 会话级 `/status` 和 `session_status` 在实时会话快照信息较少时，可以回退到最新的转录用量条目。该回退可补齐缺失的 token / cache 计数器，可恢复当前运行时模型标签，并且当会话元数据缺失或值更小时，会优先采用更大的、偏向提示词的总量。现有的非零实时值仍然优先。
- 直接从提供商的使用量端点拉取提供商使用量/配额。
- 不估算费用；仅使用提供商报告的时间窗口。
- 人类可读的 Status 输出会统一为 `X% left`，即使上游 API 报告的是已消耗配额、剩余配额，或只有原始计数。
- 当实时会话快照信息稀疏时，会话级 `/status` 和 `session_status` 可以回退到最新的 transcript 使用量条目。该回退会填补缺失的 token/cache 计数器，可以恢复活跃运行时的模型标签，并在会话元数据缺失或较小时优先使用更大的、面向 prompt 的总量。已有的非零实时值仍然优先。
## 它显示在哪里
## 显示位置
- 聊天中的 `/status`：带有丰富 emoji 的状态卡片，显示会话 token 数和估算成本（仅 API key）。如果可用，还会显示**当前模型提供商**的提供商用量，格式统一为 `X% left` 窗口。
- 聊天中的 `/usage off|tokens|full`：每次响应后的用量页脚（OAuth 仅显示 token）。
- 聊天中的 `/usage cost`：从 OpenClaw 会话日志聚合的本地成本摘要。
- CLI：`openclaw status --usage` 输出完整的按提供商划分明细。
- CLI：`openclaw channels list` 会在提供商配置旁输出相同的用量快照（使用 `--no-usage` 可跳过）。
- macOS 菜单栏：Context 下的 “Usage” 部分（仅在可用时显示）。
- 聊天中的 `/status`：包含会话 token + 估算费用（仅 API 密钥）的富 emoji Status 卡片。可用时，提供商使用量会针对**当前模型提供商**显示为统一的 `X% left` 时间窗口。
- 聊天中的 `/usage off|tokens|full`：每次响应的使用量页脚（OAuth 仅显示 token）。
- 聊天中的 `/usage cost`：从 OpenClaw 会话日志聚合的本地费用摘要。
- CLI：`openclaw status --usage` 打印完整的逐提供商明细。
- CLI：`openclaw channels list` 在提供商配置旁打印相同的使用量快照（使用 `--no-usage` 跳过）。
- macOS 菜单栏：上下文下的“使用量”部分（仅在可用时）。
## 提供商和凭证
## 提供商 + 凭证
- **Anthropic（Claude）**：认证配置文件中的 OAuth token。
- **GitHub Copilot**：认证配置文件中的 OAuth token。
- **Gemini CLI**：认证配置文件中的 OAuth token。
- JSON 用量会回退到 `stats`；`stats.cached` 会被规范化为
`cacheRead`。
- **OpenAI Codex**：认证配置文件中的 OAuth token（如存在则使用 accountId）。
- **MiniMax**：API key 或 MiniMax OAuth 认证配置文件。OpenClaw 将
`minimax`、`minimax-cn` 和 `minimax-portal` 视为同一个 MiniMax 配额界面，优先使用已存储的 MiniMax OAuth，否则回退到
`MINIMAX_CODE_PLAN_KEY`、`MINIMAX_CODING_API_KEY` 或 `MINIMAX_API_KEY`。
MiniMax 原始的 `usage_percent` / `usagePercent` 字段表示的是**剩余**
配额，因此 OpenClaw 会在显示前将其反转；如存在基于计数的字段，则优先使用计数字段。
- 编码计划窗口标签优先来自提供商的小时 / 分钟字段，如不存在，则回退到 `start_time` / `end_time` 的时间跨度。
- 如果编码计划端点返回 `model_remains`，OpenClaw 会优先选择聊天模型条目，在缺少显式 `window_hours` / `window_minutes` 字段时根据时间戳推导窗口标签，并在计划标签中包含模型名称。
- **Xiaomi MiMo**：通过环境变量 / 配置 / auth 存储提供 API key（`XIAOMI_API_KEY`）。
- **z.ai**：通过环境变量 / 配置 / auth 存储提供 API key。
- JSON 使用量会回退到 `stats`；`stats.cached` 会规范化为 `cacheRead`。
- **OpenAI Codex**：认证配置文件中的 OAuth token（存在时使用 accountId）。
- **MiniMax**：API 密钥或 MiniMax OAuth 认证配置文件。OpenClaw 将 `minimax`、`minimax-cn` 和 `minimax-portal` 视为同一个 MiniMax 配额表面，存在已存储的 MiniMax OAuth 时优先使用，否则回退到 `MINIMAX_CODE_PLAN_KEY`、`MINIMAX_CODING_API_KEY` 或 `MINIMAX_API_KEY`。配置后，使用量轮询会从 `models.providers.minimax-portal.baseUrl` 或 `models.providers.minimax.baseUrl` 推导 Coding Plan 主机，否则使用 MiniMax CN 主机。MiniMax 的原始 `usage_percent` / `usagePercent` 字段表示**剩余**配额，因此 OpenClaw 会在显示前对其取反；存在基于计数的字段时，计数字段优先。
- Coding Plan 时间窗口标签会在存在时来自提供商的小时/分钟字段，然后回退到 `start_time` / `end_time` 时间跨度。
- 如果 Coding Plan 端点返回 `model_remains`，OpenClaw 会优先使用聊天模型条目，在缺少显式 `window_hours` / `window_minutes` 字段时从时间戳推导时间窗口标签，并在套餐标签中包含模型名称。
- **Xiaomi MiMo**：通过 env/配置/认证存储提供的 API 密钥（`XIAOMI_API_KEY`）。
- **z.ai**：通过 env/配置/认证存储提供的 API 密钥。
当无法解析出可用的提供商用量认证信息时，用量会被隐藏。提供商可以提供插件专属的用量认证逻辑；否则 OpenClaw 会回退为匹配来自认证配置文件、环境变量或配置中的 OAuth / API key 凭证。
当无法解析可用的提供商使用量认证时，会隐藏使用量。提供商可以提供插件专用的使用量认证逻辑；否则 OpenClaw 会回退到从认证配置文件、环境变量或配置中匹配 OAuth/API 密钥凭证。
## 相关内容
## 相关
- [Token 使用与成本](/zh-CN/reference/token-use)
- [API 用量与成本](/zh-CN/reference/api-usage-costs)
- [提示词缓存](/zh-CN/reference/prompt-caching)
- [Token 使用量和费用](/zh-CN/reference/token-use)
- [API 使用量和费用](/zh-CN/reference/api-usage-costs)
- [Prompt 缓存](/zh-CN/reference/prompt-caching)

219
docs/zh-CN/providers/minimax.md
View File

@ -5,10 +5,10 @@ read_when:
summary: 在 OpenClaw 中使用 MiniMax 模型
title: MiniMax
x-i18n:
generated_at: "2026-05-02T04:48:01Z"
generated_at: "2026-05-02T04:52:53Z"
model: gpt-5.5
provider: openai
source_hash: 3becdbd14243ce0817d630e6af70559a9b2c9f66860d3f588fef0a118034d2f9
source_hash: 7c7aea4d9656d6ffddab7c43b06940e58bdd119a03b62000e689a3348f7df5a2
source_path: providers/minimax.md
workflow: 16
---
@ -24,59 +24,59 @@ MiniMax 还提供：
提供商拆分：
| 提供商 ID | 身份验证 | 能力 |
| ---------------- | -------- | ----------------------------------------------------------------------------------------------------- |
| `minimax` | API 密钥 | 文本、图像生成、音乐生成、视频生成、图像理解、语音、Web 搜索 |
| `minimax-portal` | OAuth | 文本、图像生成、音乐生成、视频生成、图像理解、语音 |
| 提供商 ID | 凭证 | 能力 |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `minimax` | API key | 文本、图像生成、音乐生成、视频生成、图像理解、语音、Web 搜索 |
| `minimax-portal` | OAuth | 文本、图像生成、音乐生成、视频生成、图像理解、语音 |
## 内置目录
| 模型 | 类型 | 描述 |
| ------------------------ | -------------- | ---------------------------- |
| `MiniMax-M2.7` | 聊天（推理） | 默认托管推理模型 |
| `MiniMax-M2.7-highspeed` | 聊天（推理） | 更快的 M2.7 推理层级 |
| `MiniMax-VL-01` | 视觉 | 图像理解模型 |
| `image-01` | 图像生成 | 文本生成图像和图像到图像编辑 |
| `music-2.6` | 音乐生成 | 默认音乐模型 |
| `music-2.5` | 音乐生成 | 上一个音乐生成层级 |
| `music-2.0` | 音乐生成 | 旧版音乐生成层级 |
| `MiniMax-Hailuo-2.3` | 视频生成 | 文本生成视频和图像参考流程 |
| 模型 | 类型 | 描述 |
| ------------------------ | ---------------- | ---------------------------------------- |
| `MiniMax-M2.7` | 聊天（推理） | 默认托管推理模型 |
| `MiniMax-M2.7-highspeed` | 聊天（推理） | 更快的 M2.7 推理层级 |
| `MiniMax-VL-01` | 视觉 | 图像理解模型 |
| `image-01` | 图像生成 | 文生图和图生图编辑 |
| `music-2.6` | 音乐生成 | 默认音乐模型 |
| `music-2.5` | 音乐生成 | 上一代音乐生成层级 |
| `music-2.0` | 音乐生成 | 旧版音乐生成层级 |
| `MiniMax-Hailuo-2.3` | 视频生成 | 文生视频和图像参考流程 |
## 入门指南
选择你偏好的身份验证方式，并按照设置步骤操作。
选择你偏好的凭证方式并按照设置步骤操作。
<Tabs>
<Tab title="OAuth（Coding Plan）">
**最适合：**通过 OAuth 快速设置 MiniMax Coding Plan，无需 API 密钥。
<Tab title="OAuth (Coding Plan)">
**最适合：** 通过 OAuth 快速设置 MiniMax Coding Plan，无需 API key。
<Tabs>
<Tab title="国际版">
<Tab title="International">
<Steps>
<Step title="运行新手引导">
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice minimax-global-oauth
```
这会针对 `api.minimax.io` 进行身份验证。
</Step>
<Step title="验证模型可用">
<Step title="Verify the model is available">
```bash
openclaw models list --provider minimax-portal
```
</Step>
</Steps>
</Tab>
<Tab title="中国">
<Tab title="China">
<Steps>
<Step title="运行新手引导">
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice minimax-cn-oauth
```
这会针对 `api.minimaxi.com` 进行身份验证。
</Step>
<Step title="验证模型可用">
<Step title="Verify the model is available">
```bash
openclaw models list --provider minimax-portal
```
@ -86,7 +86,7 @@ MiniMax 还提供：
</Tabs>
<Note>
OAuth 设置使用 `minimax-portal` 提供商 ID。模型引用遵循 `minimax-portal/MiniMax-M2.7` 形式。
OAuth 设置使用 `minimax-portal` 提供商 ID。模型引用遵循 `minimax-portal/MiniMax-M2.7` 格式。
</Note>
<Tip>
@ -95,36 +95,36 @@ MiniMax 还提供：
</Tab>
<Tab title="API 密钥">
**最适合：**使用与 Anthropic 兼容的 API 托管 MiniMax。
<Tab title="API key">
**最适合：** 使用 Anthropic 兼容 API 的托管 MiniMax。
<Tabs>
<Tab title="国际版">
<Tab title="International">
<Steps>
<Step title="运行新手引导">
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice minimax-global-api
```
这会将 `api.minimax.io` 配置为基础 URL。
</Step>
<Step title="验证模型可用">
<Step title="Verify the model is available">
```bash
openclaw models list --provider minimax
```
</Step>
</Steps>
</Tab>
<Tab title="中国">
<Tab title="China">
<Steps>
<Step title="运行新手引导">
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice minimax-cn-api
```
这会将 `api.minimaxi.com` 配置为基础 URL。
</Step>
<Step title="验证模型可用">
<Step title="Verify the model is available">
```bash
openclaw models list --provider minimax
```
@ -173,11 +173,11 @@ MiniMax 还提供：
```
<Warning>
在与 Anthropic 兼容的流式传输路径上，除非你显式设置 `thinking`，否则 OpenClaw 默认会禁用 MiniMax thinking。MiniMax 的流式端点会以 OpenAI 风格的 delta 块发出 `reasoning_content`，而不是原生 Anthropic thinking 块；如果隐式保持启用，内部推理可能会泄露到可见输出中。
在 Anthropic 兼容的流式传输路径上，除非你显式设置 `thinking`，否则 OpenClaw 默认会禁用 MiniMax thinking。MiniMax 的流式传输端点会以 OpenAI 风格的增量块发出 `reasoning_content`，而不是原生 Anthropic thinking blocks；如果隐式保持启用，可能会把内部推理泄露到可见输出中。
</Warning>
<Note>
API 密钥设置使用 `minimax` 提供商 ID。模型引用遵循 `minimax/MiniMax-M2.7` 形式。
API key 设置使用 `minimax` 提供商 ID。模型引用遵循 `minimax/MiniMax-M2.7` 格式。
</Note>
</Tab>
@ -185,7 +185,7 @@ MiniMax 还提供：
## 通过 `openclaw configure` 配置
使用交互式配置向导设置 MiniMax，无需编辑 JSON：
使用交互式配置向导来设置 MiniMax，无需编辑 JSON：
<Steps>
<Step title="启动向导">
@ -193,22 +193,22 @@ MiniMax 还提供：
openclaw configure
```
</Step>
<Step title="选择模型/认证">
从菜单中选择 **模型/认证**。
<Step title="选择模型/身份验证">
从菜单中选择 **模型/身份验证**。
</Step>
<Step title="选择 MiniMax 认证选项">
<Step title="选择一个 MiniMax 身份验证选项">
选择一个可用的 MiniMax 选项：
| 认证选择 | 描述 |
| 身份验证选项 | 说明 |
| --- | --- |
| `minimax-global-oauth` | 国际 OAuth（Coding Plan） |
| `minimax-cn-oauth` | 中国 OAuth（Coding Plan） |
| `minimax-global-api` | 国际 API 密钥 |
| `minimax-cn-api` | 中国 API 密钥 |
| `minimax-global-api` | 国际 API key |
| `minimax-cn-api` | 中国 API key |
</Step>
<Step title="选择你的默认模型">
在提示时选择你的默认模型。
出现提示时选择你的默认模型。
</Step>
</Steps>
@ -218,13 +218,13 @@ MiniMax 还提供：
MiniMax 插件为 `image_generate` 工具注册了 `image-01` 模型。它支持：
- 带宽高比控制的**文本生成图像**
- 带宽高比控制的**图像到图像编辑**（主体参考）
- 每次请求最多 **9 张输出图像**
- 每次编辑请求最多 **1 张参考图像**
- 带宽高比控制的**文生图生成**
- 带宽高比控制的**图生图编辑**（主体参考）
- 每个请求最多生成 **9 张输出图像**
- 每个编辑请求最多使用 **1 张参考图像**
- 支持的宽高比：`1:1`、`16:9`、`4:3`、`3:2`、`2:3`、`3:4`、`9:16`、`21:9`
若要使用 MiniMax 进行图像生成，请将它设置为图像生成提供商：
要使用 MiniMax 进行图像生成，请将它设为图像生成提供商：
```json5
{
@ -236,52 +236,52 @@ MiniMax 插件为 `image_generate` 工具注册了 `image-01` 模型。它支持
}
```
该插件使用与文本模型相同的 `MINIMAX_API_KEY` 或 OAuth 认证。如果已经设置了 MiniMax，则不需要额外配置。
该插件使用与文本模型相同的 `MINIMAX_API_KEY` 或 OAuth 身份验证。如果已设置 MiniMax，则不需要额外配置。
`minimax` 和 `minimax-portal` 都使用相同的 `image-01` 模型注册 `image_generate`。API 密钥设置使用 `MINIMAX_API_KEY`；OAuth 设置则可以改用内置的 `minimax-portal` 认证路径。
`minimax` 和 `minimax-portal` 都会使用相同的 `image-01` 模型注册 `image_generate`。API-key 设置使用 `MINIMAX_API_KEY`；OAuth 设置则可以改用内置的 `minimax-portal` 身份验证路径。
图像生成始终使用 MiniMax 专用图像端点（`/v1/image_generation`），并忽略 `models.providers.minimax.baseUrl`，因为该字段配置的是聊天/Anthropic 兼容的基础 URL。设置 `MINIMAX_API_HOST=https://api.minimaxi.com` 可将图像生成路由到 CN 端点；默认的全球端点是 `https://api.minimax.io`。
图像生成始终使用 MiniMax 专用的图像端点（`/v1/image_generation`），并忽略 `models.providers.minimax.baseUrl`，因为该字段用于配置聊天/Anthropic 兼容的基础 URL。设置 `MINIMAX_API_HOST=https://api.minimaxi.com` 可将图像生成路由到 CN 端点；默认的全球端点是 `https://api.minimax.io`。
当新手引导或 API 密钥设置写入显式的 `models.providers.minimax` 条目时，OpenClaw 会将 `MiniMax-M2.7` 和 `MiniMax-M2.7-highspeed` 实体化为仅文本聊天模型。图像理解则通过插件拥有的 `MiniMax-VL-01` 媒体提供商单独暴露。
当新手引导或 API-key 设置写入显式的 `models.providers.minimax` 条目时，OpenClaw 会将 `MiniMax-M2.7` 和 `MiniMax-M2.7-highspeed` 物化为纯文本聊天模型。图像理解则通过插件拥有的 `MiniMax-VL-01` 媒体提供商单独暴露。
<Note>
参见[图像生成](/zh-CN/tools/image-generation)，了解共享工具参数、提供商选择和故障转移行为。
请参阅[图像生成](/zh-CN/tools/image-generation)，了解共享工具参数、提供商选择和故障转移行为。
</Note>
### 文本转语音
内置的 `minimax` 插件将 MiniMax T2A v2 注册为 `messages.tts` 的语音提供商。
内置的 `minimax` 插件会将 MiniMax T2A v2 注册为 `messages.tts` 的语音提供商。
- 默认 TTS 模型：`speech-2.8-hd`
- 默认语音：`English_expressive_narrator`
- 支持的内置模型 ID 包括 `speech-2.8-hd`、`speech-2.8-turbo`、`speech-2.6-hd`、`speech-2.6-turbo`、`speech-02-hd`、`speech-02-turbo`、`speech-01-hd` 和 `speech-01-turbo`。
- 认证解析顺序为 `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 主机，OpenClaw 会复用已配置的 `minimax-portal` OAuth 主机，并移除 Anthropic 兼容路径后缀，例如 `/anthropic`。
- 普通音频附件保持为 MP3。
- Feishu 和 Telegram 等语音消息目标会通过 `ffmpeg` 从 MiniMax MP3 转码为 48kHz Opus，因为 Feishu/Lark 文件 API 对原生音频消息只接受 `file_type: "opus"`。
- MiniMax T2A 接受小数形式的 `speed` 和 `vol`，但 `pitch` 会作为整数发送；OpenClaw 会在 API 请求前截断小数形式的 `pitch` 值。
- 身份验证解析顺序为 `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 主机，OpenClaw 会复用已配置的 `minimax-portal` OAuth 主机，并去除 Anthropic 兼容的路径后缀，例如 `/anthropic`。
- 普通音频附件保持 MP3。
- Feishu 和 Telegram 等语音消息目标会通过 `ffmpeg` 将 MiniMax MP3 转码为 48kHz Opus，因为 Feishu/Lark 文件 API 对原生音频消息只接受 `file_type: "opus"`。
- MiniMax T2A 接受小数形式的 `speed` 和 `vol`，但 `pitch` 会以整数发送；OpenClaw 会在 API 请求前截断小数形式的 `pitch` 值。
| 设置 | 环境变量 | 默认值 | 描述 |
| ---------------------------------------- | ---------------------- | ----------------------------- | ------------------------------ |
| `messages.tts.providers.minimax.baseUrl` | `MINIMAX_API_HOST` | `https://api.minimax.io` | MiniMax T2A API 主机。 |
| `messages.tts.providers.minimax.model` | `MINIMAX_TTS_MODEL` | `speech-2.8-hd` | TTS 模型 ID。 |
| `messages.tts.providers.minimax.voiceId` | `MINIMAX_TTS_VOICE_ID` | `English_expressive_narrator` | 用于语音输出的语音 ID。 |
| `messages.tts.providers.minimax.speed` | | `1.0` | 播放速度，`0.5..2.0`。 |
| `messages.tts.providers.minimax.vol` | | `1.0` | 音量，`(0, 10]`。 |
| `messages.tts.providers.minimax.pitch` | | `0` | 整数音高偏移，`-12..12`。 |
| 设置 | 环境变量 | 默认值 | 说明 |
| ---------------------------------------- | ---------------------- | ----------------------------- | -------------------------------- |
| `messages.tts.providers.minimax.baseUrl` | `MINIMAX_API_HOST` | `https://api.minimax.io` | MiniMax T2A API 主机。 |
| `messages.tts.providers.minimax.model` | `MINIMAX_TTS_MODEL` | `speech-2.8-hd` | TTS 模型 ID。 |
| `messages.tts.providers.minimax.voiceId` | `MINIMAX_TTS_VOICE_ID` | `English_expressive_narrator` | 用于语音输出的语音 ID。 |
| `messages.tts.providers.minimax.speed` | | `1.0` | 播放速度，`0.5..2.0`。 |
| `messages.tts.providers.minimax.vol` | | `1.0` | 音量，`(0, 10]`。 |
| `messages.tts.providers.minimax.pitch` | | `0` | 整数音高偏移，`-12..12`。 |
### 音乐生成
内置的 MiniMax 插件通过共享的 `music_generate` 工具为 `minimax` 和 `minimax-portal` 注册音乐生成。
内置 MiniMax 插件会通过共享的 `music_generate` 工具，为 `minimax` 和 `minimax-portal` 注册音乐生成。
- 默认音乐模型：`minimax/music-2.6`
- OAuth 音乐模型：`minimax-portal/music-2.6`
- 还支持 `minimax/music-2.5` 和 `minimax/music-2.0`
- 提示词控制：`lyrics`、`instrumental`、`durationSeconds`
- 也支持 `minimax/music-2.5` 和 `minimax/music-2.0`
- 提示控制项：`lyrics`、`instrumental`、`durationSeconds`
- 输出格式：`mp3`
- 基于会话的运行会通过共享的任务/Status 流程分离，包括 `action: "status"`
- 基于会话的运行会通过共享任务/Status 流程分离，包括 `action: "status"`
若要将 MiniMax 用作默认音乐提供商：
要将 MiniMax 用作默认音乐提供商：
```json5
{
@ -296,19 +296,19 @@ MiniMax 插件为 `image_generate` 工具注册了 `image-01` 模型。它支持
```
<Note>
参见[音乐生成](/zh-CN/tools/music-generation)，了解共享工具参数、提供商选择和故障转移行为。
请参阅[音乐生成](/zh-CN/tools/music-generation)，了解共享工具参数、提供商选择和故障转移行为。
</Note>
### 视频生成
内置的 MiniMax 插件通过共享的 `video_generate` 工具为 `minimax` 和 `minimax-portal` 注册视频生成。
内置 MiniMax 插件会通过共享的 `video_generate` 工具，为 `minimax` 和 `minimax-portal` 注册视频生成。
- 默认视频模型：`minimax/MiniMax-Hailuo-2.3`
- OAuth 视频模型：`minimax-portal/MiniMax-Hailuo-2.3`
- 模式：文本生成视频和单图像参考流程
- 模式：文生视频和单图参考流程
- 支持 `aspectRatio` 和 `resolution`
若要将 MiniMax 用作默认视频提供商：
要将 MiniMax 用作默认视频提供商：
```json5
{
@ -323,65 +323,65 @@ MiniMax 插件为 `image_generate` 工具注册了 `image-01` 模型。它支持
```
<Note>
请参阅[视频生成](/zh-CN/tools/video-generation)，了解共享工具参数、提供商选择和故障转移行为。
参见[视频生成](/zh-CN/tools/video-generation)，了解共享工具参数、提供商选择和故障转移行为。
</Note>
### 图像理解
MiniMax 插件会将图像理解与文本目录分开注册：
| 提供商 ID | 默认图像模型 |
| 提供商 ID | 默认图像模型 |
| ---------------- | ------------------- |
| `minimax` | `MiniMax-VL-01` |
| `minimax-portal` | `MiniMax-VL-01` |
这就是为什么即使内置文本提供商目录仍显示仅文本的 M2.7 聊天引用，自动媒体路由也可以使用 MiniMax 图像理解。
因此，即使内置文本提供商目录仍显示仅文本的 M2.7 聊天引用，自动媒体路由也可以使用 MiniMax 图像理解。
### Web 搜索
MiniMax 插件还会通过 MiniMax Token Plan 搜索 API 注册 `web_search`。
MiniMax 插件还通过 MiniMax Token Plan 搜索 API 注册 `web_search`。
- 提供商 id：`minimax`
- 结构化结果：标题、URL、摘要、相关查询
- 首选环境变量：`MINIMAX_CODE_PLAN_KEY`
- 接受的环境变量别名：`MINIMAX_CODING_API_KEY`、`MINIMAX_OAUTH_TOKEN`
- 可接受的环境别名：`MINIMAX_CODING_API_KEY`、`MINIMAX_OAUTH_TOKEN`
- 兼容性回退：当 `MINIMAX_API_KEY` 已指向 token-plan 凭证时使用它
- 区域复用：`plugins.entries.minimax.config.webSearch.region`，然后是 `MINIMAX_API_HOST`，再然后是 MiniMax 提供商基础 URL
- 搜索保留在提供商 id `minimax` 上；OAuth 中国/全球设置可以通过 `models.providers.minimax-portal.baseUrl` 间接控制区域，并可以通过 `MINIMAX_OAUTH_TOKEN` 提供 bearer 认证
- 搜索保持在提供商 id `minimax` 上；OAuth CN/全球设置可以通过 `models.providers.minimax-portal.baseUrl` 间接引导区域，并可通过 `MINIMAX_OAUTH_TOKEN` 提供 bearer 认证
配置位于 `plugins.entries.minimax.config.webSearch.*` 下。
<Note>
请参阅 [MiniMax 搜索](/zh-CN/tools/minimax-search)，了解完整的 Web 搜索配置和用法。
参见 [MiniMax Search](/zh-CN/tools/minimax-search)，了解完整的 Web 搜索配置和用法。
</Note>
## 高级配置
<AccordionGroup>
<Accordion title="配置选项">
| 选项 | 描述 |
| 选项 | 说明 |
| --- | --- |
| `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 兼容 payload |
| `models.providers.minimax.api` | 优先使用 `anthropic-messages`；`openai-completions` 可选，用于 OpenAI 兼容 payload |
| `models.providers.minimax.apiKey` | MiniMax API key（`MINIMAX_API_KEY`） |
| `models.providers.minimax.models` | 定义 `id`、`name`、`reasoning`、`contextWindow`、`maxTokens`、`cost` |
| `agents.defaults.models` | 为你想加入允许列表的模型设置别名 |
| `agents.defaults.models` | 为你希望加入允许列表的模型设置别名 |
| `models.mode` | 如果你想在内置项旁添加 MiniMax，请保持 `merge` |
</Accordion>
<Accordion title="Thinking 默认值">
在 `api: "anthropic-messages"` 上，除非 params/config 中已经显式设置了 thinking，否则 OpenClaw 会注入 `thinking: { type: "disabled" }`。
<Accordion title="思考默认值">
在 `api: "anthropic-messages"` 上，除非已在 params/config 中显式设置 thinking，否则 OpenClaw 会注入 `thinking: { type: "disabled" }`。
这会防止 MiniMax 的流式端点在 OpenAI 风格的 delta 分块中发出 `reasoning_content`，从而避免内部推理泄露到可见输出中。
</Accordion>
<Accordion title="快速模式">
`/fast on` 或 `params.fastMode: true` 会在兼容 Anthropic 的流式路径上将 `MiniMax-M2.7` 重写为 `MiniMax-M2.7-highspeed`。
`/fast on` 或 `params.fastMode: true` 会在 Anthropic 兼容流路径上将 `MiniMax-M2.7` 重写为 `MiniMax-M2.7-highspeed`。
</Accordion>
<Accordion title="回退示例">
**最适合：**将你最强的最新一代模型作为主模型，故障转移到 MiniMax M2.7。下面的示例使用 Opus 作为具体主模型；请替换为你偏好的最新一代主模型。
**最适合：**将你最强的最新一代模型保留为主模型，并故障转移到 MiniMax M2.7。下面示例使用 Opus 作为具体主模型；请替换为你偏好的最新一代主模型。
```json5
{
@ -403,16 +403,17 @@ MiniMax 插件还会通过 MiniMax Token Plan 搜索 API 注册 `web_search`。
</Accordion>
<Accordion title="Coding Plan 用法详情">
- Coding Plan 用量 API：`https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains`（需要 coding plan key）。
- OpenClaw 会将 MiniMax coding-plan 用量规范化为其他提供商使用的同一种 `% left` 显示。MiniMax 原始的 `usage_percent` / `usagePercent` 字段表示剩余额度，而不是已消耗额度，因此 OpenClaw 会将其反转。存在基于数量的字段时，以它们为准。
- 当 API 返回 `model_remains` 时，OpenClaw 优先选择聊天模型条目，在需要时从 `start_time` / `end_time` 推导窗口标签，并在套餐标签中包含所选模型名称，使 coding-plan 窗口更容易区分。
- 用量快照会将 `minimax`、`minimax-cn` 和 `minimax-portal` 视为同一个 MiniMax 额度表面，并优先使用已存储的 MiniMax OAuth，然后才回退到 Coding Plan key 环境变量。
<Accordion title="Coding Plan 使用详情">
- Coding Plan 用量 API：`https://api.minimaxi.com/v1/token_plan/remains` 或 `https://api.minimax.io/v1/token_plan/remains`（需要 coding plan key）。
- 配置后，用量轮询会从 `models.providers.minimax-portal.baseUrl` 或 `models.providers.minimax.baseUrl` 派生主机，因此使用 `https://api.minimax.io/anthropic` 的全球设置会轮询 `api.minimax.io`。缺失或格式错误的基础 URL 会保留 CN 回退以保持兼容性。
- OpenClaw 会将 MiniMax coding-plan 用量规范化为其他提供商使用的相同 `% left` 显示。MiniMax 的原始 `usage_percent` / `usagePercent` 字段表示剩余额度，而不是已消耗额度，因此 OpenClaw 会将它们反转。存在基于计数的字段时优先使用。
- 当 API 返回 `model_remains` 时，OpenClaw 会优先使用聊天模型条目，在需要时从 `start_time` / `end_time` 派生窗口标签，并在计划标签中包含选中的模型名称，以便更容易区分 coding-plan 窗口。
- 用量快照会将 `minimax`、`minimax-cn` 和 `minimax-portal` 视为同一个 MiniMax 额度表面，并优先使用已存储的 MiniMax OAuth，然后再回退到 Coding Plan key 环境变量。
</Accordion>
</AccordionGroup>
## 注意事项
## 说明
- 模型引用遵循认证路径：
- API-key 设置：`minimax/<model>`
@ -421,34 +422,34 @@ MiniMax 插件还会通过 MiniMax Token Plan 搜索 API 注册 `web_search`。
- 备用聊天模型：`MiniMax-M2.7-highspeed`
- 新手引导和直接 API-key 设置会为两个 M2.7 变体写入仅文本模型定义
- 图像理解使用插件拥有的 `MiniMax-VL-01` 媒体提供商
- 如果你需要精确成本跟踪，请更新 `models.json` 中的定价值
- 使用 `openclaw models list` 确认当前提供商 id，然后用 `openclaw models set minimax/MiniMax-M2.7` 或 `openclaw models set minimax-portal/MiniMax-M2.7` 切换
- 如果需要精确成本跟踪，请更新 `models.json` 中的价格值
- 使用 `openclaw models list` 确认当前提供商 id，然后使用 `openclaw models set minimax/MiniMax-M2.7` 或 `openclaw models set minimax-portal/MiniMax-M2.7` 切换
<Tip>
MiniMax Coding Plan 推荐链接（九折）：[MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link)
</Tip>
<Note>
请参阅[模型提供商](/zh-CN/concepts/model-providers)，了解提供商规则。
参见[模型提供商](/zh-CN/concepts/model-providers)，了解提供商规则。
</Note>
## 故障排除
<AccordionGroup>
<Accordion title='"未知模型：minimax/MiniMax-M2.7"'>
这通常意味着 **MiniMax 提供商未配置**（没有匹配的提供商条目，也没有找到 MiniMax 认证配置文件/环境变量键）。此检测的修复位于 **2026.1.12**。修复方式：
<Accordion title='"Unknown model: minimax/MiniMax-M2.7"'>
这通常表示 **MiniMax 提供商未配置**（没有匹配的提供商条目，也没有找到 MiniMax auth profile/env key）。此检测问题的修复包含在 **2026.1.12** 中。修复方式：
- 升级到 **2026.1.12**（或从源代码 `main` 运行），然后重启 Gateway 网关。
- 升级到 **2026.1.12**（或从源码 `main` 运行），然后重启 gateway。
- 运行 `openclaw configure` 并选择一个 **MiniMax** 认证选项，或
- 手动添加匹配的 `models.providers.minimax` 或 `models.providers.minimax-portal` 块，或
- 设置 `MINIMAX_API_KEY`、`MINIMAX_OAUTH_TOKEN` 或 MiniMax 认证配置文件，以便注入匹配的提供商。
- 设置 `MINIMAX_API_KEY`、`MINIMAX_OAUTH_TOKEN`，或 MiniMax auth profile，以便注入匹配的提供商。
请确保模型 id **区分大小写**：
- API-key 路径：`minimax/MiniMax-M2.7` 或 `minimax/MiniMax-M2.7-highspeed`
- OAuth 路径：`minimax-portal/MiniMax-M2.7` 或 `minimax-portal/MiniMax-M2.7-highspeed`
然后使用以下命令重新检查：
然后用以下命令重新检查：
```bash
openclaw models list
@ -461,7 +462,7 @@ MiniMax Coding Plan 推荐链接（九折）：[MiniMax Coding Plan](https://pla
更多帮助：[故障排除](/zh-CN/help/troubleshooting)和[常见问题](/zh-CN/help/faq)。
</Note>
## 相关
## 相关内容
<CardGroup cols={2}>
<Card title="模型选择" href="/zh-CN/concepts/model-providers" icon="layers">
@ -476,10 +477,10 @@ MiniMax Coding Plan 推荐链接（九折）：[MiniMax Coding Plan](https://pla
<Card title="视频生成" href="/zh-CN/tools/video-generation" icon="video">
共享视频工具参数和提供商选择。
</Card>
<Card title="MiniMax 搜索" href="/zh-CN/tools/minimax-search" icon="magnifying-glass">
<Card title="MiniMax Search" href="/zh-CN/tools/minimax-search" icon="magnifying-glass">
通过 MiniMax Token Plan 配置 Web 搜索。
</Card>
<Card title="故障排除" href="/zh-CN/help/troubleshooting" icon="wrench">
通用故障排除和常见问题。
常规故障排除和常见问题。
</Card>
</CardGroup>