OpenClaw部署教程-OpenClaw 接入 MiniMax M2.5 模型完整教程(含全套餐对比)
本文详细介绍了OpenClaw与MiniMax M2.5/M2.5-highspeed的对接指南。主要内容包括:1)CodingPlan套餐体系解析,涵盖普通版和极速版6档选择建议;2)MiniMax M2.5模型能力范围,支持全栈编程但无多媒体功能;3)OpenClaw实操接入步骤,重点说明国内用户必须修改的配置项;4)常见问题解决方案。教程提供了从套餐选择到配置验证的完整流程,帮助开发者快速实
OpenClaw(原 Clawdbot)是轻量级AI编程工具,支持一键对接大模型实现智能编码、Agent开发、代码调试等场景;MiniMax M2.5是专为编程/Agent场景迭代的旗舰文本模型,Coding Plan全套餐均原生支持M2.5,且官方新增极速版套餐(搭载M2.5-highspeed高速模型,推理速度大幅提升),形成「普通版3档+极速版3档」的6档套餐体系(无Starter极速版)。
本教程基于MiniMax官方文档,从全套餐按月/按年对比、订阅活动优惠、M2.5模型能力范围、OpenClaw实操接入、常见问题五个维度,手把手完成二者对接,所有步骤为官方标准配置,适配macOS/Linux/Windows全系统,极速版可直接在配置中切换专属高速模型。
一、Coding Plan 全6档套餐按月/按年深度对比
Coding Plan分为普通版(Starter/Plus/Max)和极速版(Plus-极速版/Max-极速版/Ultra-极速版),核心差异为:极速版搭载专属M2.5-highspeed高速模型(推理速度提升,效果与M2.5一致),同档位普通版与极速版每5小时prompt用量完全一致,仅价格和模型版本不同;所有套餐均采用5小时动态速率限制(5小时前使用的额度自动释放),1个prompt≈15次模型后台调用,之前介绍过两种不同计费方式prompts/5小时和请求次数/5小时的区别,主要区别是prompts计费方式的按你的openclaw调用次数计算且不论你的上下文长度,还不太了解的可以查看我<a href="https://zhuanlan.zhihu.com/p/2015497677920575700"> 之前的文章 https://zhuanlan.zhihu.com/p/2015497677920575700。
1.1 按月订阅(6档,官方基础模式,Starter享首月限时优惠)
按月订阅为灵活计费模式,Starter普通版首月限时9.9元,次月恢复原价,极速版为高频/硬核开发专属,价格为同档位普通版约2倍,核心溢价在高速模型权限。
|
套餐系列 |
套餐类型 |
价格(月) |
每5小时prompt用量 |
搭载核心模型 |
资源倍率(相对Starter) |
官方标签 |
适用场景 |
|---|---|---|---|---|---|---|---|
|
普通版 |
Starter |
¥29 |
40 |
MiniMax M2.5/M2 |
基础用量 |
- |
入门开发,基础编码/调试 |
|
普通版 |
Plus(最优惠) |
¥49 |
100 |
MiniMax M2.5/M2 |
2.5倍 |
最优惠 |
专业开发,复杂编程/Agent开发 |
|
普通版 |
Max |
¥119 |
300 |
MiniMax M2.5/M2 |
7.5倍 |
大用量 |
高级开发,小团队共享/大量编程 |
|
极速版 |
Plus-极速版 |
¥98 |
100 |
M2.5-highspeed/M2.5 |
2.5倍 |
高速专业 |
专业开发,追求快速推理的复杂任务 |
|
极速版 |
Max-极速版 |
¥199 |
300 |
M2.5-highspeed/M2.5 |
7.5倍 |
高速大用量 |
高级开发,小团队高频高速编程 |
|
极速版 |
Ultra-极速版 |
¥899 |
2000 |
M2.5-highspeed/M2.5 |
50倍 |
极速畅用 |
企业/硬核开发者,规模化高速开发 |
1.2 按年订阅(6档,年度限时折扣,立省多期费用)
按年订阅为长期开发首选,无首月优惠,一口价享折扣,无Ultra-极速版年付额外溢价,用量、模型、资源倍率与对应按月套餐完全一致,年付立省金额为官方固定折扣(约8.3折),极速版年付为月付价格×10(立省2个月费用)。
|
套餐系列 |
套餐类型 |
年付价格 |
官方立省金额 |
每5小时prompt用量 |
搭载核心模型 |
适用场景 |
|---|---|---|---|---|---|---|
|
普通版 |
Starter |
¥290 |
¥58 |
40 |
MiniMax M2.5/M2 |
长期入门开发,稳定基础编码 |
|
普通版 |
Plus(最优惠) |
¥490 |
¥98 |
100 |
MiniMax M2.5/M2 |
长期专业开发,高频复杂编程 |
|
普通版 |
Max |
¥1190 |
¥228 |
300 |
MiniMax M2.5/M2 |
长期高级开发,小团队共享 |
|
极速版 |
Plus-极速版 |
¥980 |
¥196 |
100 |
M2.5-highspeed/M2.5 |
长期专业开发,高速推理需求 |
|
极速版 |
Max-极速版 |
¥1990 |
¥398 |
300 |
M2.5-highspeed/M2.5 |
长期高级开发,小团队高速开发 |
|
极速版 |
Ultra-极速版 |
¥8990 |
¥1780 |
2000 |
M2.5-highspeed/M2.5 |
企业长期开发,规模化高速编程 |
1.3 核心套餐选型核心建议
-
新手体验/偶尔开发:选Starter普通版(首月9.9元),低成本体验M2.5核心能力;
-
个人日常专业开发:选Plus普通版(按月/按年),官方标注「最优惠」,覆盖90%编程/Agent开发需求;
-
小团队常规开发:选Max普通版,300 prompts/5小时满足多工具共享;
-
个人高频硬核开发:选Plus-极速版,高速模型提升编码效率,性价比高于Max-极速版;
-
企业/规模化开发:选Ultra-极速版,50倍Starter用量+高速模型,支持多开发者并行开发。
重要提示:OAuth认证接入不需要API Key,手动配置需要API Key。订阅后在MiniMax控制台「账户管理/Coding Plan」获取专属API Key(sk-sp-xxxx格式),极速版无需额外获取Key,同一Key可根据配置切换M2.5/M2.5-highspeed模型。
二、Coding Plan 官方专属订阅活动优惠
MiniMax为Coding Plan推出限时共建邀请计划优惠活动,覆盖新用户首购、老用户邀新,极速版/普通版均可参与,活动规则为官方制定,具体如下:
2.1 好友邀请共建双向奖励活动
-
活动截止时间:2026年4月30日
-
参与资格:
-
邀请人:所有Coding Plan有效订阅用户(含普通版/极速版、历史订阅用户);
-
受邀人:通过邀请链接首次购买Coding Plan的用户(普通版/极速版均可)。
-
参与链接:MiniMax-与用户共创智能
-
双向奖励
|
身份 |
核心奖励权益 |
|---|---|
|
受邀人 |
全场套餐 9 折优惠(含订阅 / 升级);2. 成为「Builder 共建者」,加入 MiniMax 开发者社区;3. 优先参与 M2.5 后续迭代版体验、获取前沿开发案例 |
|
邀请人 |
每成功邀请 1 位好友,获好友订单实付金额10% 的开放平台通用代金券(有效期 90 天,可抵扣 API 调用费);2. 优先参与开发者技术交流活动,获得 M2.5 产品技术直接反馈渠道 |
2.2 活动核心注意事项
-
邀请人不可通过自身邀请链接购买,否则无折扣、无奖励;
-
Coding Plan为订阅制产品,一经购买不支持退款,若受邀人恶意退款,平台将收回对应奖励;
-
禁止机器刷单、恶意注册等违规行为,一经发现取消活动资格并追回已发放奖励。
三、Coding Plan 搭载 MiniMax M2.5 模型能力范围
Coding Plan全套餐均搭载MiniMax M2.5(极速版额外支持M2.5-highspeed高速模型),该模型是专为编程/Agent开发打造的纯文本大模型,核心优化了代码推理、Agent工作流设计、多轮文本对话能力,原生不支持图像/视频/语音的生成/识别,仅可通过MCP协议实现基础图片理解,完整多媒体能力需单独订阅MiniMax图像/语音/视频独立套餐。
3.1 核心支持能力(M2.5+极速版M2.5-highspeed)
|
能力类型 |
支持情况 |
模型亮点/官方补充说明 |
|---|---|---|
|
全栈代码生成/调试/重构 |
✅ 核心支持 |
支持Python/Java/Go/C/C++等10余种主流语言,覆盖从0到1系统设计、代码审查、Bug修复全流程 |
|
Agent开发/工具调用 |
✅ 核心支持 |
具备架构级任务拆解能力,工具调用轮次减少20%,适配OpenClaw的Agent指令执行场景 |
|
超大上下文文本对话 |
✅ 完全支持 |
支持200000超大上下文窗口,适配多轮编码对话、需求分析、长文档处理 |
|
MCP协议对接 |
✅ 支持 |
可调用专属MCP工具,实现基础图片理解、网络深度搜索(无文生图/图生图能力) |
|
图像识别 |
✅ 支持 |
仅可通过MCP协议实现基础图片内容理解 |
|
高性价比推理 |
✅ 极致优化 |
普通版M2.5推理速度100token/秒,极速版M2.5-highspeed速度再提升50%+,延迟更低 |
|
多工具适配 |
✅ 支持 |
可在OpenClaw/MonkeyCode等编程工具中通用,额度全平台共享 |
3.2 暂不支持能力(需单独订阅MiniMax其他套餐)
|
能力类型 |
支持情况 |
官方补充说明 |
|---|---|---|
|
图像识别/图像生成 |
❌ 不支持 |
仅可通过MCP协议实现基础图片内容理解,无文生图/图生图/图像编辑能力 |
|
视频生成/视频理解 |
❌ 不支持 |
MiniMax视频能力为独立产品(海螺AI),未纳入Coding Plan,需单独对接 |
|
语音生成/识别/TTS |
❌ 不支持 |
MiniMax语音2.6模型为独立套餐,支持40+语言,需单独订阅资源包 |
|
音乐生成 |
❌ 不支持 |
MiniMax音乐2.0模型为独立能力,未纳入Coding Plan |
|
批量/自动化调用 |
❌ 禁止 |
Coding Plan专属API Key仅限编程工具交互式使用,批量调用将被视为违规 |
3.3 API Key 使用核心规范
-
Coding Plan专属API Key不可与MiniMax开放平台普通Key混用:前者按prompt计数,后者按Token计费,二者额度互不抵扣;
-
同一API Key可在多个编程工具中使用,额度全平台共享,所有工具的使用会共同消耗prompt用量;
-
极速版无需额外Key,在OpenClaw配置中修改模型ID为M2.5-highspeed即可启用高速模型。
四、OpenClaw 接入 MiniMax M2.5(含极速版)实操指引
本次接入基于MiniMax官方OpenClaw配置文档,同时适配普通版M2.5和极速版M2.5-highspeed,国内用户必须修改API基础地址(baseUrl),否则会出现连接失败,所有命令均为一键式操作,无需手动配置环境。
4.1 前置条件
-
已注册MiniMax账号并订阅Coding Plan(普通版/极速版均可),获取Coding Plan专属API Key(sk-sp-xxxx格式);
-
终端环境:macOS/Linux自带终端即可,Windows建议使用PowerShell(管理员身份);
-
基础环境:Node.js ≥22、Git(OpenClaw安装时会自动检测,缺失将自动安装);
-
网络环境:国内用户需保证网络可访问MiniMax国内接口 https://api.minimaxi.com/anthropic。
4.2 步骤1:一键安装OpenClaw
OpenClaw提供跨系统一键安装命令,直接在终端执行对应命令,全程自动完成安装,无需手动配置依赖:
macOS / Linux 系统
curl -fsSL https://openclaw.bot/install.sh | bash
Windows 系统
iwr -useb https://openclaw.ai/install.ps1 | iex
4.3 步骤2:启动OpenClaw配置流程
4.3.1openclaw初次安装
初次安装后会自动进入配置引导,若未自动启动,在终端执行以下命令手动启动:
openclaw onboard --install-daemon
启动后将出现安全声明,按以下步骤完成基础选择:
-
阅读安全声明后,输入Yes 确认继续;
-
Onboarding Mode 选择QuickStart(快速启动模式,适配99%开发者的编码/Agent开发场景)。

添加图片注释,不超过 140 字(可选)

添加图片注释,不超过 140 字(可选)
4.3.2已安装openclaw并初始化过
通过以下命令再次进行 openclaw 配置:
openclaw configure
选择配置选项
-
Where will the Gateway run? → 选择 Local (this machine)
-
Select sections to configure → 选择 Model
4.4 步骤3:MiniMax M2.5 模型核心配置
4.4.1通过OAuth登录
选择配置选项
-
Model/auth provider → 选择 MiniMax
-
MiniMax auth method → 选择MiniMax OAuth
-
MiniMax endpoint → 选择 CN

添加图片注释,不超过 140 字(可选)

添加图片注释,不超过 140 字(可选)
登录授权
自动弹出登录页,登录并授权。

添加图片注释,不超过 140 字(可选)
确认模型选择
OAuth 登录完成后,进入模型选择。系统会默认勾选 minimax-portal/MiniMax-M2.1 和 minimax-portal/MiniMax-M2.5,并将 minimax-portal/MiniMax-M2.5 设为默认模型,可直接按回车确认使用。

添加图片注释,不超过 140 字(可选)
测试对话
输入 openclaw tui,若成功对话则表示配置成功:

添加图片注释,不超过 140 字(可选)
4.4.2手动安装与配置
模型配置
基础选择完成后,进入模型配置环节,全程按终端提示操作,核心选择MiniMax并填入专属API Key:
-
Step 1: Model/auth provider → 选择 MiniMax
-
Step 2: MiniMax auth method → 选择 MiniMax M2.5
-
Step 3: MiniMax API key → 填入您的 MiniMax API Key
-
Step 4: Models in /model picker → 直接回车使用默认选项
此处默认使用的是 MiniMax 海外版 API Key。如果需要使用 MiniMax 国内 API Key,请在完成配置引导流程后,按照下方「国内用户专属配置」步骤进行修改。
4.5 步骤4:功能个性化配置(按需选择,无强制要求)
模型配置完成后,可根据自身开发场景按需配置功能,所有选项均可后续在配置文件/前端界面修改:
-
Channel 选择:选择需要在哪些应用中进行对话(推荐选「本地终端」,适配编程场景);
-
Skill 配置:按需开启编码相关技能(如代码补全、调试、Agent工具调用、代码审查);
-
Hooks 启用(可选):
-
session-memory:执行/new时自动保存会话上下文,方便多轮编码对话;
-
command-logger:记录所有命令到日志文件,便于问题排查;
-
boot-md:网关启动时自动运行BOOT.md脚本,实现自定义初始化。
4.6 步骤5:国内用户专属配置(关键!必做,含极速版切换)
国内用户使用MiniMax国内版M2.5/极速版M2.5-highspeed,需将默认的海外版baseUrl修改为国内版,并根据套餐修改模型ID(普通版M2.5/极速版M2.5-highspeed),提供配置文件修改(推荐)和前端界面修改(可视化)两种方法,任选其一即可。
方法一:配置文件直接修改(操作更快,推荐开发者)
终端执行命令打开OpenClaw核心配置文件:
open ~/.openclaw/openclaw.json
-
找到models→providers→minimax字段,完成核心修改,根据套餐选择模型ID:
-
必改:将baseUrl从https://api.minimax.io/anthropic → 修改为https://api.minimaxi.com/anthropic;
-
普通版:models[0].id改为MiniMax-M2.5,name同步改为MiniMax M2.5;
-
极速版:models[0].id改为MiniMax-M2.5-highspeed,name同步改为MiniMax M2.5-highspeed。
保存配置文件并关闭,普通版配置片段示例(极速版仅替换模型ID即可):
"models": { "mode": "merge", "providers": { "minimax": { "baseUrl": "https://api.minimaxi.com/anthropic", # 国内版专属地址(必改)(注意:后缀改成.com,且 minimax 后还有个i) "apiKey": "你的Coding Plan专属API Key", # 替换为真实Key "api": "anthropic-messages", "authHeader": true, "models": [ { "id": "MiniMax-M2.5", # 普通版填此ID,极速版改为MiniMax-M2.5-highspeed "name": "MiniMax M2.5", # 名称同步修改 "reasoning": false, "input": ["text"], "contextWindow": 200000, "maxTokens": 8192 } ] } } }
方法二:前端界面修改(可视化操作,适合新手)
-
终端执行命令启动OpenClaw网关:
openclaw gateway run
-
打开浏览器,访问本地网关地址:http://127.0.0.1:18789;
-
进入Config 配置界面,点击左侧models栏目,找到MiniMax配置项;
-
完成必改+可选修改: 必改:baseUrl → 改为https://api.minimaxi.com/anthropic,打开Auth Header开关(鉴权必备);
-
可选:根据套餐修改model id和model name(普通版M2.5/极速版M2.5-highspeed);
点击右上角Save保存配置,再点击Update更新配置,网关将自动重启,模型配置生效。
4.7 步骤6:测试验证,确认M2.5/极速版接入成功
配置完成后,在终端执行以下命令启动OpenClaw终端对话界面,测试模型是否正常响应:
openclaw tui
若出现对话提示符,输入任意字符若收到正常回复,即表示接入成功。

添加图片注释,不超过 140 字(可选)
五、常见问题与官方解决方案
结合MiniMax Coding Plan官方FAQ和OpenClaw接入M2.5/极速版的常见问题,整理额度、配置、API Key、极速版四大维度核心问题及官方解决方案:
5.1 套餐prompt用量达到上限怎么办?
当5小时内prompt用量达到上限,有两种官方解决方案:
-
等待重置:5小时动态窗口,5小时前使用的额度会自动释放,暂停使用即可;
-
切换按量付费:将OpenClaw中的Coding Plan API Key替换为MiniMax开放平台普通API Key,将按实际Token消耗量计费,消耗账户余额,无速率限制。

添加图片注释,不超过 140 字(可选)
5.2 OpenClaw配置后无法响应,提示连接失败?
大概率是国内用户未修改baseUrl,需依次确认:
-
baseUrl已改为https://api.minimaxi.com/anthropic;
-
网络可正常访问该地址,无代理/防火墙拦截;
-
API Key为Coding Plan专属,无空格/换行,鉴权正常;
-
模型ID与套餐匹配(普通版M2.5/极速版M2.5-highspeed)。
5.3 Coding Plan API Key可以和普通Key混用吗?
不可以:
-
Coding Plan Key:专用于套餐,按prompt数量和5小时限额计费,支持M2.5/M2.5-highspeed;
-
开放平台普通Key:用于所有文本AI服务,按Token计费,可调用MiniMax其他文本模型,不可抵扣Coding Plan额度。
5.4 极速版配置后推理速度无提升,如何排查?
-
确认配置文件/前端界面中模型ID已改为MiniMax-M2.5-highspeed,并已保存更新;
-
重启OpenClaw网关(执行openclaw gateway restart),重新启动tui测试;
-
确认订阅的是极速版套餐,普通版套餐无M2.5-highspeed模型权限。
5.5 订阅套餐后未使用完额度,能否退款?
不可以。Coding Plan为订阅制产品,一经购买即视为确认,无论是否使用完额度,均不支持退款,建议根据自身使用需求选择合适的套餐和订阅周期。
5.6 能否在多个工具中使用同一Coding Plan套餐?
可以,但额度为全平台共享,所有支持的编程工具(如OpenClaw/MonkeyCode)的使用会共同消耗prompt用量,小团队共享建议选择Max/Max-极速版。
六、总结
-
MiniMax Coding Plan形成「普通版3档+极速版3档」6档体系,Plus普通版为官方最优选,Starter适合新手,极速版搭载M2.5-highspeed,推理速度提升50%+;
-
OpenClaw接入M2.5的核心是国内用户修改baseUrl,极速版仅需额外替换模型ID为M2.5-highspeed,无需单独获取Key;
-
M2.5是纯文本编程/Agent模型,无图像/视频/语音能力,需多媒体能力可单独订阅MiniMax其他专属套餐;
-
Coding Plan专属API Key仅限编程工具交互式使用,禁止批量/自动化调用,多工具使用时额度全平台共享。
通过本教程可快速完成OpenClaw与MiniMax M2.5/极速版的对接,实现智能编码、Agent开发等场景的落地。
更多推荐



所有评论(0)