MiniMax Agent 报 GroupID 为空错误，因旧版接口（如 /v1/text/chatcompletion）必须传 GroupID，而新版 v2 接口（如 /v1/chat/completions）虽不强制但需 API Key 绑定有效组织；应检查 endpoint 路径、控制台组织 ID、配置文件或环境变量中 GroupID 格式及匹配性，并验证环境变量是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent 运行时报错提示 GroupID 为空，说明当前配置中缺失组织标识，服务端无法将请求归属到具体账户，直接拒绝鉴权。这种情况在 OpenClaw、HermesAgent 或自定义 SDK 集成中高频出现，尤其当开发者误以为新版接口无需 GroupID 而删掉了该字段时。
确认当前使用的是旧版还是新版接口
新版 v2 接口（如 /v1/chat/completions）确实不再要求传 GroupID，但前提是你的 API Key 已在 MiniMax 控制台绑定到某个组织且该组织已开通对应模型权限；而旧版 v1 接口（如 /v1/text/chatcompletion）【必须携带 GroupID】，否则返回 401 或 1004 错误。
第一步：打开你正在调用的 endpoint URL，看路径里是否含 ?GroupId= 或 /v1/text/ 字样——有则为旧版，必须配 GroupID；若为 /v1/chat/completions 且无 query 参数，则走新版，GroupID 可不填但需确保 Key 绑定有效组织。
第二步：登录 platform.minimax.chat →「账户中心」→「组织管理」，复制页面显示的 Group ID（一串数字或以 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 " } ❌（首尾空格）
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...
方法二：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 前缀。
