必须在初始化时正确配置group id,否则返回401错误;其获取路径为控制台「账户中心」→「组织管理」中16位十六进制字符串;支持环境变量、硬编码(仅调试)、openclaw配置三种方式,需严格区分api key与group id。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 MiniMax Agent 项目中正确接入并使用 GroupID,必须确保凭证在初始化时被识别且不被遗漏,否则调用会直接返回 401 错误而非参数缺失提示。
确认 Group ID 获取路径
登录 https://agent.minimaxi.com 或 https://platform.minimax.chat(以当前控制台实际跳转为准),进入「账户中心」→「组织管理」,找到字段名为 Group ID 或 Account ID 的十六进制字符串(长度为16位),全选复制。注意:该 ID 不是 API Key,二者不可混淆。
若页面未显示 Group ID,请检查是否已完成企业实名认证或 Coding Plan 套餐开通——未完成时该字段可能隐藏或为空。
Agent 项目中配置 Group ID 的三种方式
方法一:环境变量注入(推荐)
在项目根目录创建 .env 文件,写入:
MINIMAX_GROUP_ID=your_16_digit_hex_group_id
MINIMAX_API_KEY=your_api_key_here
Python 中通过 from dotenv import load_dotenv; load_dotenv() 加载,后续构造请求时自动读取。
方法二:硬编码传参(仅限本地调试)
初始化客户端时显式传入:client = MinimaxClient(api_key="xxx", group_id="yyy")
【注意】此方式严禁提交至 Git 或部署到生产环境,Key 和 Group ID 泄露将导致账户被盗用与配额耗尽。
方法三:OpenClaw 等工具链专用配置
编辑 ~/.openclaw/config.json,在 minimax provider 节点下添加:"groupId": "your_group_id"
该字段必须与 apiKey 同级,且不能拼错键名——大小写敏感,少一个字母就会静默失效。
验证 Group ID 是否生效
第一步:发起一次最小化请求
POST https://api.minimax.chat/v1/chat/completions,body 中仅含:{"model":"abab6.5s","messages":[{"role":"user","content":"hi"}]}
第二步:检查响应头与状态码
若返回 401 Unauthorized,说明 Group ID 未被识别或未传入——此时请回查环境变量是否加载成功、config.json 是否格式合法、API Key 是否已绑定该 Group。
第三步:确认成功响应结构
正常返回应包含 choices[0].message.content 字段,且响应头中 X-Group-ID 值与你复制的 Group ID 完全一致(含大小写与字符数)。











