OpenClaw × MiniMax

配置
大模型

MiniMax API Key 申请
与 OpenClaw 接入完整指南

$0.5/百万 Token

中文优化

支持图片/音乐/视频

01

为什么选 MiniMax？

性价比最高的中文大模型

¥ 0.5 / 百万 Tokens

M2.7 输入价格（折后）

¥ 2.0 / 百万 Tokens

M2.7 输出价格（折后）

1M

M3 上下文窗口 100 万 Tokens

MiniMax 内置能力

💬 文本对话（M3 / M2.7 / 高速版）

🖼️ 图片理解（MiniMax-VL-01）

🎨 图片生成（image-01）

🎵 音乐生成（music-2.6）

🎬 视频生成（Hailuo-2.3）

🔍 网页搜索（Token Plan API）

02

两种接入方式

API Key vs OAuth
选哪种？

🔑 API Key 方式

适合：有余额账户，需要精确控制用量
适合：已有 MiniMax 账号

直接填入 API Key

支持国内版 api.minimaxi.com

支持国际版 api.minimax.io

Key 可写入配置文件明文

也可用 SecretRef 引用环境变量

Provider ID

minimax / minimax-cn

🔐 OAuth 方式（Coding Plan）

适合：订阅了 MiniMax Coding Plan
适合：希望免 Key 管理

扫码授权，无需复制 Key

自动续期，无过期问题

额度实时查询（用量 % 显示）

内置额度可看用量百分比

推荐新手使用！

Provider ID

minimax-portal

03

第一步 · 获取 API Key

注册 MiniMax 并创建 API Key

国内版 MiniMax

访问：platform.minimaxi.com

注册账号（手机号验证）

完成实名认证

左侧菜单 → API Keys

点击「创建 API Key」

复制保存，关闭后不可再查看

国际版 MiniMax

访问：platform.minimax.io

注册账号（邮箱）

左侧菜单 → API Keys

点击「Create API Key」

复制保存，关闭后不可再查看

💡 注意

国内版和国际版 API Key 互不通用
国内版填国内地址，国际版填国际地址

04

第二步 · 充值

充值余额（API Key 方式）

充值步骤

登录 platform.minimaxi.com

左侧菜单 → 账户与设置

选择充值金额（最低 ¥10 起）

支付宝 / 微信支付 / 银行卡

充值后立即到账

订阅 Coding Plan（推荐新手）

访问 platform.minimax.io/subscribe

选择 Coding Plan 套餐

月付约 ¥99 起，含固定额度

额度用完自动计费，不超额

OpenClaw 可实时显示剩余 %

💡 推荐先用 Coding Plan

免充值免管理，超额自动停用，更安全

05

第三步 · 配置（方式一）

引导向导配置
最简单

# 运行引导，选择 MiniMax
openclaw onboard
# 或直接选择具体方式：
openclaw onboard --auth-choice minimax-cn-api   # 国内 API Key
openclaw onboard --auth-choice minimax-cn-oauth  # 国内 OAuth
openclaw onboard --auth-choice minimax-global-api  # 国际 API Key
openclaw onboard --auth-choice minimax-global-oauth # 国际 OAuth

🔄 向导会做的事

自动写入 ~/.openclaw/openclaw.json
自动配置 baseUrl / apiKey / 模型列表
自动设置默认模型为 MiniMax-M3

06

第三步 · 配置（方式二）

交互式配置命令
单独修改模型

openclaw configure

菜单式交互，方向键选择
选 Model/auth → 选 MiniMax 选项
填入 API Key 或启动 OAuth 扫码

openclaw models

# 查看已配置模型
openclaw models list
# 设置默认模型
openclaw models set minimax/MiniMax-M3
# 查看 MiniMax 模型
openclaw models list --provider minimax

适合已经配置过，想单独换模型的情况

07

第三步 · 配置（方式三）

手动编辑配置文件
最灵活

~/.openclaw/openclaw.json

{
  "env": {
    "MINIMAX_API_KEY": "sk-xxxxxxxxxxxxxxxx"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "${MINIMAX_API_KEY}",
        "api": "anthropic-messages"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "minimax/MiniMax-M3" }
    }
  }
}

各地区 baseUrl 对照

🇨🇳 国内版 api.minimaxi.com

https://api.minimaxi.com/anthropic

🌐 国际版 api.minimax.io

https://api.minimax.io/anthropic

⚠️ 安全提示

API Key 建议用 ${MINIMAX_API_KEY} 引用环境变量
不要把真实 Key 写在明文配置文件

08

OAuth 配置详解

Coding Plan 扫码授权
最省心

📱 ↔️ 💻 ↔️ ☁️

OAuth 授权流程

①

运行 openclaw onboard --auth-choice minimax-cn-oauth

②

浏览器打开 MiniMax 授权页面

③

用 MiniMax 账号扫码确认授权

④

OpenClaw 自动保存凭证，完成！

OAuth vs API Key 对比

对比项	OAuth	API Key
配置难度	⭐ 简单	中等
Key 管理	自动	手动
额度显示	✅ %	需查官网
适合场景	新手/订阅	大用量
Provider ID	minimax-portal	minimax

09

第四步 · 选择模型

MiniMax 模型一览
选对模型省 50% 费用

模型	类型	上下文	输入	输出	说明
MiniMax-M3 ⭐	推理	1M	¥0.5/M	¥2.0/M	最新旗舰，支持图片输入
MiniMax-M2.7	推理	200K	¥0.3/M	¥1.2/M	高性价比，上下文够用
M2.7 Highspeed	推理	200K	¥0.6/M	¥2.4/M	速度更快，适合实时对话
MiniMax-VL-01	视觉	—	¥0.5/M	—	图片理解，AI 看图能力

⭐ 推荐日常使用 M2.7

M3 适合长文本和图片分析

Highspeed 适合实时客服场景

10

第五步 · 验证配置

确认 MiniMax 正常工作

验证命令

# 检查 Gateway 状态
openclaw gateway status
# 查看已配置模型列表
openclaw models list
# 测试发送消息
openclaw chat "你好，测试一下"

在 Control UI（浏览器）里直接发消息也可以

成功标志

models list 显示 minimax/MiniMax-M3

chat 能收到 AI 回复

gateway status 显示 running

Control UI 发消息能正常回复

✅ 配置成功！

现在可以在 Control UI 或接入的渠道里使用 MiniMax 了

11

额外配置 · 可选

图片 · 音乐 · 视频
一网打尽

🎨

图片生成

image-01 模型
16:9 / 4:3 / 1:1 等

"imageGenerationModel": {
  "primary": "minimax/image-01"
}

🎵

音乐生成

music-2.6 模型
支持歌词 / 纯音乐

"musicGenerationModel": {
  "primary": "minimax/music-2.6"
}

🎬

视频生成

Hailuo-2.3 模型
文生视频 / 图生视频

"videoGenerationModel": {
  "primary": "minimax/MiniMax-Hailuo-2.3"
}

🔍

网页搜索

MiniMax Search API
结构化搜索结果

"webSearch": {
  "provider": "minimax"
}

12

总结 · 完整流程

从零到跑起来
只需 4 步

①

注册 MiniMax，充值或订阅

platform.minimaxi.com（国内）
platform.minimax.io（国际）

免费注册

②

获取 API Key

左侧菜单 → API Keys → 创建并复制
国内版和国际版二选一

¥10 起充值

③

配置 OpenClaw

openclaw onboard --auth-choice minimax-cn-api
或 openclaw configure → Model/auth → MiniMax

1 分钟完成

④

验证 & 开始使用

openclaw models list 确认模型
openclaw dashboard 打开控制面板

✅ 完成

13

常见问题

遇到问题？

❌ Unknown model: minimax/MiniMax-M3

Provider 未配置或 Key 无效

openclaw doctor --fix
openclaw models list

⚠️ API Key 无效或余额不足

检查 Key 是否正确 / 账户余额

# 检查余额
platform.minimaxi.com → 账户与设置

⚠️ 401 Unauthorized

Key 过期 / Key 格式错误 / 使用了错误的 baseUrl

确认国内版用 api.minimaxi.com
国际版用 api.minimax.io

💡 始终修复不了？

用 doctor 自动修复，或重置配置：

openclaw onboard --reset
# 完全重置，重新来过

14

🚀

MiniMax 配置完成
开始使用！

API Key 申请 + OpenClaw 配置
全程约 5-10 分钟

🍎 Apple 风格指南

¥0.5 / 百万 Token

1M 上下文

文档：https://docs.openclaw.ai
MiniMax 平台：platform.minimaxi.com（国内）
OpenClaw MiniMax 配置：docs.openclaw.ai/providers/minimax

15

配置大模型