9.7 MiniMax

MiniMax 模型配置指南

概述

OpenClaw 支持通过 OAuth(编程计划)或 API 密钥方式使用 MiniMax 的 M2.1 系列模型。MiniMax 提供 Anthropic 兼容和 OpenAI 兼容两种 API 端点。

认证方式

1. OAuth 认证(编程计划)

使用 MiniMax 编程计划订阅,无需 API 密钥,通过 OAuth 流程认证。

# 启用 MiniMax Portal 认证插件
openclaw plugins enable minimax-portal-auth

# 配置认证
openclaw configure

2. API 密钥认证

使用 MINIMAX_API_KEY 环境变量进行认证:

export MINIMAX_API_KEY=your-api-key-here

快速开始

使用编程计划(OAuth)

# 启用认证插件
openclaw plugins enable minimax-portal-auth

# 通过交互式配置进行认证
openclaw configure
# 选择: Model/auth → MiniMax M2.1

# 设置为默认模型
openclaw models set minimax/MiniMax-M2.1

使用 API 密钥

# 设置环境变量
export MINIMAX_API_KEY=your-api-key-here

# 设置为默认模型
openclaw models set minimax/MiniMax-M2.1

可用模型

MiniMax 提供以下模型(注意:模型名称区分大小写):

• minimax/MiniMax-M2.1 - MiniMax M2.1 标准版
• minimax/MiniMax-M2.1-lightning - MiniMax M2.1 闪电版

API 端点

MiniMax 提供多个 API 端点选择:

Anthropic 兼容端点(推荐)

https://api.minimax.io/anthropic

OpenAI 兼容端点(可选)

https://api.minimax.io/v1

编程计划端点

• 中国区: https://api.minimaxi.com
• 全球区: https://api.minimax.io

配置示例

完整配置(自定义提供商)

{
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "apiKey": "${MINIMAX_API_KEY}",
        "api": "anthropic",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "MiniMax-M2.1-lightning",
            "name": "MiniMax M2.1 Lightning",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

常用命令

# 列出可用的 MiniMax 模型
openclaw models list --provider minimax

# 设置默认模型
openclaw models set minimax/MiniMax-M2.1

# 交互式配置
openclaw configure

模型引用格式

MiniMax 模型使用以下格式引用(注意大小写):

minimax/MiniMax-M2.1
minimax/MiniMax-M2.1-lightning

Lightning 版本说明

MiniMax-M2.1-lightning 支持自动路由,但在流量高峰期可能会回退到标准版本。

故障排查

错误: Unknown model: minimax/MiniMax-M2.1

这通常表示 MiniMax 提供商未正确配置。请检查:

1. 是否已设置 MINIMAX_API_KEY 环境变量
2. 是否已在配置文件中添加 MiniMax 提供商配置
3. 模型名称是否使用了正确的大小写