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）则不一样，

，少了这个参数，通常就会直接返回 401 或 1004 错误。

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

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

（一串数字或以 grp- 开头的字符串），不是 Account ID。

检查配置文件中 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，并在创建弹窗中明确选择目标组织——这一步不能跳过，旧密钥无法更换归属组织。

最后，在终端执行 echo $MINIMAX_GROUP_ID（Linux/macOS）或 echo %MINIMAX_GROUP_ID%（Windows CMD）验证环境变量是否生效。未输出任何内容，说明变量未加载，需检查 .bashrc 或 .zshrc 是否正确 source，或是否漏掉 export 前缀。