MiniMax Agent GroupID配置流程

开始配置前，先把接口版本核实清楚，再去处理GroupID。顺序一旦反了，鉴权大概率会直接失败，返回401。GroupID本身是一个16位十六进制字符串，需要到platform.minimax.io的账户中心→组织管理里查看；如果账号还没完成实名认证，这项信息是看不到的。接口层面也别混用：v2接口不需要额外传这个参数，v1接口则必须把它拼到query中。放到OpenClaw里时，建议通过.env和config.yaml注入，别把它明文硬编码进代码。最后做验证时，记得请求旧版路径，并确认返回里的code是否为0。

要在 MiniMax Agent 中正确配置 GroupID，必须先确认当前使用的接口版本，否则请求会因鉴权失败直接返回 401 错误，而你很可能误以为是 API Key 输错了。

获取 Group ID 的准确路径

登录 platform.minimax.io（不是 minimaxi.com 或 chat.minimax.cn），进入控制台后点击左上角头像 →「账户中心」→「组织管理」。

页面中明确标注为「Group ID」或「Account ID」的字段即为目标值，它是一串

若该页面未显示 Group ID，请检查是否已完成实名认证——未实名用户无法查看组织信息，系统会隐藏该字段。

确认接口版本与 Group ID 是否需要传参

新版 v2 接口（OpenAI 兼容路径）无需在 URL 或请求体中传 Group ID；旧版 v1 接口必须将 Group ID 拼在 query 参数里。

方法一：查控制台「Agent」模块创建页底部小字说明——若提示“使用 OpenAI 兼容接口”，则属于 v2，

方法二，其实直接看代码里调用的 endpoint 路径就行：
→ 如果用的是 /v1/chat/completions 或 /v1/text/chatcompletion_v2，那就不用传 Group ID；
→ 如果用的是 /v1/text/chatcompletion?GroupId=xxx，那 Group ID 就必须带上。

在 OpenClaw 中注入 Group ID 的标准操作

第一步：在项目根目录新建 .env 文件，写入以下两行：

ASSIST_GROUP_ID=8a3f5c2e1d9b470a
ASSIST_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

第二步：编辑 config.yaml，定位到 model_provider 区块，确保包含：

type: minimax
group_id: ${ASSIST_GROUP_ID}
api_key: ${ASSIST_API_KEY}

第三步：启动前执行 source .env（Linux/macOS）或 set -a; source .env; set +a（Zsh），Windows 用户请改用 setx 命令或 PowerShell 的 $env: 方式加载变量。

注意：不要在 YAML 里硬写明文 Group ID，环境变量方式可防止泄露，且适配 CI/CD 流程。

验证 Group ID 是否生效

发起一次最简请求，URL 为 https://api.minimax.chat/v1/text/chatcompletion（旧版路径）。

Header 设置：Authorization: Bearer sk-xxx，Body 中加入 "group_id": "8a3f5c2e1d9b470a" 字段。

如果返回 {"code":0,"message":"success"}，说明 Group ID 正确且已启用对应模型权限；若返回 1004，代表该 Group ID 与 API Key 不匹配或未开通服务。