核心用法
本 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 过期:门户认证需关注自动刷新机制