GroupID填错会导致401或1004错误，需通过响应体base_resp字段关键词、控制台组织管理页面核对、排查配置文件/环境变量/代码fallback三种方式定位并修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent 调用时 GroupID 填错会导致 401 或 1004 错误，且错误提示会误导你去检查 API Key，实际问题却卡在组织归属上。
先确认是不是 GroupID 填错了
调用返回 {"status_code":1004,"status_msg":"Authentication failed"} 时，不要立刻重生成 Key。打开响应体里的 base_resp 字段，看里面有没有 group_id_mismatch 或 invalid_group_id 这类关键词——有就基本坐实是 GroupID 问题。
没有关键词？继续查：登录 platform.minimax.chat 控制台 → 「账户中心」→ 「组织管理」，页面顶部显示的数字就是你当前组织的 GroupID，把它和代码里填的逐字符比对，注意前后空格、全角/半角数字、引号包裹等细节。
GroupID 填错的三种典型场景及修复
方法一：配置文件中写死了旧 GroupID
打开 openclaw.json 或你的 SDK 初始化配置文件，定位到 minimax.groupId 字段。如果值是硬编码的数字（比如 "123456789"），而控制台显示的是 987654321，直接替换。⚠️不要加引号以外的任何符号，包括中文顿号、空格、换行符。
方法二：环境变量覆盖了正确值
执行 echo $MINIMAX_GROUP_ID 查看当前生效的环境变量。如果输出非空且与控制台不一致，说明环境变量优先级更高。临时修复：运行 unset MINIMAX_GROUP_ID；永久修复：删掉 ~/.bashrc 或 ~/.zshrc 里那行 export MINIMAX_GROUP_ID="xxx"，然后 source ~/.bashrc。
方法三：代码里动态拼接出错
检查是否用了类似 os.getenv("GROUP_ID") or "fallback_123" 的逻辑。fallback 值往往是测试时随手写的，上线后没删。把 fallback 部分删掉，强制走环境变量或配置文件读取，避免兜底逻辑掩盖真实错误。
验证修复是否成功
第一步：用 curl 手动发一个最简请求
复制控制台里「API 密钥」页显示的 Key 和 GroupID，执行：
curl -X POST "https://api.minimax.chat/v1/text/chatcompletion?GroupId=【你的GroupID】" \
-H "Authorization: Bearer 【你的APIKey】" \
-H "Content-Type: application/json" \
-d '{"model": "abab6.5s-chat", "messages": [{"role": "user", "content": "hi"}]}'
第二步：观察返回状态码。如果从 401 变成 200 或 400（model_not_found），说明 GroupID 已通过认证；如果还是 401，说明环境变量或代码层仍有隐藏覆盖点，回到方法二重新排查。
