MiniMax Agent GroupID为空怎么解决

MiniMax Agent 报 GroupID 为空错误，因旧版接口（如 /v1/text/chatcompletion）必须传 GroupID，而新版 v2 接口（如 /v1/chat/completions）虽不强制但需 API Key 绑定有效组织；应检查 endpoint 路径、控制台组织 ID、配置文件或环境变量中 GroupID 格式及匹配性，并验证环境变量是否生效。

MiniMax Agent 运行时报错提示 GroupID 为空，说明当前配置中缺失组织标识，服务端无法将请求归属到具体账户，直接拒绝鉴权。这种情况在 OpenClaw、HermesAgent 或自定义 SDK 集成中高频出现，尤其当开发者误以为新版接口无需 GroupID 而删掉了该字段时。

确认当前使用的是旧版还是新版接口

新版 v2 接口（如 /v1/chat/completions）确实不再要求传 GroupID，但前提是你的 API Key 已在 MiniMax 控制台绑定到某个组织且该组织已开通对应模型权限；而旧版 v1 接口（如 /v1/text/chatcompletion）

第一步：打开你正在调用的 endpoint URL，看路径里是否含 ?GroupId= 或 /v1/text/ 字样——有则为旧版，必须配 GroupID；若为 /v1/chat/completions 且无 query 参数，则走新版，GroupID 可不填但需确保 Key 绑定有效组织。

第二步：登录 platform.minimax.chat →「账户中心」→「组织管理」，复制页面显示的

检查配置文件中 GroupID 的写法

方法一：OpenClaw 用户检查 openclaw.json

定位到 "minimax" 节点，确认存在 "groupId" 字段，且值为纯字符串，

"minimax": { "apiKey": "sk-xxx", "groupId": "1234567890" } ✅

"minimax": { "apiKey": "sk-xxx", "groupId": ""1234567890"" } ❌（引号嵌套）

"minimax": { "apiKey": "sk-xxx", "groupId": " 1234567890 " } ❌（首尾空格）

方法二：HermesAgent 用户检查 .env

确保同时设置了两行环境变量：

MINIMAX_API_KEY=sk-xxx

MINIMAX_GROUP_ID=1234567890

注意：这两行缺一不可，且不能写成 MINIMAX_GROUP_ID="1234567890" —— Shell 环境下引号会被当作字面量传入，导致实际值带引号。

验证 GroupID 是否与 API Key 匹配

先进入 MiniMax 控制台的「API 密钥」页面，找到当前正在使用的那把密钥，点一下「查看」，重点核对它所属的组织，是否与在「组织管理」中复制出来的 GroupID 完全一致。这里很容易出问题：如果创建密钥时选错了组织，或者这把密钥后来被管理员移出了当前组织，那么即便填入的 GroupID 本身没错，权限对不上，最终也还是会被静默拒绝。

此时需重新创建一个 API Key，并在创建弹窗中明确选择目标组织——这一步不能跳过，旧密钥无法更换归属组织。

最后一步，可以直接在终端里检查一下环境变量有没有真正生效：Linux/macOS 执行 echo $MINIMAX_GROUP_ID，Windows CMD 执行 echo %MINIMAX_GROUP_ID%。如果终端没有输出任何内容，通常就说明这个变量还没被正确加载。这时候需要回头检查一下 .bashrc 或 .zshrc 是否已经正确 source，同时也别忽略一个常见细节：前面是否漏写了 export 前缀。