在人工智能内容学习中，MiniMax_Agent_GroupID更换后的配置修改清单是常见主题。很多人在阅读时会遇到概念分散、步骤不清和注意点难以归纳的问题。本文按照基础概念、操作流程和关键细节，对相关内容进行整理。

MiniMax Agent GroupID更换后必须同步更新所有硬编码Group ID，否则触发401或1039错误；新Group ID需从platform.minimax.chat「组织管理」页面复制grp-开头的26位值，替换配置中groupId字段，并按v2接口删除URL参数、v1接口保留准确传参，严禁混用路径。

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 启动时会静默失败。

区分接口版本决定是否保留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。