MiniMax Agent GroupID更换后必须同步更新所有硬编码Group ID，否则触发401或1039错误；新Group ID需从platform.minimax.chat「组织管理」页面复制grp-开头的26位值，替换配置中groupId字段，并按v2接口删除URL参数、v1接口保留准确传参，严禁混用路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent GroupID更换后，原有配置中所有硬编码的Group ID必须同步更新，否则调用会直接返回401错误且不提示具体原因；旧配置若混用新旧接口路径，还会触发1039 model_not_found报错。
确认新Group ID来源
登录 platform.minimax.chat → 进入「账户中心」→「组织管理」页面，找到当前生效的组织（Organization），复制其 【Group ID】 字段值——注意不是 Account ID 或 User ID，该字段以 grp- 开头，共26位字符，复制时务必全选，避免前后空格。
如果页面显示多个组织，请点击右侧「切换」按钮确认当前操作上下文为你要对接的Agent所属组织，否则复制的Group ID将无法通过鉴权。
定位并替换全部Group ID引用位置
第一步：全局搜索项目中所有含 groupId、group_id、GroupId 的文件，重点关注以下三类配置源：
• openclaw.json 中 "providers":{...} 段内的 "groupId" 字段
• oh-my-openagent.json（非 oh-my-opencode.json）中可能存在的 provider-level group_id 声明
• 自研服务代码中构造请求 URL 时拼接的 ?GroupId=xxx query 参数（仅旧版 v1 接口需要）
第二步：逐个打开匹配文件，将旧 Group ID 替换为新值。特别注意 JSON 文件末尾是否有多余逗号，替换后 JSON 格式必须合法，否则 openclaw 启动时会静默失败。
解决常见 OpenClaw 工作流瓶颈：平台 engage‑gates/429 回退辅助（始于 MoltX），标准化 JSON 结果封装用于脚本链式，工作区路径解析辅助，以及简易技能发布指挥（准备/发布/草稿公告）。
区分接口版本决定是否保留Group ID
方法一：新版 v2 兼容接口（推荐）
endpoint 路径为 /v1/chat/completions，此时 【必须删除 URL 中所有 GroupId query 参数】，且配置文件中 "groupId" 字段可完全移除或留空；Bearer Token 已绑定组织权限，传 GroupId 反而可能触发校验冲突。
方法二：旧版 v1 接口（仅限遗留系统）
endpoint 路径仍为 /v1/text/chatcompletion?GroupId=xxx，此时需确保 URL 中的 GroupId 与新值一致，且配置文件中 "groupId" 字段必须存在且准确；漏传或传错将返回 401，而非 400。
注意：同一项目中严禁混用新旧路径与 GroupId 传参方式，否则请求会被网关拦截并返回 status_code: 1004。
验证配置生效
执行 openclaw status 查看当前加载的 provider 配置，确认 groupId 字段已更新或消失（v2 接口下应无该字段）。
发起一次最小化测试调用：openclaw chat --model MiniMax-M2.7 --provider minimax "你好"，观察返回状态码与 response body 中的 status_msg 字段——成功返回应含 "choices":[...] 结构，而非 status_code:1004 或 1039。
