MiniMax 是 OpenClaw 中捆绑的第一方插件，而不是自定义端点：执行一条命令 openclaw onboard --auth-choice minimax-global-api，即可为你写入完整的供应商配置块。该插件注册了两个能力不同的供应商 ID，以及 MiniMax 称不可互换的两种凭据；OpenClaw 自己针对 MiniMax-M3 的示例成本块采用了 MiniMax 两个价格档位中较高的一个——这是运行前最值得修正的数字。以下全部内容均为截至 2026 年 9 月 21 日的源文档审查；本文未执行安装、引导或调用。
先说明三个容易混淆的名称，因为搜索结果会将它们混在一起。德国消防保护公司Minimax（minimax.com）销售火灾探测和灭火系统，而不是令牌。minimax 算法是这家 AI 公司名称的来源，即博弈论规则。OpenClaw 本身在 2026 年 1 月更名两次——Anthropic 提出商标问题后，于 1 月 27 日从 Clawdbot 更名为 Moltbot，随后于 1 月 30 日从 Moltbot 更名为 OpenClaw，这一点见CNBC 的报道——因此以旧名称发布的页面不是当前文档。根据其代码仓库 README，该项目采用 MIT 许可证且没有付费层级。
MiniMax 的两个接口，其中只有一个是聊天模型
该插件注册了 minimax（API 密钥）和 minimax-portal（OAuth），两者的能力列表恰好相差一项。这一项差异，是本页最不应在后期才发现的内容。
| 供应商 ID | 身份验证 | OpenClaw 列出的能力 |
|---|---|---|
minimax | API 密钥 | 文本、图像生成、音乐生成、视频生成、图像理解、语音、网页搜索 |
minimax-portal | OAuth | 文本、图像生成、音乐生成、视频生成、图像理解、语音 |
内容来自OpenClaw 的 MiniMax 供应商页面，读取日期为 2026 年 9 月 21 日。该页面没有说明 OAuth 路线确实无法搜索，还是能力表仅未完整列出。
还有两个边界决定插件的工具部分是否能够正常工作。OpenClaw 的MiniMax 网页搜索工具会向订阅端点 /v1/coding_plan/search 发起 POST 请求，优先使用 MINIMAX_CODE_PLAN_KEY，并警告普通模型 API 密钥可能不被接受——因此按量付费用户不能因为聊天可用就假定搜索也可用。图像生成始终从 MINIMAX_API_HOST 调用 MiniMax 专用的 /v1/image_generation 端点，完全忽略 models.providers.minimax.baseUrl。将聊天基础 URL 指向其他位置，不会随之改变图像流量的去向。
在修改配置前，先选择账户和密钥
MiniMax 销售两种凭据。按量付费 API 密钥按令牌计量。订阅密钥提供 Token Plan 或 Credits 访问权限，并驱动 OAuth 路线；MiniMax 自己的OpenClaw 设置指南称 Token Plan API 密钥以 sk-cp 开头，并要求将其设置为 MINIMAX_API_KEY——因此订阅凭据并不局限于 OAuth 路线。MiniMax 的Token Plan 概览明确说明：“订阅密钥不能与按量付费 API 密钥互换。”区域是第二个区分：国际平台使用 platform.minimax.io 配对 api.minimax.io，中国使用 platform.minimax.cn 配对 api.minimaxi.com；MiniMax 称 OAuth 登录后立即收到 401 通常意味着区域未自动匹配。
| Token Plan 档位 | 公布的月度价格 | MiniMax 的描述 |
|---|---|---|
| Plus | $22 / 月 | 个人项目和原型开发，3–4 个代理 |
| Max | $55 / 月 | 日常代理编码和多模态工作，4–5 个代理 |
| Ultra | $132 / 月 | 高强度 Agent 工作流和延长会话，6–7 个代理 |
内容来自 MiniMax 的Token Plan 定价页面，读取日期为 2026 年 9 月 21 日。三个档位都共享 5 小时滚动窗口和每周配额窗口，MiniMax 没有公布各档位对应的令牌数或请求数——任何将档位换算为每月令牌数的句子都是凭空捏造。该页面没有出现年度价格，也没有出现“免费两个月”的表述。实时结账页面由客户端渲染，本文无法读取，因此应以结账页面为准，并在订阅前确认。覆盖范围描述为“完整的 MiniMax 产品线（M3 / M2.7 / image / speech）”，同时列出排除项——“MiniMax H3、声音设计、快速声音克隆等目前不受支持”——这很重要，因为插件可以调用不属于任一列表的视频和语音功能。Credits 的售价为 1,000 credits = $1，自每次购买日起有效 365 天；MiniMax 的Token Plan 概览还补充说明，购买的 Credits 可以自动用于覆盖 Token Plan 范围内的使用量，并且“未使用的订阅配额不会结转到下一个计费周期”。另有一项披露：OpenClaw 文档包含一个宣传订阅 9 折的推荐链接。这是推荐折扣，不是 MiniMax 的目录价。
# International, pay-as-you-go API key -> provider id "minimax"
openclaw onboard --auth-choice minimax-global-api
# International, Token Plan over OAuth -> provider id "minimax-portal"
openclaw onboard --auth-choice minimax-global-oauth
# China endpoints (api.minimaxi.com)
openclaw onboard --auth-choice minimax-cn-api
openclaw onboard --auth-choice minimax-cn-oauth
# Then confirm the catalog actually loaded
openclaw models list --provider minimax
openclaw models list --provider minimax-portal配置中值得修正的那个数字
全球 API 密钥选项会将 baseUrl 写为 https://api.minimax.io/anthropic，并设置 api: "anthropic-messages"（中国选项使用 api.minimaxi.com）；还会提供带有 openai-completions 的 https://api.minimax.io/v1 作为可选项。它们还会写入成本块，而 OpenClaw 针对 MiniMax-M3 的文档示例为 { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 }。这些是输入令牌超过 512k 时 MiniMax 的费率。
| MiniMax-M3，每 1M 个令牌 | 输入 | 输出 | 提示缓存读取 |
|---|---|---|---|
| MiniMax 价目表，512k 及以下输入令牌 | $0.30 | $1.20 | $0.06 |
| MiniMax 价目表，超过 512k 输入令牌 | $0.60 | $2.40 | $0.12 |
| OpenClaw 示例成本块 | 0.6 | 2.4 | 0.12 |
MiniMax 的按量付费价目表和 OpenClaw 的供应商页面，均读取于 2026 年 9 月 21 日。档位边界以输入令牌长度为准，而不是总上下文长度；较低档位标注为“永久 50% 折扣”。如果保留示例原样，OpenClaw 会对边界以内的每个请求报告约为实际费率两倍的成本——这与其说是缺陷，不如说是示例恰好选择了一个档位；OpenClaw 也明确告诉你如何修正：“如果需要精确跟踪成本，请更新 models.json 中的价格值。”
{
"input": 0.30,
"output": 1.20,
"cacheRead": 0.06
}注意缺失的内容。MiniMax 未公布 M3 的提示词缓存 写入费率，因此本段省略 cacheWrite，而不是断言其为零。这些数值是 MiniMax 公布的费率，填入 OpenClaw 文档所使用的字段名；这里未运行这一组合。还需注意 anthropic-messages 路径上的一个行为门槛：OpenClaw 默认禁用 M2.x 的思考功能，因为 M2.x 会在 OpenAI 风格的增量块中输出 reasoning_content，从而泄漏到可见输出中；而 M3 默认采用自适应思考——其文档记录的两个级别是 off 和 adaptive——因为禁用思考时它会返回空内容。
任务的成本，以及定时任务的成本
这些是基于公布费率的算术结果，不是实测任务成本，也不是账单上限。假设一个任务计费为 1,000,000 个输入 token 和 100,000 个输出 token。
| MiniMax 模型，每 1M 个 token | 输入 | 输出 | 缓存读取 | 缓存写入 |
|---|---|---|---|---|
| MiniMax-M3（输入不超过 512k） | $0.30 | $1.20 | $0.06 | 未公布 |
| MiniMax-M3（输入超过 512k） | $0.60 | $2.40 | $0.12 | 未公布 |
| MiniMax-M2.7 | $0.3 | $1.2 | $0.06 | $0.375 |
| MiniMax-M2.7-highspeed | $0.6 | $2.4 | $0.06 | $0.375 |
MiniMax 按量付费价目表，美元，读取于 2026 年 9 月 21 日。对于 MiniMax-M2.7，前述假定任务在未缓存时的成本为 $0.42（$0.30 + $0.12）。如果 90% 的输入来自提示词缓存，同样的任务形态成本为 $0.204（$0.03 + $0.054 + $0.12）。因此，$22 的 Plus 套餐金额按标价计算约相当于 52 个未缓存任务或 107 个缓存良好的同类任务——这是费率比较，并不表示该套餐能提供这么多任务，因为它按 5 小时和每周窗口计量，而 MiniMax 未公布其中的令牌数量。该表还有两个注意事项：M2.7-highspeed 列出的输入和输出费率是 M2.7 的两倍，但缓存读取仍为 $0.06；此信息只读取了一次，未交叉核对；此外，缓存机制——TTL、可缓存前缀的最小长度，以及是否会自动缓存——在该处均未公布，因此缓存数据只是费率算术，不是预测（提示词缓存介绍了这一概念）。MiniMax 还列出了 M3 的优先级层级，费率为标准费率的 1.5 倍（输入不超过 512k 时为 $0.45 / $1.80 / $0.09）。MiniMax 的价格表或 OpenClaw 的提供商页面都未记录 OpenClaw 如何选择该层级——OpenClaw 关于删除 service_tier 的说明针对的是 openai-completions 代理路由，而不是 MiniMax 插件偏好的 anthropic-messages 路径，因此这里应将优先级层级视为未经测试，而不是不可访问。
持续运行的任务是 OpenClaw 与编码 CLI 的区别所在，也是大多数预算会漏掉的一项。每 15 分钟唤醒一次的任务每天运行 96 次，每月约运行 2,880 次。如果每次运行都重新读取 40,000 个 token 的上下文，那么每月就是 115.2M 个输入 token：按 MiniMax-M2.7 未缓存时每百万个 token $0.30 计算，为 $34.56；如果每次读取都命中提示词缓存，按每百万个 token $0.06 计算则为 $6.91。这里没有运行此类任务，也未测试缓存是否能在 15 分钟间隔后保留——重点是两列之间的数量级差异，因为这决定了定时助手的成本只是四舍五入误差，还是占据整张账单。
| 插件可以调用的非文本能力 | MiniMax 按量付费费率 | 值得了解 |
|---|---|---|
| web_search | $0.01 / 请求 | 尚未确认这是 OpenClaw /v1/coding_plan/search 调用的费率 |
| image-01（OpenClaw 的 image_generate） | $0.0035 / 图像 | 始终通过专用图像端点计费 |
| speech-2.8-hd / speech-2.8-turbo | 每 1M 个字符 $100 / $60 | OpenClaw 默认使用两者中更昂贵的一个 |
| 转录 | $0.38 / 小时 | 按音频小时计费，而不是按 token 计费 |
| 声音设计 / 快速声音克隆 | 每个声音 $3 / $1.5 | 列在 MiniMax 的 Token Plan 排除项列表中 |
| 视频，MiniMax H3 | 768P 下每秒 $0.08，2K 下每秒 $0.13 | H3 不在 Token Plan 覆盖范围内；OpenClaw 的默认视频模型是 MiniMax-Hailuo-2.3，该页面改为按片段定价——768P 6 秒视频 $0.28，768P 10 秒视频 $0.56 |
Kunavo 不提供文本转语音、语音转文本或嵌入模型，因此这些 MiniMax 能力都没有可供比较的 Kunavo 对应项。
Kunavo 的目录中也没有 MiniMax 文本模型，其 MiniMax 视频条目处于保留状态而非启用状态——Hailuo API 指南解释了原因。因此，本页面无法通过 Kunavo 访问 MiniMax-M3 或 MiniMax-M2.7。
第一个任务，以及值得识别的错误
在进行任何付费操作前，先运行 openclaw models list --provider minimax（或 --provider minimax-portal）：这只能证明目录已加载，不能证明任务可以运行。然后交给它一个边界明确的任务，并查看你的 MiniMax 账户为该任务记录的费用。
| 症状 | 最可能的原因 | 来源 |
|---|---|---|
| OAuth 登录后立即出现 401 | 区域未自动匹配——全球版和中国版是两个独立服务，使用不同的密钥 | MiniMax 自己的 OpenClaw 指南 |
| “未知模型” | 通常是没有 MiniMax 提供商条目，也没有 MiniMax 身份验证配置文件或环境密钥；否则就是 ID 大小写错误——文本模型 ID 是 MiniMax-M3、MiniMax-M2.7、MiniMax-M2.7-highspeed | OpenClaw 的故障排查部分 |
| 搜索失败，但聊天正常 | 搜索需要 Token Plan 凭据；模型 API 密钥可能会被拒绝 | OpenClaw 的 MiniMax 搜索工具页面 |
| 任务进行到一半时配额窗口为空 | 申请 Credits、升级、等待窗口恢复，或更换密钥：“你可以将订阅密钥替换为按量付费 API 密钥” | MiniMax 的 Token Plan 介绍 |
| 报告的支出看起来不对 | 上面的 M3 成本区块层级，或一个未配置成本区块且默认所有值为零的自定义提供商 | OpenClaw 的提供商和自定义提供商页面 |
对于配额读取本身，OpenClaw 会轮询 https://api.minimax.io/v1/token_plan/remains 并反转 MiniMax 的 usage_percent 字段，因为 MiniMax 报告的是剩余配额，而不是已消耗配额。在 OpenClaw 之外，MiniMax 记录了自己的 CLI：npm install -g mmx-cli，然后运行 mmx quota。有一个值得保留的版本注意事项：MiniMax 供应商侧指南针对 OpenClaw v2026.7.1-2，而 GitHub 标记为 Latest 的版本是 v2026.9.5，发布于 2026 年 9 月 19 日（gh release list -R openclaw/openclaw，2026 年 9 月 21 日）。该仓库在并行版本线上创建标签——v2026.7.35 的标签时间戳晚于 v2026.9.5——因此“最新标签”和“最新发布版本”并不是同一个问题。如果两份文档存在差异，OpenClaw 文档是配置结构的较新来源，而 MiniMax 页面是所需凭据的权威来源。
直接使用、订阅，还是第二个提供商
| 方式 | 适用场景 | 你放弃的内容 |
|---|---|---|
通过 OAuth 使用 Token Plan（minimax-portal） | 你希望每月只有一个固定金额，并且你的流量具有足够的交互性和突发性，可以适应 5 小时和每周窗口 | 窗口在任务中途耗尽时仍能保持可预测性；MiniMax 自己建议的补救方式是换用按量付费密钥。该提供商的能力列表中不包含网页搜索 |
按量付费密钥（minimax） | 无人值守或定时任务，以及任何希望有公布的 token 费率可供核对的人 | 成本可预测性。MiniMax 的速率限制页面在其 LLM 表中将 M3 列为 200 RPM 和 10M TPM，将 M2.7 列为 500 RPM 和 20M TPM，并表示限制取决于模型和接口，但未说明订阅密钥是否拥有相同限制 |
| 通过网关使用 MiniMax 模型 | 很少仅凭自身优势选择 | MiniMax 已经直接提供网关所需的相同 anthropic-messages 协议，因此网关不会为 MiniMax 模型本身增加协议兼容性 |
| 与 MiniMax 并列的第二个提供商条目 | 你希望使用 Claude 级或 GPT 级模型作为主模型，并将 MiniMax 放入回退列表——这正是 OpenClaw 自己文档化的回退示例结构 | 需要监控的第二个密钥和第二笔余额 |
OpenClaw 的自定义提供商文档为最后一行设定了边界，并且每一项都有自己的适用范围。只有 openai-completions 和 anthropic-messages 被记录为 api 类型。模型的 cost 区块在省略时默认为 { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }，因此未配置的自定义提供商会报告 $0 支出——该规则没有附加限定。两个兼容性规则则不是如此：在针对非原生主机的 openai-completions 上，OpenClaw 会强制使用 supportsDeveloperRole: false，代理式路由会删除 service_tier；在针对任何非规范 Anthropic 端点的 anthropic-messages 上，它会抑制隐式 Anthropic beta 标头。两组规则都不会同时适用于两种协议。页面中的示例都展示了一个已经带有自身路径后缀的 baseUrl，但没有说明 OpenClaw 是否会追加后缀——因此请包含该后缀并进行验证，不要假设。
对于与上文相同的假设形态——1,000,000 个未缓存输入 token 和 100,000 个输出 token——以下是按实时 目录费率计算的 Kunavo 侧主模型成本，因此回退组合的两侧可以用同一单位进行比较。
| 模型 | 每 1M 个令牌的输入 / 输出 | 假设任务的估算成本 |
|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $1.05 |
| Claude Sonnet 4.6 | $2.10 / $10.50 | $3.15 |
| Claude Opus 5 | $3.50 / $17.50 | $5.25 |
这是示意性的 token 算术，不是实测的 OpenClaw 任务，也不是账单上限：不包括缓存操作、工具调用以及运行助手的机器成本。Kunavo 的目录金额是计费下限，而不是上限——上游报告费用后，账单取目录成本与上游成本乘以适用加价两者中的较高者。最低充值金额为预付余额 $10，这是资金充值最低额，而不是任务费用或订阅费；请参阅 账单详情。Kunavo 提供商条目的 OpenClaw 侧配置记录在OpenClaw 提供商比较中；这是已记录的配置参考，而非运行时测试，并且其自定义提供商文档没有说明 OpenClaw 是否会向基础 URL 追加内容，因此请在自己的安装中确认后再信任它。需要为第二个条目充值时，请创建 Kunavo 账户；本页面未涵盖的托管和工具层费用见 OpenClaw 定价。
常见问题
如何在 OpenClaw 中使用 MiniMax？
MiniMax 作为 OpenClaw 中捆绑的第一方插件提供，因此不属于自定义端点配置。OpenClaw 的供应商文档给出一条命令和四种身份验证选项：openclaw onboard --auth-choice minimax-global-api、minimax-global-oauth、minimax-cn-api 或 minimax-cn-oauth。API 密钥选项会写入一个供应商配置块，其中 baseUrl 为 https://api.minimax.io/anthropic，api 为 "anthropic-messages"；中国选项使用 api.minimaxi.com。可使用 openclaw models list --provider minimax 验证，OAuth 路线则使用 --provider minimax-portal。内容读取自 OpenClaw 文档，日期为 2026 年 9 月 21 日；本页未执行安装或引导流程。
在 OpenClaw 中，我需要 MiniMax Coding Plan 还是 Token Plan？
这两个名称目前都在使用，但指向同一个产品。MiniMax 的 Token Plan 概览称 Token Plan“是在我们原有 Coding Plan 基础上的扩展”，因此 Token Plan 是当前名称——但 OpenClaw 的环境变量仍是 MINIMAX_CODE_PLAN_KEY，其 MiniMax 网页搜索工具调用 /v1/coding_plan/search，而 OpenClaw 文档中的推荐链接仍指向 /subscribe/coding-plan。OAuth 供应商（minimax-portal）使用订阅密钥，OpenClaw 的网页搜索工具也会优先使用该凭据；MiniMax 自己的 OpenClaw 指南还要求将 sk-cp Token Plan 密钥设置为 MINIMAX_API_KEY，因此它并不专属于 OAuth 路线。按量付费的聊天模型使用普通 API 密钥。MiniMax 的 Token Plan 概览说明订阅密钥不能与按量付费 API 密钥互换，其 OpenClaw 指南称 Token Plan API 密钥以 sk-cp 开头。核查日期为 2026 年 9 月 21 日。
为什么 OpenClaw 报出的费用大约是 MiniMax 收费的两倍？
这是由于价格档位，而不是错误。OpenClaw 文档中的 MiniMax-M3 示例成本块写的是 input 0.6、output 2.4、cacheRead 0.12，这些是 MiniMax 对超过 512k 输入令牌的费率。MiniMax 的按量付费价目表对 512k 及以下输入令牌的 M3 定价为每百万令牌输入 $0.30、输出 $1.20、提示缓存读取 $0.06。原样复制该示例后，每个普通请求都会按其费率的大约两倍报告。OpenClaw 自己也说明了这一点：如果需要精确跟踪成本，请更新 models.json 中的价格值。两页内容的读取日期均为 2026 年 9 月 21 日。
OpenClaw 的 MiniMax 网页搜索可以使用按量付费密钥吗？
不能可靠地这样认为，原因有两个。OpenClaw 的 MiniMax 网页搜索工具调用订阅搜索端点 /v1/coding_plan/search，优先使用 MINIMAX_CODE_PLAN_KEY，并警告普通 MiniMax 模型 API 密钥可能不被接受。OpenClaw 自己的能力表在 minimax 供应商 ID 下列出网页搜索，却没有在 OAuth 供应商 minimax-portal 下列出；不过搜索工具页面本身接受 MINIMAX_OAUTH_TOKEN 作为凭据，并称即使通过 OAuth 完成身份验证，该工具也会注册在 minimax 供应商 ID 下。两页都没有明确说明 OAuth 路线是否可以搜索。MiniMax 的按量付费价目表将 web_search 定价为每次请求 $0.01，但没有官方表述将该费率与 coding_plan 搜索端点关联起来。核查日期为 2026 年 9 月 21 日。
OpenClaw 接受哪些 MiniMax 模型 ID？
OpenClaw 捆绑的 MiniMax 目录中，区分大小写的 ID 包括 MiniMax-M3（默认托管推理模型）、MiniMax-M2.7、MiniMax-M2.7-highspeed、用于视觉的 MiniMax-VL-01、image-01、music-2.6 和 MiniMax-Hailuo-2.3。模型引用遵循身份验证路径：API 密钥配置使用 minimax/<model>，OAuth 配置使用 minimax-portal/<model>。第三方文章中写作“Minimax 2.7”“MiniMax 2.1”或“M2.5”的名称均与这些 ID 不匹配。OpenClaw 的故障排查部分称，“Unknown model”错误通常意味着 MiniMax 供应商根本没有配置，并另行指出模型 ID 区分大小写，且两条身份验证路径的 ID 不同。内容读取自 OpenClaw 文档，日期为 2026 年 9 月 21 日。
我可以在 OpenClaw 中同时运行 Claude 或 GPT 模型和 MiniMax 吗？
可以，这正是第二个供应商条目值得存在的情况。MiniMax 已经在供应商网关会使用的同一 anthropic-messages 协议上提供兼容 Anthropic 的接口，因此将 MiniMax 模型本身通过网关路由，并不会增加你原本没有的协议兼容性。只有当你希望以 Claude 类或 GPT 类模型作为主模型，并将 MiniMax 放入回退列表时，第二个条目才有意义；这正是 OpenClaw 自己文档中的回退示例所采用的形态。Kunavo 不销售 MiniMax 文本模型，因此第二个条目不是通往 MiniMax-M3 或 MiniMax-M2.7 的路线。
上面链接的每个来源均于 2026 年 9 月 21 日获取：MiniMax 的按量付费价目表、Token Plan 定价页面、Token Plan 概览、速率限制页面及其自己的 OpenClaw 设置指南；OpenClaw 的 MiniMax 提供商、MiniMax 搜索工具和自定义提供商文档；以及 openclaw/openclaw 发布列表，使用 gh release list 读取。两次发生在 2026 年 1 月的更名日期来自上面链接的 CNBC 报道，并与同期关于这两次更名的报道进行了交叉核对。本页面没有进行运行时测试：没有安装 OpenClaw，没有运行引导流程，没有签发 MiniMax 密钥，也没有发送请求。Kunavo token 费率来自实时目录，本页面的每个美元数值都是基于公布费率的算术结果。