必须将minimax agent的group id配置为与api key绑定的组织权限完全匹配的32位十六进制字符串,否则触发401或1004错误;需通过开发者控制台复制、写入.env文件(推荐)或config.yaml(仅测试),并用openclaw网关状态页及curl响应验证其一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地开发环境中正确配置MiniMax Agent的Group ID,必须确保它与API Key绑定的组织权限完全匹配,否则调用会直接返回401错误或1004鉴权失败。
确认Group ID来源与有效性
登录 Minimax开发者控制台 → 进入「应用管理」→ 找到已创建的应用 → 复制右侧显示的Group ID。这个ID是平台自动生成的32位十六进制字符串,【不可手写、不可截断、不可与其他应用混用】。
注意:新版v2接口(/v1/chat/completions)已不再将Group ID作为URL参数传递,但它仍用于后台权限校验——若你在.env中填错,OpenClaw或M2.5 CLI在初始化时就会报错“Invalid group context”,且不提示具体哪一字段出错。
注入Group ID到本地配置体系
方法一:通过.env文件注入(推荐)
在项目根目录下新建或编辑.env文件,写入:
ASSIST_GROUP_ID=your_actual_group_id_here
ASSIST_API_KEY=your_actual_api_key_here
ASSIST_BASE_URL=https://api.minimax.chat/v1/
ASSIST_MODEL=abab7.5s-chat
这一步操作起来很简单,直接把文件拖进去就行。但必须确保.env文件位于执行命令的当前工作目录下,否则uv或Python加载环境变量时会静默忽略。
方法二:硬编码进config.yaml(仅限测试)
打开config.yaml,定位到model_provider区块,在credentials下添加:
group_id: "8a1b2c3d4e5f678901234567890abcde"
【生产环境严禁此法】——密钥类信息一旦提交Git,可能被泄露;且无法实现多环境(dev/staging/prod)差异化配置。
验证Group ID是否生效
第一步:启动OpenClaw调试网关
执行openclaw gateway,等待终端输出“Gateway server listening on http://localhost:8080”。
第二步:访问网页控制台 → 点击左上角「模型状态」→ 查看「Provider: minimax」条目下的「Group ID」字段值。
第三步:若显示为“N/A”或空字符串,说明.env未被读取或格式有误(常见坑:等号前后有空格、引号包裹了group_id值、文件编码为UTF-8 with BOM)。
第四步:手动发起一次curl测试请求:
curl -X POST "https://api.minimax.chat/v1/chat/completions" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"model":"abab7.5s-chat","messages":[{"role":"user","content":"hi"}]}'
成功响应体中会包含"group_id"字段,其值必须与你复制的完全一致——这是唯一权威验证方式。











