MiniMax Provider 配置

核心用法

本 Skill 提供 OpenClaw 集成 MiniMax 大模型的完整配置流程，涵盖两种接入方式：

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

配置流程严格遵循"测试→添加→别名→fallback→验证"五步闭环：先用 curl 测试模型可用性，再在 ~/.openclaw/openclaw.json 中注册 provider（注意区分 openai-completions 与 anthropic-messages 协议），配置易用别名（如 Minimax），设置 fallback 链应对额度耗尽，最后通过 openclaw doctor 和真实请求验证。

显著优点

1. 双协议灵活适配：同一模型支持两种认证方式，满足不同用户场景
2. 冷启动自举设计：推荐先用免费 Qwen Coder 启动系统，再让 Agent 协助配置 MiniMax
3. 详尽的额度管理：深入解析 Coding Plan 1500次/5h 滑动窗口机制，提供 cron 监控方案替代不可靠的 API 查询
4. 事故预防机制：明确警告别名配置中非法字段会导致 Gateway 崩溃，并提供 Schema 校验工具

潜在缺点与局限性

• 额度查询 API 不可靠：current_interval_usage_count 惰性更新，无法作为实时监控依据
• OAuth 不适合 failover：认证流程较重，不建议放入 fallback 链
• 多 Agent 消耗快：6 个 agent 全用 MiniMax 时 2-3 小时即可耗尽额度
• 配置复杂度：双 provider 设计增加理解成本，新手易混淆协议与 URL 对应关系

适合人群

• 需要国产大模型替代的 OpenClaw 管理员
• 已订阅 MiniMax Coding Plan 的开发者
• 追求 200K 长上下文与综合能力平衡的技术团队

常规风险

• 额度耗尽导致服务中断：需配置免费模型 fallback 兜底
• 配置错误引发 Gateway 崩溃：Schema 校验失败会触发重启循环，务必先用 openclaw doctor 检查
• 海外访问延迟：MiniMax 服务器在国内，国际链路可能不稳定
• OAuth token 过期：门户认证需关注自动刷新机制

核心用法

本 Skill 是面向 OpenClaw 管理员的纯文档型配置指南，用于将国产大模型 MiniMax（M2.1 系列）接入 OpenClaw 系统。提供两种接入方式：

1. API Key 直连（minimax）：采用 OpenAI 兼容协议，需付费 API Key，适合标准付费用户
2. OAuth 门户（minimax-portal）：采用 Anthropic Messages 协议，支持免费额度，适合门户账号用户

配置流程包含五个核心步骤：测试模型可用性（curl 验证）、添加 Provider 配置（JSON 编辑）、配置模型别名、接入 Fallback 降级链、验证与重启。文档特别强调"先测试后配置"原则，避免添加未经验证的模型导致请求超时。

显著优点

• 双协议支持：同时覆盖 OpenAI 与 Anthropic 协议生态，兼容不同用户习惯
• 冷启动方案：独创"Qwen Coder 自举"模式，让免费模型协助配置付费模型
• 额度透明：详细披露 Coding Plan 计费模式（1500次/5小时滑动窗口），并提供多 Agent 消耗优化建议
• 风险前置：明确标注配置陷阱（如别名配置非法字段导致 Gateway 崩溃），附带真实事故案例
• 完整排障：覆盖 401/429 错误、额度 API 不可靠、OAuth 认证失败等常见问题

潜在局限

• 文档型 Skill：纯 Markdown 无执行代码，需管理员手动执行配置步骤
• 额度查询缺陷：官方 API 存在惰性更新问题，窗口切换后数据不准确，必须依赖真实请求验证
• 地域网络：MiniMax 服务器在国内，海外访问可能延迟较高
• OAuth 不适合 Failover：认证流程较重，不建议放入自动 fallback 链
• 个人维护：由个人开发者维护，非企业级官方文档

适合人群

• OpenClaw 系统管理员需接入国产大模型
• 已购买 MiniMax Coding Plan 的开发者
• 需要双模型栈（主力+备用）的多 Agent 场景用户
• 熟悉 JSON 配置与命令行操作的技术用户

使用风险

1. 配置错误风险：JSON 语法错误、非法字段（如 reasoning 放入别名配置）可导致 Gateway 崩溃循环
2. 额度耗尽风险：6 个 Agent 全用 MiniMax 时，1500次额度约 2-3 小时耗尽，需合理规划 fallback 链
3. API Key 泄露风险：配置文件含敏感密钥，建议使用环境变量替代硬编码
4. OAuth Token 过期：门户方式依赖 OpenClaw 自动刷新，异常时需手动排查
5. 推广链接追踪：文档包含带 referral code 的邀请链接，用户可自主选择是否使用