OpenClaw 接入 MiniMax 模型教程

2026-02-08 · 6 分钟模型接入

概述

MiniMax 是国内领先的 AI 模型提供商，其 M2.1 模型提供 200K 上下文窗口和兼容 Anthropic API 格式的接口。OpenClaw 对 MiniMax 提供了完善的支持，包括多种认证方式和国内专用端点。

模型信息

项目	详情
模型	M2.1
上下文窗口	200K token
API 格式	Anthropic Messages API 兼容
国际端点	`api.minimax.io/anthropic`
国内端点	`api.minimaxi.com`

两种认证方式

方式一：OAuth 认证

MiniMax 支持 OAuth 授权流程，适合个人用户快速接入：

openclaw onboard --provider minimax

系统会引导你在浏览器中完成 MiniMax 账户的 OAuth 授权。授权成功后，OpenClaw 自动管理令牌刷新。

方式二：API Key 认证

对于需要稳定长期使用的场景，推荐使用 API Key：

export MINIMAX_API_KEY="eyJhbGciOixxxxxxxx"
openclaw onboard --provider minimax --auth-choice api-key

配置文件示例

基础配置

{
  providers: {
    minimax: {
      type: "minimax",
      apiKey: "${MINIMAX_API_KEY}",
      baseUrl: "https://api.minimax.io/anthropic"
    }
  },
  agents: {
    default: {
      model: "minimax/m2.1"
    }
  }
}

国内端点配置

大陆用户推荐使用国内端点以获得更低延迟：

{
  providers: {
    minimax: {
      type: "minimax",
      apiKey: "${MINIMAX_API_KEY}",
      baseUrl: "https://api.minimaxi.com"
    }
  }
}

注意：国内端点域名是 minimaxi.com（多一个 i），不要与国际端点 minimax.io 混淆。

使用 Portal Auth 插件

MiniMax 提供了专用的认证插件 minimax-portal-auth，可以简化 OAuth 流程：

{
  providers: {
    minimax: {
      type: "minimax",
      plugins: ["minimax-portal-auth"],
      baseUrl: "https://api.minimax.io/anthropic"
    }
  }
}

启用此插件后，OpenClaw 会自动处理令牌获取和刷新，无需手动管理凭证。

回退配置方案

为了确保服务稳定性，可以将 MiniMax 作为主力模型的回退选项：

{
  agents: {
    default: {
      // 主要使用 Claude Opus
      model: "anthropic/claude-opus-4-5",
      fallback: [
        "minimax/m2.1"  // Opus 不可用时切换到 MiniMax
      ]
    }
  }
}

也可以反过来，以 MiniMax 为主、Claude 为备：

{
  agents: {
    default: {
      model: "minimax/m2.1",
      fallback: ["anthropic/claude-sonnet-4-6"]
    }
  }
}

本地推理方案

如果你希望在本地运行 MiniMax 模型（例如在离线或隐私敏感场景），可以通过 LM Studio 加载 MiniMax 的开放权重版本：

{
  providers: {
    "minimax-local": {
      type: "openai-compatible",
      baseUrl: "http://localhost:1234/v1",
      apiKey: "lm-studio"  // LM Studio 的默认 key
    }
  },
  agents: {
    local: {
      model: "minimax-local/minimax-m2.1-gguf"
    }
  }
}

常见问题

Q：MiniMax API 兼容 Anthropic 格式是什么意思？ MiniMax 的 API 端点接受与 Anthropic Claude API 相同格式的请求体和响应体。OpenClaw 利用这一兼容性，使用相同的客户端逻辑与 MiniMax 通信。

Q：OAuth 令牌过期后怎么办？ 如果使用了 minimax-portal-auth 插件，令牌会自动刷新。否则需要重新执行 openclaw onboard --provider minimax 进行授权。

Q：200K 上下文与 Claude 的区别？ 虽然上下文窗口大小相近，但不同模型对长上下文的处理效果可能有差异。建议根据实际任务效果选择最合适的模型。

Q：国内端点和国际端点功能一样吗？ 功能完全相同，区别仅在于网络路由。大陆用户使用 api.minimaxi.com 会获得更好的连接速度和稳定性。