Skip to main contentadd-minimax-provider
为 OpenClaw 配置 MiniMax 作为模型源。MiniMax 提供两种接入方式：API Key 直连（openai-completions 协议）和 OAuth 门户（anthropic-messages 协议）。包含 provider 注册、模型定义、别名配置、fallback 链接入和验证的完整流程。当管理员说想"加 MiniMax"、"配 minimax"、"接入 MiniMax 模型"、"加海螺模型"、"配 M2.1"时使用此 skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/kbarbel640-del/skills --skill add-minimax-providerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
المزيد من هذا المستودع
DeFi intelligence powered by Silverback — market data, swap quotes, technical analysis, yield opportunities, token audits, whale tracking, and AI chat via 11 real-time tools on Base chain
AI image, video, and music generation + editing. Flux, Veo 3.1, Suno V5.
Check balances, send money, and share receive details via Wise
| name | add-minimax-provider |
| description | 为 OpenClaw 配置 MiniMax 作为模型源。MiniMax 提供两种接入方式：API Key 直连（openai-completions 协议）和 OAuth 门户（anthropic-messages 协议）。包含 provider 注册、模型定义、别名配置、fallback 链接入和验证的完整流程。当管理员说想"加 MiniMax"、"配 minimax"、"接入 MiniMax 模型"、"加海螺模型"、"配 M2.1"时使用此 skill。 |
配置 MiniMax Provider（MiniMax 大模型接入）
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
这就是 OpenClaw 的"自举"能力——用一个免费模型启动系统，再用它来配置更强的模型。
可用模型
| 模型 ID | 名称 | Context | reasoning | 说明 |
|---|
MiniMax-M2.1 | MiniMax M2.1 | 200K | ❌ | 主力模型，综合能力强 |
MiniMax-M2.1-lightning | MiniMax M2.1 Lightning | 200K | ❌ | 轻量快速版（仅 portal 确认可用） |
注意：MiniMax 可能随时上线新模型。添加前务必先测试可用性。
前置条件
方式一：API Key 直连（推荐）
方式二：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.<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 排序建议
| 位置 | 模型 | 为什么 |
|---|
| 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 校验
如果输出包含 Unrecognized key 就说明有非法字段，必须修复后才能重启。
5.3 重启 Gateway
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway
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（如已配置）
排障
问题：API 返回 401 Unauthorized
问题：API 返回 429 Too Many Requests
- 原因：触发速率限制
- MiniMax 限制：约 100 prompts / 5 小时（非无限！）
- 修复：等待限制窗口过去，或降低请求频率
- 预防：在 fallback 链中配置其他 provider 作为备用
问题：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) |
المهن ذات الصلةSOC
استنادا إلى تصنيف SOC المهني
