使用指南约8分钟

OpenClaw MiniMax 配置完整指南(2026)

MiniMax 是国内直连的 AI 模型服务,注册即赠免费 token 额度,非常适合 OpenClaw 国内用户。本文提供从注册到配置的完整步骤,包括 openclaw.json 配置示例和常见报错解决方法。

为什么选择 MiniMax?

对于国内 OpenClaw 用户,MiniMax 是首选模型提供商之一:

  • 国内直连:无需代理,延迟低,稳定性好
  • 免费额度:注册即赠约 1,000 万 tokens,够普通用户用 1-3 个月
  • 性价比高:超出免费额度后,价格也明显低于 OpenAI
  • 中文优化:针对中文场景进行了专项优化,回复质量好

第一步:注册 MiniMax 账号并获取 API Key

  1. 访问 MiniMax 开放平台,点击「注册」
  2. 使用手机号完成注册,实名认证(国内用户必须)
  3. 进入控制台,点击左侧「账户管理」→「API Key 管理」
  4. 点击「新建 API Key」,复制生成的 Key(格式类似 eyJh...

注意:API Key 只显示一次,请立即保存到安全的地方。


第二步:了解 MiniMax 支持的模型

模型名称 特点 适用场景
MiniMax-M2.5 最新旗舰版,综合能力强 日常对话、复杂任务
MiniMax-M2.1 上一代版本,稳定可靠 轻量任务、批量处理
MiniMax-VL-01 支持图像输入 图片分析、OCR
abab6.5s-chat 速度快、成本低 高频轻量对话

第三步:配置 openclaw.json

在项目根目录的 openclaw.json 中添加 MiniMax 配置:

{
  "models": [
    {
      "provider": "minimax",
      "apiKey": "eyJh...",
      "baseUrl": "https://api.minimaxi.com/v1",
      "models": [
        "MiniMax-M2.5",
        "MiniMax-M2.1",
        "MiniMax-VL-01"
      ]
    }
  ],
  "defaultModel": "MiniMax-M2.5"
}

保存后重启 gateway 服务:pnpm gateway


第四步:验证配置是否成功

重启后,在聊天界面顶部的模型下拉框中应该能看到 MiniMax 的模型列表。发送一条测试消息,如果正常收到回复,配置成功。

也可以通过日志验证:

tail -f logs/gateway.log

正常日志会显示 [minimax] connected,如果有错误会显示具体原因。


MiniMax 定价参考

模型 输入价格 输出价格
MiniMax-M2.5 约 ¥1/百万 tokens 约 ¥5/百万 tokens
MiniMax-M2.1 约 ¥0.5/百万 tokens 约 ¥2/百万 tokens
abab6.5s 约 ¥0.1/百万 tokens 约 ¥0.1/百万 tokens

注册赠送约 1,000 万输入 tokens 免费额度,轻量使用可用 1-3 个月。


常见配置错误与解决方法

错误:Invalid API Key 原因:API Key 复制不完整或包含空格。解决:重新从控制台复制,注意不要有多余空格。

错误:Model not found 原因:模型名称拼写错误。解决:严格按照文档中的模型名称填写,注意大小写。

错误:连接超时 原因:网络问题或 baseUrl 配置错误。解决:检查 baseUrl 是否为 https://api.minimaxi.com/v1


常见问题

Q:MiniMax API Key 在哪里找?

登录 MiniMax 开放平台(minimaxi.com)→ 控制台 → 账户管理 → API Key 管理。

Q:配置后模型不出现怎么办?

检查 openclaw.json 的 JSON 格式是否正确(可用在线 JSON 校验工具),然后完全重启 gateway 服务(Ctrl+C 停止后重新运行 pnpm gateway)。


延伸阅读

关注我们,获取最新 AI 动态

在 X 上关注 @lanmiaoai,第一时间获取教程更新、AI 工具推荐。

立即关注

المزيد من الأسئلة