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

必须正确设置纯数字格式的Group ID环境变量，否则旧版MiniMax接口将返回401错误；Group ID需从platform.minimax.chat账户中心→组织管理中获取，Linux/macOS通过shell配置文件设置，Windows可通过图形界面或PowerShell设置。

你需要在本地开发环境中正确设置 MiniMax Agent 所需的 GroupID，否则调用旧版接口时会返回 401 错误而非明确的参数缺失提示。

确认 GroupID 获取路径

登录 platform.minimax.chat → 左侧菜单进入「账户中心」→「组织管理」→ 找到「Group ID」字段（一串纯数字，非字符串格式）→ 复制保存。注意：该 ID 在控制台中不叫 Account ID，也不叫 Organization ID，仅显示为 Group ID。

【Group ID 是旧版接口必需参数，且必须为纯数字，填错或填成字符串会导致 401 认证失败】

Linux/macOS 环境变量配置

打开终端，执行以下命令写入 shell 配置文件：

若使用 zsh（macOS 默认）：echo 'export MINIMAX_GROUP_ID=你的GroupID数字' >> ~/.zshrc && source ~/.zshrc

若使用 bash：echo 'export MINIMAX_GROUP_ID=你的GroupID数字' >> ~/.bashrc && source ~/.bashrc

这一步操作起来很简单，直接把上面那行命令里的“你的GroupID数字”替换成你复制的实际数字即可。

Windows 环境变量配置

方法一：图形界面设置

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 在「系统变量」区域点击「新建」→ 变量名填 MINIMAX_GROUP_ID → 变量值填你复制的纯数字 Group ID → 点击确定。

方法二：PowerShell 一次性设置（仅当前会话有效）

$env:MINIMAX_GROUP_ID="123456789"（把 123456789 换成你的真实 Group ID）

注意：PowerShell 方式设置的变量不会持久化，关闭窗口即失效，仅适合临时调试。

验证环境变量是否生效

第一步：打开新终端（Windows 请重新启动 PowerShell 或 CMD，macOS/Linux 请新开一个 Terminal）

第二步：执行命令检查变量值

Linux/macOS：echo $MINIMAX_GROUP_ID

Windows（CMD）：echo %MINIMAX_GROUP_ID%

Windows（PowerShell）：$env:MINIMAX_GROUP_ID

第三步：确认输出为你复制的纯数字 Group ID，且无空格、引号、字母或其他符号。