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」的字段即为目标值，它是一串【16位十六进制字符串】，例如 8a3f5c2e1d9b470a。复制时务必全选，避免前后多出空格。

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

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

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

方法一：查控制台「Agent」模块创建页底部小字说明——若提示“使用 OpenAI 兼容接口”，则属于 v2，【Group ID 已绑定至 API Key，不可也不需重复传】。

方法二：看你在代码中调用的 endpoint 路径：

→ 如果是 /v1/chat/completions 或 /v1/text/chatcompletion_v2，不传 Group ID；

→ 如果是 /v1/text/chatcompletion?GroupId=xxx，就必须传。

在 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 不匹配或未开通服务。