本文へ移動
cccskills
無料GitHub で公開

add-minimax-provider

为 OpenClaw 配置 MiniMax 作为模型源。MiniMax 提供两种接入方式：API Key 直连（openai-completions 协议）和 OAuth 门户（anthropic-messages 协议）。包含 provider 注册、模型定义、别名配置、fallback 链接入和验证的完整流程。

当管理员说想"加 MiniMax"、"配 minimax"、"接入 MiniMax 模型"、"加海螺模型"、"配 M2.1"时使用此 skill。

modbender/skill-library-mcp
インストール方法を見る

含まれるファイル（2）

  • SKILL.md13.7 KB
  • README.md2.6 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

配置 MiniMax Provider（MiniMax 大模型接入）

MiniMax 是国产大模型服务商，提供 MiniMax-M2.1 系列模型。OpenClaw 支持两种接入方式：

Provider接入方式API 协议Base URL适用场景
minimaxAPI Key 直连openai-completionsapi.minimaxi.com/v1标准付费用户
minimax-portalOAuth 门户anthropic-messagesapi.minimaxi.com/anthropic免费/门户用户

为什么有两个 provider？

  • API Key 直连 (minimax)：使用标准 OpenAI 兼容协议，需要付费 API Key，按量计费
  • OAuth 门户 (minimax-portal)：使用 Anthropic Messages 协议 + OAuth 认证，适合有门户账号的用户（可能有免费额度）

两种方式访问的是同一个模型，但协议和认证方式不同，所以必须分开配置。

如果觉得这个 Skill 有用，欢迎通过邀请链接注册 MiniMax Coding Plan（9 折优惠 + Builder 权益）： https://platform.minimaxi.com/subscribe/coding-plan?code=2vNMQFJrZt&source=link

零起步冷启动

还没有任何模型可用？ 可以用 Qwen Coder（免费）作为冷启动模型，然后让它帮你配置 MiniMax。

步骤

  1. 先配好 Qwen Coder（免费，无需 API Key，OAuth 登录即可）：

    • 在 OpenClaw 中添加 qwen-portal provider
    • 用 Qwen Coder 作为 primary 模型启动系统

  2. 让 Qwen Coder 帮你配 MiniMax：

    • 在聊天中告诉 Agent："帮我配置 MiniMax 模型"
    • Agent 会自动加载本 skill 并按步骤执行
    • 配置完成后，将 primary 切换为 MiniMax

  3. 切换主力模型：

    /model Minimax

这就是 OpenClaw 的"自举"能力——用一个免费模型启动系统，再用它来配置更强的模型。

可用模型

模型 ID名称Contextreasoning说明
MiniMax-M2.1MiniMax M2.1200K❌主力模型，综合能力强
MiniMax-M2.1-lightningMiniMax M2.1 Lightning200K❌轻量快速版（仅 portal 确认可用）

注意：MiniMax 可能随时上线新模型。添加前务必先测试可用性。

前置条件

方式一：API Key 直连（推荐）

项目说明
国内MiniMax 账号在 platform.minimaxi.com 注册
API Key格式为 sk-cp-... 的密钥，在控制台 → API Keys 页面创建
余额确保账户有足够余额

方式二：OAuth 门户

项目说明
MiniMax 账号同上
OAuth 配置在 OpenClaw 中配置 apiKey: "minimax-oauth"，OpenClaw 会自动处理 OAuth 流程

第一步：测试模型可用性

这一步不能跳过。 先确认模型能调通再加配置。

1A. 测试 API Key 直连（openai-completions 协议）

curl -s --max-time 15 https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer <你的API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M2.1","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

如果返回正常的 JSON 响应（含 choices）= 可用。

1B. 测试 OAuth 门户（anthropic-messages 协议）

OAuth 门户无法直接用 curl 测试（需要 OAuth token 流程）。配置好后通过 OpenClaw 实际发消息验证。

1C. 测试 Lightning 模型

curl -s --max-time 15 https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer <你的API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M2.1-lightning","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

如果返回错误，说明该模型可能仅在 portal 端可用，或尚未对你的账户开放。

第二步：添加 Provider

在 ~/.openclaw/openclaw.json 的 models.providers 下添加 provider。根据你的接入方式选择一种或两种都配。

2A. 添加 minimax（API Key 直连）

"minimax": {
  "baseUrl": "https://api.minimaxi.com/v1",
  "apiKey": "<你的API_KEY>",
  "api": "openai-completions",
  "authHeader": true,
  "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
    }
  ]
}

2B. 添加 minimax-portal（OAuth 门户）

"minimax-portal": {
  "baseUrl": "https://api.minimaxi.com/anthropic",
  "apiKey": "minimax-oauth",
  "api": "anthropic-messages",
  "models": [
    {
      "id": "MiniMax-M2.1",
      "name": "MiniMax M2.1",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 200000,
      "maxTokens": 8192
    },
    {
      "id": "MiniMax-M2.1-lightning",
      "name": "MiniMax M2.1 Lightning",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 200000,
      "maxTokens": 8192
    }
  ]
}

apiKey: "minimax-oauth" 是 OpenClaw 的特殊标记，表示使用 OAuth 认证流程而非静态 API Key。cost 设为 0 因为 OAuth 门户的计费由平台侧处理。

两个 provider 的关键差异

参数minimax (API Key)minimax-portal (OAuth)
baseUrl.../v1.../anthropic
apiopenai-completionsanthropic-messages
apiKeysk-cp-... (真实密钥)minimax-oauth (OAuth 标记)
authHeadertrue默认
计费按量付费平台侧处理
模型M2.1M2.1 + Lightning

只添加你确认可用的模型

错误做法：把所有模型都堆上去 正确做法：只添加第一步中测试通过的模型

添加不存在的模型不会导致崩溃，但 fallback 到它时会浪费一次请求超时，影响响应速度。

第三步：配置别名

在 agents.defaults.models 下为 MiniMax 模型添加别名：

{
  "agents": {
    "defaults": {
      "models": {
        "minimax/MiniMax-M2.1": { "alias": "Minimax" },
        "minimax-portal/MiniMax-M2.1": { "alias": "minimax-portal" },
        "minimax-portal/MiniMax-M2.1-lightning": { "alias": "minimax-lightning" }
      }
    }
  }
}

配置后用户可以在聊天中用 /model Minimax、/model minimax-lightning 切换模型。

⚠️ 别名配置的唯一合法字段是 alias

agents.defaults.models.<model-id>.alias     <-- 唯一合法字段
agents.defaults.models.<model-id>.reasoning <-- 非法！会导致 Gateway 崩溃！
agents.defaults.models.<model-id>.xxx       <-- 任何其他字段都非法！

已知事故：在别名配置里加了非法字段导致 schema 校验失败，Gateway 崩溃循环 181 次。模型能力属性只能放在 models.providers 的模型定义里。

第四步：接入 Fallback 链

在 agents.defaults.model 中配置 MiniMax 的位置。MiniMax 通常作为主力模型（primary）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/MiniMax-M2.1",
        "fallbacks": [
          "minimax/MiniMax-M2.1",
          "deepseek/deepseek-chat",
          "qwen-portal/coder-model"
        ]
      }
    }
  }
}

Fallback 排序建议

位置模型为什么
primaryminimax/MiniMax-M2.1主力，综合能力强
fallback 1minimax/MiniMax-M2.1重试一次
fallback 2deepseek/deepseek-chat按量付费备用
fallback 3qwen-portal/coder-model免费兜底

MiniMax-portal 不建议放入 fallback 链——OAuth 认证流程较重，不适合快速 failover。需要时通过 /model minimax-portal 手动切换。

第五步：验证

5.1 JSON 语法检查

python3 -c "import json; json.load(open('$HOME/.openclaw/openclaw.json')); print('JSON OK')"

5.2 Schema 校验

openclaw doctor

如果输出包含 Unrecognized key 就说明有非法字段，必须修复后才能重启。

5.3 重启 Gateway

# macOS
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

# 等 3 秒后确认状态
sleep 3
launchctl print gui/$(id -u)/ai.openclaw.gateway | grep -E "job state|last exit"

期望看到：

last exit code = 0
job state = running

如果 last exit code = 1，检查错误日志：

tail -20 ~/.openclaw/logs/gateway.err.log

5.4 功能验证

在任意已绑定的聊天中测试：

/model Minimax           # 测试 API Key 直连
/model minimax-portal    # 测试 OAuth 门户（如已配置）
/model minimax-lightning # 测试 Lightning（如已配置）

Coding Plan 额度管理

计费模式

项目值
月费¥49
额度1500 次/5小时滑动窗口
每日理论上限~7200 次
窗口计算每次调用倒算前 5 小时消耗（滑动窗口）

⚠️ 额度查询 API 不可信

API 端点 GET /v1/api/openplatform/coding_plan/remains 存在已知问题：

  • 窗口切换后 current_interval_usage_count 不刷新（惰性更新）
  • 平台控制台与 API 返回数字不一致
  • 唯一可靠的判断方式：发一个真实测试请求

推荐监控方案

不要用 API 数字做监控。推荐在 OpenClaw 中配置 cron 任务，定期发测试请求验证可用性：

# cron 表达式示例：每 5 小时执行一次验证
# 发真实请求 → 通了就可用，不通就记录
curl -s https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M2.1","messages":[{"role":"user","content":"test"}],"max_tokens":3}'

判断逻辑：

  • 返回 choices → 可用
  • 返回 429 → 额度耗尽，等待滑动窗口释放
  • 返回其他错误 → API 故障，走 fallback

多 Agent 消耗建议

6 个 agent 全用 MiniMax 时，1500 条/5h 大约 2-3 小时就用完。建议：

  • 核心 agent（main、ada）用 MiniMax
  • 辅助 agent（clara、sophia）用免费模型（Qwen/SiliconFlow）
  • Fallback 链兜底，额度耗尽自动降级

排障

问题：API 返回 401 Unauthorized

  • 原因：API Key 无效或过期
  • 修复：登录 platform.minimaxi.com 检查 Key 状态，必要时重新生成

问题：API 返回 429 Too Many Requests

  • 原因：Coding Plan 额度耗尽
  • MiniMax Coding Plan 限制：1500 次/5小时滑动窗口（每次调用倒算前 5 小时消耗）
  • 修复：等待旧调用滑出 5 小时窗口，或让 fallback 链自动降级
  • 预防：在 fallback 链中配置免费模型（如 siliconflow/Qwen/Qwen3-8B）作为兜底

问题：额度查询 API 数据不准确

  • 现象：GET /v1/api/openplatform/coding_plan/remains 返回的 current_interval_usage_count 与平台控制台显示不一致
  • 原因：API 为惰性更新，窗口切换后如无新调用则不刷新计数器
  • 应对：不要完全信任 API 返回数字。判断额度是否可用，最可靠的方法是发一个真实测试请求
  • 验证命令：
curl -s https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M2.1","messages":[{"role":"user","content":"test"}],"max_tokens":3}'

返回 choices = 可用；返回 429 = 额度确实耗尽

问题：Gateway 启动后立刻崩溃

  • 最可能原因：配置中有非法字段
  • 诊断：tail -20 ~/.openclaw/logs/gateway.err.log，找 Unrecognized key
  • 修复：删除非法字段，运行 openclaw doctor 确认

问题：模型回复为空或超时

  • 检查 baseUrl：API Key 直连应为 https://api.minimaxi.com/v1，不要多加或少加路径
  • 检查 api 协议：API Key 直连用 openai-completions，OAuth 门户用 anthropic-messages
  • 检查网络：MiniMax 服务器在国内，海外访问可能较慢

问题：OAuth 门户认证失败

  • 原因：OAuth token 过期或未正确配置
  • 修复：确认 apiKey 字段值为 "minimax-oauth"（精确匹配），OpenClaw 会自动处理 OAuth 流程
  • 诊断：检查 ~/.openclaw/logs/gateway.log 中的 OAuth 相关错误

变更记录

日期版本变更内容变更人
2026-02-08v1.0创建 MiniMax provider 配置指南ConfigBot (via OpenClaw with Opus 4.6)
2026-02-09v2.0新增 Coding Plan 额度管理专节；更新额度信息 (1500/5h 滑动窗口)；额度 API 不可信警告；多 Agent 消耗建议ConfigBot (via OpenClaw with Qwen3-30B)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

✅ 已通过自我审核（v1.0.2）

無料

name: 4d-compression-core version: 1.0.2 description: "把长内容压缩成结构化向量——节省 60-80% Token，保留核心信息" metadata: { "openclaw": { "emoji": "🌀", "requires": { "bins": ["jq", "awk"] }, "triggers": ["压缩", "4d",...

日本語の概要は準備中です。原文の説明を表示しています。

modbender/skill-library-mcp162026年9月28日 更新

0g-compute

無料

Use cheap, TEE-verified AI models from the 0G Compute Network as OpenClaw providers. Discover available models and compare pricing vs OpenRouter, verify provider integrity via hardware attestation (Intel TDX), manage your 0G wallet and sub-accounts, and configure models in OpenClaw with one workflow. Supports DeepSeek, GLM-5, Qwen, and other models available on the 0G marketplace.

日本語の概要は準備中です。原文の説明を表示しています。

modbender/skill-library-mcp162026年9月28日 更新

0x0-messenger

無料

Send and receive P2P messages using disposable numbers and PINs. No servers, no accounts. Use for human notifications, approval flows, and agent-to-agent communication.

日本語の概要は準備中です。原文の説明を表示しています。

modbender/skill-library-mcp162026年9月28日 更新

0xarchive

無料

Query historical crypto market data from 0xArchive across Hyperliquid, Lighter.xyz, and HIP-3. Covers orderbooks, trades, candles, funding rates, open interest, liquidations, and data quality. Use when the user asks about crypto market data, orderbooks, trades, funding rates, or historical prices on Hyperliquid, Lighter.xyz, or HIP-3.

日本語の概要は準備中です。原文の説明を表示しています。

modbender/skill-library-mcp162026年9月28日 更新

0xwork

無料

Find and complete paid tasks on the 0xWork decentralized marketplace (Base chain, USDC escrow). Use when: the agent wants to earn money/USDC by doing work, discover available tasks, claim a bounty, submit deliverables, check earnings or wallet balance, or set up as a 0xWork worker. Task categories: Writing, Research, Social, Creative, Code, Data. NOT for: posting tasks (use the website), managing the 0xWork platform, or frontend development.

日本語の概要は準備中です。原文の説明を表示しています。

modbender/skill-library-mcp162026年9月28日 更新

10x-patterns

無料

Patterns and practices that dramatically accelerate development velocity. Covers parallel execution, automation, feedback loops, workflow optimization, and anti-pattern avoidance. Use when starting projects, planning sprints, optimizing workflows, or onboarding developers.

日本語の概要は準備中です。原文の説明を表示しています。

modbender/skill-library-mcp162026年9月28日 更新

modbender のスキルをすべて見る

このスキルの問題を報告する