diff --git a/docs/zh-CN/concepts/usage-tracking.md b/docs/zh-CN/concepts/usage-tracking.md index 11b1fa129..fe6408114 100644 --- a/docs/zh-CN/concepts/usage-tracking.md +++ b/docs/zh-CN/concepts/usage-tracking.md @@ -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) diff --git a/docs/zh-CN/providers/minimax.md b/docs/zh-CN/providers/minimax.md index f9cd38cdf..6d684a956 100644 --- a/docs/zh-CN/providers/minimax.md +++ b/docs/zh-CN/providers/minimax.md @@ -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` | 视频生成 | 文生视频和图像参考流程 | ## 入门指南 -选择你偏好的身份验证方式，并按照设置步骤操作。 +选择你偏好的凭证方式并按照设置步骤操作。 - - **最适合：**通过 OAuth 快速设置 MiniMax Coding Plan，无需 API 密钥。 + + **最适合：** 通过 OAuth 快速设置 MiniMax Coding Plan，无需 API key。 - + - + ```bash openclaw onboard --auth-choice minimax-global-oauth ``` 这会针对 `api.minimax.io` 进行身份验证。 - + ```bash openclaw models list --provider minimax-portal ``` - + - + ```bash openclaw onboard --auth-choice minimax-cn-oauth ``` 这会针对 `api.minimaxi.com` 进行身份验证。 - + ```bash openclaw models list --provider minimax-portal ``` @@ -86,7 +86,7 @@ MiniMax 还提供： - OAuth 设置使用 `minimax-portal` 提供商 ID。模型引用遵循 `minimax-portal/MiniMax-M2.7` 形式。 + OAuth 设置使用 `minimax-portal` 提供商 ID。模型引用遵循 `minimax-portal/MiniMax-M2.7` 格式。 @@ -95,36 +95,36 @@ MiniMax 还提供： - - **最适合：**使用与 Anthropic 兼容的 API 托管 MiniMax。 + + **最适合：** 使用 Anthropic 兼容 API 的托管 MiniMax。 - + - + ```bash openclaw onboard --auth-choice minimax-global-api ``` 这会将 `api.minimax.io` 配置为基础 URL。 - + ```bash openclaw models list --provider minimax ``` - + - + ```bash openclaw onboard --auth-choice minimax-cn-api ``` 这会将 `api.minimaxi.com` 配置为基础 URL。 - + ```bash openclaw models list --provider minimax ``` @@ -173,11 +173,11 @@ MiniMax 还提供： ``` - 在与 Anthropic 兼容的流式传输路径上，除非你显式设置 `thinking`，否则 OpenClaw 默认会禁用 MiniMax thinking。MiniMax 的流式端点会以 OpenAI 风格的 delta 块发出 `reasoning_content`，而不是原生 Anthropic thinking 块；如果隐式保持启用，内部推理可能会泄露到可见输出中。 + 在 Anthropic 兼容的流式传输路径上，除非你显式设置 `thinking`，否则 OpenClaw 默认会禁用 MiniMax thinking。MiniMax 的流式传输端点会以 OpenAI 风格的增量块发出 `reasoning_content`，而不是原生 Anthropic thinking blocks；如果隐式保持启用，可能会把内部推理泄露到可见输出中。 - API 密钥设置使用 `minimax` 提供商 ID。模型引用遵循 `minimax/MiniMax-M2.7` 形式。 + API key 设置使用 `minimax` 提供商 ID。模型引用遵循 `minimax/MiniMax-M2.7` 格式。 @@ -185,7 +185,7 @@ MiniMax 还提供： ## 通过 `openclaw configure` 配置 -使用交互式配置向导设置 MiniMax，无需编辑 JSON： +使用交互式配置向导来设置 MiniMax，无需编辑 JSON： @@ -193,22 +193,22 @@ MiniMax 还提供： openclaw configure ``` - - 从菜单中选择 **模型/认证**。 + + 从菜单中选择 **模型/身份验证**。 - + 选择一个可用的 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 | - 在提示时选择你的默认模型。 + 出现提示时选择你的默认模型。 @@ -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` 媒体提供商单独暴露。 -参见[图像生成](/zh-CN/tools/image-generation)，了解共享工具参数、提供商选择和故障转移行为。 +请参阅[图像生成](/zh-CN/tools/image-generation)，了解共享工具参数、提供商选择和故障转移行为。 ### 文本转语音 -内置的 `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` 模型。它支持 ``` -参见[音乐生成](/zh-CN/tools/music-generation)，了解共享工具参数、提供商选择和故障转移行为。 +请参阅[音乐生成](/zh-CN/tools/music-generation)，了解共享工具参数、提供商选择和故障转移行为。 ### 视频生成 -内置的 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` 模型。它支持 ``` -请参阅[视频生成](/zh-CN/tools/video-generation)，了解共享工具参数、提供商选择和故障转移行为。 +参见[视频生成](/zh-CN/tools/video-generation)，了解共享工具参数、提供商选择和故障转移行为。 ### 图像理解 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.*` 下。 -请参阅 [MiniMax 搜索](/zh-CN/tools/minimax-search)，了解完整的 Web 搜索配置和用法。 +参见 [MiniMax Search](/zh-CN/tools/minimax-search)，了解完整的 Web 搜索配置和用法。 ## 高级配置 - | 选项 | 描述 | + | 选项 | 说明 | | --- | --- | - | `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` | - - 在 `api: "anthropic-messages"` 上，除非 params/config 中已经显式设置了 thinking，否则 OpenClaw 会注入 `thinking: { type: "disabled" }`。 + + 在 `api: "anthropic-messages"` 上，除非已在 params/config 中显式设置 thinking，否则 OpenClaw 会注入 `thinking: { type: "disabled" }`。 这会防止 MiniMax 的流式端点在 OpenAI 风格的 delta 分块中发出 `reasoning_content`，从而避免内部推理泄露到可见输出中。 - `/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`。 - **最适合：**将你最强的最新一代模型作为主模型，故障转移到 MiniMax M2.7。下面的示例使用 Opus 作为具体主模型；请替换为你偏好的最新一代主模型。 + **最适合：**将你最强的最新一代模型保留为主模型，并故障转移到 MiniMax M2.7。下面示例使用 Opus 作为具体主模型；请替换为你偏好的最新一代主模型。 ```json5 { @@ -403,16 +403,17 @@ MiniMax 插件还会通过 MiniMax Token Plan 搜索 API 注册 `web_search`。 - - - 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 环境变量。 + + - 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 环境变量。 -## 注意事项 +## 说明 - 模型引用遵循认证路径： - API-key 设置：`minimax/` @@ -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` 切换 MiniMax Coding Plan 推荐链接（九折）：[MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) -请参阅[模型提供商](/zh-CN/concepts/model-providers)，了解提供商规则。 +参见[模型提供商](/zh-CN/concepts/model-providers)，了解提供商规则。 ## 故障排除 - - 这通常意味着 **MiniMax 提供商未配置**（没有匹配的提供商条目，也没有找到 MiniMax 认证配置文件/环境变量键）。此检测的修复位于 **2026.1.12**。修复方式： + + 这通常表示 **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)。 -## 相关 +## 相关内容 @@ -476,10 +477,10 @@ MiniMax Coding Plan 推荐链接（九折）：[MiniMax Coding Plan](https://pla 共享视频工具参数和提供商选择。 - + 通过 MiniMax Token Plan 配置 Web 搜索。 - 通用故障排除和常见问题。 + 常规故障排除和常见问题。