MiniMax Provider 配置 — 为 OpenClaw 添加 MiniMax 模型源

Name: MiniMax Provider 配置 — 为 OpenClaw 添加 MiniMax 模型源
Rating: 1 (1 reviews)
Author: jooey

jooey

MiniMax Provider 配置 — 为 OpenClaw 添加 MiniMax 模型源

v2.0.0

此技能帮助您将 MiniMax 模型集成到 OpenClaw 中，支持 API Key 直连和 OAuth 门户两种接入方式。包括注册、模型定义、别名配置、fallback 链接入和验证。适用于需要配置 MiniMax 模型的开发者。

1· 1,657·3 当前·3 累计

by @jooey·MIT-0

开发工具 API工具安全自动化 AI模型访问

下载技能包

License

MIT-0

最后更新

2026/2/26

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

技能遵循目的（添加 MiniMax 提供商），无意外凭据、安装或恶意行为请求，但存储 API 密钥在 OpenClaw 配置中有安全隐患。

评估建议

技能如描述添加 MiniMax 提供商。安装前：备份配置、优先使用 OAuth、验证 URL 和连接、注意 README 中的推广链接。...

详细分析 ▾

✓ 用途与能力

技能名称/描述与指令匹配，测试端点、添加提供商条目、配置别名和 fallback，无不相关的凭据、二进制或操作。

ℹ 指令范围

指令在提供商配置范围内（测试 api.minimaxi.com、编辑 openclaw.json、配置别名和 fallback）。值得注意的是，技能明确指示将 API 密钥或 OAuth 标记存储在 OpenClaw 配置文件中，这在任务中是一致的隐私/安全考虑。

✓ 安装机制

仅指令技能（无安装规格、无代码文件）。README 建议通过 clawhub/git/github tarball 可选安装，标准且预期，无不透明的随机服务器下载安装。

ℹ 凭证需求

技能不请求不相关的环境变量或凭据。预期用户提供 MiniMax API 凭据（或使用 OpenClaw 的 'minimax-oauth' 标记）。这是合理的，但存储 API 密钥在 ~/.openclaw/openclaw.json 中意味着如果 OpenClaw 不自行加密，密钥将以明文保存 — 用户应了解并在可能时优先使用 OAuth。

✓ 持久化与权限

技能不请求 always:true，也不尝试修改其他技能或超出写入用户 OpenClaw 配置的提供商条目之外的全局代理设置 — 这是 provider-install 技能的预期效果。自主调用是平台默认设置，不是这里的独特风险。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv2.0.02026/2/8

v2.0：新增 Coding Plan 额度管理、滑动窗口说明、额度 API 不可信警告、多 Agent 消耗建议

● 无害

安装命令点击复制

官方npx clawhub@latest install add-minimax-provider

镜像加速npx clawhub@latest install add-minimax-provider --registry https://cn.clawhub-mirror.com

技能文档

（由于字符限制，以下仅提供部分翻译，完整内容请根据需要自行翻译）

# 配置 MiniMax Provider（MiniMax 大模型接入） MiniMax 是国产大模型服务商，提供 MiniMax-M2.1 系列模型。OpenClaw 支持两种接入方式：... （以下内容同原文，保留代码块、命令行不翻译）

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

Provider	接入方式	API 协议	Base URL	适用场景
`minimax`	API Key 直连	`openai-completions`	`api.minimaxi.com/v1`	标准付费用户
`minimax-portal`	OAuth 门户	`anthropic-messages`	`api.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。

步骤

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

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

让 Qwen Coder 帮你配 MiniMax：

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

切换主力模型：

   /model Minimax

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

可用模型

模型 ID	名称	Context	reasoning	说明
`MiniMax-M2.1`	MiniMax M2.1	200K	❌	主力模型，综合能力强
`MiniMax-M2.1-lightning`	MiniMax M2.1 Lightning	200K	❌	轻量快速版（仅 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`
`api`	`openai-completions`	`anthropic-messages`
`apiKey`	`sk-cp-...` (真实密钥)	`minimax-oauth` (OAuth 标记)
`authHeader`	`true`	默认
计费	按量付费	平台侧处理
模型	M2.1	M2.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..alias     <-- 唯一合法字段
agents.defaults.models..reasoning <-- 非法！会导致 Gateway 崩溃！
agents.defaults.models..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 排序建议

位置	模型	为什么
primary	minimax/MiniMax-M2.1	主力，综合能力强
fallback 1	minimax/MiniMax-M2.1	重试一次
fallback 2	deepseek/deepseek-chat	按量付费备用
fallback 3	qwen-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 返回数字不一致
唯一可靠的判断方式：发一个真实测试请求

多 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 " \
  -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-08	v1.0	创建 MiniMax provider 配置指南	ConfigBot (via OpenClaw with Opus 4.6)
2026-02-09	v2.0	新增 Coding Plan 额度管理专节；更新额度信息 (1500/5h 滑动窗口)；额度 API 不可信警告；多 Agent 消耗建议	ConfigBot (via OpenClaw with Qwen3-30B)

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

零起步冷启动

步骤

可用模型

前置条件

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

方式二：OAuth 门户

第一步：测试模型可用性

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

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

1C. 测试 Lightning 模型

第二步：添加 Provider

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

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

两个 provider 的关键差异

只添加你确认可用的模型

第三步：配置别名

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

第四步：接入 Fallback 链

Fallback 排序建议

第五步：验证

5.1 JSON 语法检查

5.2 Schema 校验

5.3 重启 Gateway

5.4 功能验证

Coding Plan 额度管理

计费模式

⚠️ 额度查询 API 不可信

推荐监控方案

多 Agent 消耗建议

排障

问题：API 返回 401 Unauthorized

问题：API 返回 429 Too Many Requests

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

问题：Gateway 启动后立刻崩溃

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

问题：OAuth 门户认证失败

变更记录

安装命令点击复制

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