核心用法
本 Skill 指导管理员在 OpenClaw 中配置 MiniMax 作为模型源。MiniMax 提供两种互斥接入方式：
1. API Key 直连（`minimax`）
- 协议：
openai-completions，Base URL:api.minimaxi.com/v1 - 需付费 API Key（
sk-cp-...格式），按量计费 - 适合标准付费用户，支持 MiniMax-M2.1 主力模型
2. OAuth 门户（`minimax-portal`）
- 协议：
anthropic-messages，Base URL:api.minimaxi.com/anthropic - 使用特殊标记
apiKey: "minimax-oauth"，OpenClaw 自动处理 OAuth 流程 - 适合有门户账号的用户，可能含免费额度，额外支持 Lightning 轻量版
配置流程遵循五步验证：① 用 curl 测试模型可用性 → ② 在 ~/.openclaw/openclaw.json 添加 provider → ③ 配置别名（如 Minimax）→ ④ 接入 fallback 链 → ⑤ JSON 语法检查、openclaw doctor 校验、重启 Gateway、功能测试。
显著优点
- 双协议灵活接入：同一模型支持 OpenAI 兼容协议和 Anthropic Messages 协议，适配不同用户场景
- 200K 长上下文：M2.1 系列支持 20 万 token 上下文，适合代码分析、长文档处理
- 国产模型优势：服务器位于国内，国内访问延迟低，合规性强
- 冷启动友好：文档提供 Qwen Coder 免费冷启动方案，实现"自举"配置
- 详尽排障指南：覆盖 401/429 错误、额度 API 不可靠、Gateway 崩溃等典型问题
潜在局限
- 速率限制严格：Coding Plan 采用 1500 次/5 小时滑动窗口，高频场景易触发限流
- 额度 API 不可靠：官方额度查询接口为惰性更新，无法实时反映真实剩余额度
- Lightning 模型可用性不确定：轻量版仅在 portal 端确认可用，API Key 直连可能返回错误
- OAuth 不适合 failover：认证流程较重，不推荐放入 fallback 链自动切换
- 配置敏感：
agents.defaults.models下仅能配置alias字段，其他字段会导致 Gateway 崩溃循环
适合人群
- 需要国产大模型替代方案的 OpenClaw 管理员
- 已有 MiniMax Coding Plan 订阅的开发者
- 追求 200K 长上下文 + 按量计费性价比的技术团队
- 希望用 OAuth 免费额度试用的入门用户
常规风险
| 风险等级 | 场景 | 缓解措施 |
|---------|------|---------|
| 🔴 高 | 配置非法字段导致 Gateway 崩溃循环 | 严格遵循 schema，`openclaw doctor` 验证后再重启 |
| 🟡 中 | 额度耗尽导致 429，影响业务连续性 | fallback 链配置免费兜底模型（如 siliconflow/Qwen）|
| 🟡 中 | 依赖额度 API 判断可用性导致误判 | 以真实请求测试为准，不信任 `remains` 接口返回值 |
| 🟢 低 | 海外网络访问延迟 | 确认服务器位于国内，海外用户需评估网络质量 |