groupid无效需按三步排查：先确认接口版本（v1需url传groupid，v2禁用）；再验证group id真实性（控制台组织管理中纯数字id，注意国内外平台隔离）；最后检查配置写法与代理透传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent调用时提示GroupID无效，说明请求中携带的组织标识未被服务端识别或未与API Key绑定，常见于旧版接口配置错误、跨版本混用或控制台权限未同步。
确认当前使用的接口版本
第一步：打开你正在调用的API文档页面，核对完整endpoint路径。若路径含/v1/text/chatcompletion或?GroupId=字样，属于旧版v1接口；若为/v1/chat/completions或/v1/text/chatcompletion_v2，则为新版v2兼容接口。
第二步：登录platform.minimaxi.com控制台 →「模型广场」→ 查看所用模型（如M2.7、abab-video-1）右侧标注的接口类型。新版v2接口【不再接受URL中拼接GroupId】，旧版v1接口则【必须将GroupId作为query参数传入】，二者不可交叉使用。
第三步：检查代码中是否同时设置了groupId字段和URL query参数。新版SDK若仍传groupId，会触发401；旧版curl若漏掉?GroupId=xxx，则直接返回invalid group_id。
验证Group ID本身是否真实有效
方法一：在控制台「账户中心」→「组织管理」中查看当前组织ID。该ID是一串纯数字，不是字符串，不带引号、空格或字母前缀。复制时务必全选，避免漏掉末尾数字。
方法二：在「API密钥」页面，找到对应密钥的「所属组织」列，确认显示的组织名称与你期望调用的Agent所属组织完全一致。若显示“未归属”，说明该Key未被分配至任何组织，需重新生成或联系管理员分配。
注意：国内版平台（minimaxi.com）与国际版（minimax.chat）的Group ID体系完全隔离，【从minimax.chat获取的Key绝不能搭配minimaxi.com的Group ID使用】。
检查配置文件中Group ID的写法
打开openclaw.json或.env等配置文件，定位minimax节点下的groupId字段：
为 AI 代理注册和管理 ICANN 域名，支持钱包认证（SIWE/SIWS），可在 Base 或 Solana 上使用 USDC 支付，提供完整 DNS 管理。
✅ 正确示例（旧版v1）："groupId": "123456789" —— 纯数字字符串，无引号外包裹、无空格、无换行。
❌ 常见错误："groupId": " 123456789 "（首尾空格）、"groupId": "'123456789'"（单引号）、"groupId": 123456789（无引号，JSON解析为number类型，部分SDK会丢弃高位数字）。
若使用Python dotenv方式加载，确保.env中写为MINIMAX_GROUP_ID=123456789，而非MINIMAX_GROUP_ID="123456789" —— 引号会被当作值的一部分传入。
排查代理或网关导致的参数丢失
如果你通过Nginx、Clawdbot网关或自建代理转发请求，请检查中间层是否过滤或重写了URL query参数。特别是当原始请求为https://api.minimaxi.com/v1/text/chatcompletion?GroupId=123456789时，某些网关默认剥离未知query参数。
验证方法：绕过所有中间层，用curl直连：
curl -X POST "https://api.minimaxi.com/v1/text/chatcompletion?GroupId=123456789" \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model":"abab6.5-chat","messages":[{"role":"user","content":"test"}]}'
若直连成功而网关失败，问题一定出在代理配置上，需检查其query参数透传规则。
