OpenClaw v2.7.9 对接 MiniMax 大模型完整配置教程
本文详细讲解在 OpenClaw v2.7.9 内接入 MiniMax 大模型的整套操作流程,按照文中步骤依次设置,即可完成接口连通,正常调用对应模型开展对话交互。
一、部署前置条件
- 本地已完整部署 OpenClaw v2.7.9 并正常打开运行;
- 软件右上角 Gateway 状态显示在线;
- 电脑网络环境可正常访问 MiniMax 开放平台;
- 提前注册 MiniMax 开放平台个人账户;
- 账户内留有可用额度,额度不足时需完成充值操作。
二、MiniMax 平台端操作步骤
步骤 1:登录开放平台后台
打开 MiniMax 开放平台登录页面:https://platform.minimaxi.com/login 页面支持密码登录、手机验证码登录、邮箱验证码登录、子账号登录四种方式,按需选择登录渠道,勾选平台用户协议后进入个人后台。
步骤 2:完成账号资质认证
登录后系统若弹出未认证提示,需要进入认证页面完成个人或企业资质审核,完成认证后才能正常使用接口调用、余额充值功能。
步骤 3:账户余额充值
点击左侧导航栏余额板块,选择充值入口完成额度补充。账户无可用额度时,无法发起模型接口调用请求。
步骤 4:进入接口密钥管理页面
在后台左侧菜单栏找到接口密钥分类,进入页面后创建全新 API 密钥。
步骤 5:自定义密钥标识并生成
弹窗内填写便于区分的名称,推荐填写 OpenClaw,确认信息后点击创建按钮生成密钥凭证。
步骤 6:完整复制保存密钥内容
密钥生成后仅单次完整展示,点击复制按钮妥善留存,避免密钥丢失无法二次查看。
三、OpenClaw 软件内参数配置流程
步骤 7:录入 MiniMax 密钥完成连通校验
- 打开运行中的 OpenClaw v2.7.9,点击界面右上角设置按钮;
- 左侧菜单栏切换至模型配置分类,找到 MiniMax 对应配置项;
- 将复制好的 API 密钥粘贴至输入框;
- 点击测试连接按钮校验连通状态;
- 页面提示连接正常后,点击保存按钮留存全部参数。
MiniMax 通用接口地址无需手动修改,固定为:https://api.minimaxi.com/v1 连通测试通过后,程序会自动识别平台可用模型:MiniMax-M2.5、MiniMax-M2.5-highspeed、MiniMax-M2.7、MiniMax-M2.7-highspeed。
步骤 8:对话界面切换 MiniMax 模型
跳转至软件聊天页面,在模型下拉选择框检索 minimax 标识,选中对应型号即可切换调用。
步骤 9:发送测试消息验证调用效果
输入简单测试语句,例如 “你是什么模型”,软件能够正常返回回复内容,代表整套配置流程全部完成。
四、接入完成自检清单
- 可正常登录 MiniMax 开放平台后台
- 账号完成个人 / 企业资质认证
- 账户内具备可使用额度,已完成充值操作
- 接口密钥页面成功创建并完整留存 API Key
- OpenClaw 配置页准确填入对应密钥,连通测试通过
- 配置参数全部保存生效,程序识别出平台全部可用模型
- 聊天面板成功切换至带有 minimax 标识的模型
- 发送测试消息能够正常获取模型回复
五、高频故障排查指南
1. 接口地址是否需要改动
平台通用接口地址固定为https://api.minimaxi.com/v1,无需手动修改填写。
2. 连通测试失败排查方向
- API Key 是否完整复制,无缺漏、多余空格;
- 账号是否完成资质认证审核;
- 账户余额是否满足调用要求;
- 当前网络能否正常访问 MiniMax 平台;
- 密钥是否粘贴至 MiniMax 专属配置栏。
3. 各型号模型适用场景参考
- MiniMax-M2.5:适配日常通用对话场景
- MiniMax-M2.5-highspeed:侧重快速响应,短问答场景优先选用
- MiniMax-M2.7:适配逻辑复杂、长文本类任务
- MiniMax-M2.7-highspeed:兼顾推理能力与响应速度
4. 参数保存成功但无模型回复
- 确认配置页面点击保存,参数生效;
- 聊天面板已切换至 minimax 系列模型;
- 账户内存在可用调用额度;
- API Key 未被平台重置、删除或填写错误。
六、工具安装资源汇总
Windows 适配部署包:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果 macOS 适配部署包:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
整合包整体存储体积约 45.8MB