MiniMax

MiniMax là công ty AI phát triển dòng model M2/M2.1. Phiên bản tập trung vào coding hiện tại là MiniMax M2.1 (ra mắt ngày 23/12/2025), được xây dựng để xử lý các tác vụ phức tạp trong thực tế.

Nguồn: MiniMax M2.1 release note

Tổng quan model (M2.1)

MiniMax nâng cấp những điểm sau trong M2.1:

  • Coding đa ngôn ngữ mạnh hơn (Rust, Java, Go, C++, Kotlin, Objective-C, TS/JS).
  • Phát triển web/app tốt hơn và chất lượng output đẹp hơn (bao gồm cả mobile native).
  • Xử lý composite instruction tốt hơn cho các workflow kiểu văn phòng, dựa trên interleaved thinking và integrated constraint execution.
  • Response ngắn gọn hơn với token usage thấp hơn và vòng lặp nhanh hơn.
  • Tương thích tốt hơn với tool/agent framework và quản lý context (Claude Code, Droid/Factory AI, Cline, Kilo Code, Roo Code, BlackBox).
  • Chất lượng dialogue và technical writing cao hơn.

MiniMax M2.1 vs MiniMax M2.1 Lightning

  • Tốc độ: Lightning là phiên bản “nhanh” trong tài liệu giá của MiniMax.
  • Chi phí: Giá input giống nhau, nhưng Lightning có giá output cao hơn.
  • Coding plan routing: Backend Lightning không khả dụng trực tiếp trên MiniMax coding plan. MiniMax tự động route hầu hết request đến Lightning, nhưng sẽ fallback về backend M2.1 thường khi traffic cao.

Chọn cách cài đặt

MiniMax OAuth (Coding Plan) — khuyên dùng

Phù hợp với: cài đặt nhanh với MiniMax Coding Plan qua OAuth, không cần API key.

Bật plugin OAuth có sẵn và xác thực:

openclaw plugins enable minimax-portal-auth  # bỏ qua nếu đã load rồi
openclaw gateway restart  # restart nếu gateway đang chạy
openclaw onboard --auth-choice minimax-portal

Các bạn sẽ được yêu cầu chọn endpoint:

  • Global - Người dùng quốc tế (api.minimax.io)
  • CN - Người dùng ở Trung Quốc (api.minimaxi.com)

Xem MiniMax OAuth plugin README để biết thêm chi tiết.

MiniMax M2.1 (API key)

Phù hợp với: dùng MiniMax hosted với API tương thích Anthropic.

Cấu hình qua CLI:

  • Chạy openclaw configure
  • Chọn Model/auth
  • Chọn MiniMax M2.1
{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.1" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.1",
            name: "MiniMax M2.1",
            reasoning: false,
            input: ["text"],
            cost: { input: 15, output: 60, cacheRead: 2, cacheWrite: 10 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

MiniMax M2.1 làm fallback (Opus primary)

Phù hợp với: giữ Opus 4.5 làm primary, failover sang MiniMax M2.1.

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": { alias: "opus" },
        "minimax/MiniMax-M2.1": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-5",
        fallbacks: ["minimax/MiniMax-M2.1"],
      },
    },
  },
}

Tùy chọn: Local qua LM Studio (thủ công)

Phù hợp với: chạy local inference với LM Studio. Mình đã thấy kết quả tốt với MiniMax M2.1 trên phần cứng mạnh (ví dụ desktop/server) dùng local server của LM Studio.

Cấu hình thủ công qua openclaw.json:

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.1-gs32" },
      models: { "lmstudio/minimax-m2.1-gs32": { alias: "Minimax" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      lmstudio: {
        baseUrl: "http://127.0.0.1:1234/v1",
        apiKey: "lmstudio",
        api: "openai-responses",
        models: [
          {
            id: "minimax-m2.1-gs32",
            name: "MiniMax M2.1 GS32",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

Cấu hình qua openclaw configure

Dùng config wizard tương tác để cài MiniMax mà không cần sửa JSON:

  1. Chạy openclaw configure.
  2. Chọn Model/auth.
  3. Chọn MiniMax M2.1.
  4. Chọn default model khi được hỏi.

Các tùy chọn cấu hình

  • models.providers.minimax.baseUrl: nên dùng https://api.minimax.io/anthropic (tương thích Anthropic); https://api.minimax.io/v1 là tùy chọn cho payload tương thích OpenAI.
  • models.providers.minimax.api: nên dùng anthropic-messages; openai-completions là tùy chọn cho payload tương thích OpenAI.
  • models.providers.minimax.apiKey: MiniMax API key (MINIMAX_API_KEY).
  • models.providers.minimax.models: định nghĩa id, name, reasoning, contextWindow, maxTokens, cost.
  • agents.defaults.models: alias các model các bạn muốn trong allowlist.
  • models.mode: giữ merge nếu muốn thêm MiniMax cùng với các model có sẵn.

Ghi chú

  • Model refs là minimax/<model>.
  • Coding Plan usage API: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (cần coding plan key).
  • Cập nhật giá trị pricing trong models.json nếu cần theo dõi chi phí chính xác.
  • Link giới thiệu MiniMax Coding Plan (giảm 10%): https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
  • Xem /concepts/model-providers để biết quy tắc provider.
  • Dùng openclaw models list và openclaw models set minimax/MiniMax-M2.1 để chuyển đổi.

Troubleshooting

”Unknown model: minimax/MiniMax-M2.1”

Lỗi này thường có nghĩa là MiniMax provider chưa được cấu hình (không có provider entry và không tìm thấy MiniMax auth profile/env key). Bản fix cho việc phát hiện này có trong 2026.1.12 (chưa release tại thời điểm viết bài). Sửa bằng cách:

  • Nâng cấp lên 2026.1.12 (hoặc chạy từ source main), sau đó restart gateway.
  • Chạy openclaw configure và chọn MiniMax M2.1, hoặc
  • Thêm block models.providers.minimax thủ công, hoặc
  • Set MINIMAX_API_KEY (hoặc MiniMax auth profile) để provider có thể được inject.

Đảm bảo model id phân biệt chữ hoa chữ thường:

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

Sau đó kiểm tra lại với:

openclaw models list