MiniMax OAuth
AigenLabs Agent 通过基于浏览器的 OAuth 登录流程支持 MiniMax，使用与 MiniMax 门户 相同的凭据。无需 API 密钥或信用卡——登录一次，AigenLabs 即可自动刷新您的会话。
该传输层复用了 anthropic_messages 适配器（MiniMax 在 /anthropic 路径暴露了一个兼容 Anthropic Messages 的端点），因此所有现有的工具调用、流式传输和上下文功能无需任何适配器改动即可正常使用。
概览
| 项目 | 值 |
|---|---|
| Provider ID | minimax-oauth |
| 显示名称 | MiniMax (OAuth) |
| 认证类型 | 浏览器 OAuth（PKCE 设备码流程） |
| 传输层 | 兼容 Anthropic Messages（anthropic_messages） |
| 模型 | MiniMax-M2.7、MiniMax-M2.7-highspeed |
| 全球端点 | https://api.minimax.io/anthropic |
| 中国端点 | https://api.minimaxi.com/anthropic |
| 需要环境变量 | 否（MINIMAX_API_KEY 不用于此 provider） |
前提条件
- Python 3.9+
- 已安装 AigenLabs Agent
- 在 minimax.io（全球）或 minimaxi.com（中国）注册的 MiniMax 账户
- 本地机器上可用的浏览器（远程会话请使用
--no-browser）
快速开始
# 启动 provider 和模型选择器
aigenlabs model
# → 从 provider 列表中选择 "MiniMax (OAuth)"
# → AigenLabs 在浏览器中打开 MiniMax 授权页面
# → 在浏览器中批准访问
# → 选择模型（MiniMax-M2.7 或 MiniMax-M2.7-highspeed）
# → 开始对话
aigenlabs
首次登录后，凭据将存储在 ~/.aigenlabs/auth.json 下，并在每次会话前自动刷新。
手动登录
您可以在不经过模型选择器的情况下触发登录：
aigenlabs auth add minimax-oauth
中国区域
如果您的账户在中国平台（minimaxi.com），请改用中国区域 OAuth provider id minimax-cn，或跳过 OAuth 直接配置 MINIMAX_CN_API_KEY / MINIMAX_CN_BASE_URL。旧版文档中描述的 --region cn 标志未接入 CLI 的参数解析器；请改用 minimax-cn provider：
aigenlabs auth add minimax-cn --type oauth # 如果您的中国账户支持 OAuth
# 或更简单的方式：
echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.aigenlabs/.env
远程/无头会话
在没有浏览器的服务器或容器上：
aigenlabs auth add minimax-oauth --no-browser
AigenLabs 将打印验证 URL 和用户码——在任意设备上打开该 URL，并在提示时输入用户码。
OAuth 流程
AigenLabs 针对 MiniMax OAuth 端点实现了 PKCE 设备码流程：
- AigenLabs 生成 PKCE verifier/challenge 对和一个随机 state 值。
- 携带 challenge 向
{base_url}/oauth/code发送 POST 请求，获取user_code和verification_uri。 - 浏览器打开
verification_uri。如有提示，输入user_code。 - AigenLabs 轮询
{base_url}/oauth/token，直到令牌到达（或超过截止时间）。 - 令牌（
access_token、refresh_token、过期时间）以minimax-oauth为键保存到~/.aigenlabs/auth.json。
令牌刷新（标准 OAuth refresh_token 授权）在每次会话启动时自动执行，当 access token 距过期不足 60 秒时触发。
检查登录状态
aigenlabs doctor
◆ Auth Providers 部分将显示：
✓ MiniMax OAuth (logged in, region=global)
或者，如果未登录：
⚠ MiniMax OAuth (not logged in)
切换模型
aigenlabs model
# → 选择 "MiniMax (OAuth)"
# → 从模型列表中选择
或直接设置模型：
aigenlabs config set model MiniMax-M2.7
aigenlabs config set provider minimax-oauth
配置参考
登录后，~/.aigenlabs/config.yaml 将包含类似如下的条目：
model:
default: MiniMax-M2.7
provider: minimax-oauth
base_url: https://api.minimax.io/anthropic
区域端点
| Provider id | 门户 | 推理端点 |
|---|---|---|
minimax-oauth（全球） | https://api.minimax.io | https://api.minimax.io/anthropic |
minimax-cn（中国） | https://api.minimaxi.com | https://api.minimaxi.com/anthropic |
Provider 别名
以下所有别名均解析为 minimax-oauth：
aigenlabs --provider minimax-oauth # 规范名称
aigenlabs --provider minimax-portal # 别名
aigenlabs --provider minimax-global # 别名
aigenlabs --provider minimax_oauth # 别名（下划线形式）
环境变量
minimax-oauth provider 不使用 MINIMAX_API_KEY 或 MINIMAX_BASE_URL。这些变量仅用于基于 API 密钥的 minimax 和 minimax-cn provider。
| 变量 | 作用 |
|---|---|
MINIMAX_API_KEY | 仅用于 minimax provider——对 minimax-oauth 无效 |
MINIMAX_CN_API_KEY | 仅用于 minimax-cn provider——对 minimax-oauth 无效 |
要将 minimax-oauth 设为活跃 provider，请在 config.yaml 中设置 model.provider: minimax-oauth（使用 aigenlabs setup 进行引导式配置），或在单次调用时传入 --provider minimax-oauth：
aigenlabs --provider minimax-oauth
模型
| 模型 | 最适合 |
|---|---|
MiniMax-M2.7 | 长上下文推理、复杂工具调用 |
MiniMax-M2.7-highspeed | 低延迟、轻量任务、辅助调用 |
两个模型均支持最多 200,000 个 token 的上下文。
当 minimax-oauth 为主 provider 时，MiniMax-M2.7-highspeed 也会自动用作视觉和委托任务的辅助模型。
故障排查
令牌已过期——未自动重新登录
AigenLabs 在每次会话启动时，若 access token 距过期不足 60 秒则刷新令牌。如果 access token 已经过期（例如长时间离线后），刷新将在下一次请求时自动触发。如果刷新失败并返回 refresh_token_reused 或 invalid_grant，AigenLabs 会将会话标记为需要重新登录。
当刷新失败为终态（HTTP 4xx、invalid_grant、授权已撤销等）时，AigenLabs 将 refresh token 标记为失效并在本地隔离，避免持续重放注定失败的交换。Agent 会显示一条"需要重新认证"的消息，并在您再次登录之前保持等待。
解决方法： 再次运行 aigenlabs auth add minimax-oauth 以开始全新登录。下一次成功交换后隔离状态将自动清除。
授权超时
设备码流程有有限的过期窗口。如果您未在规定时间内批准登录，AigenLabs 将抛出超时错误。
解决方法： 重新运行 aigenlabs auth add minimax-oauth（或 aigenlabs model）。流程将重新开始。
State 不匹配（可能的 CSRF）
AigenLabs 检测到授权服务器返回的 state 值与其发送的值不匹配。
解决方法： 重新运行登录。如果问题持续，请检查是否有代理或重定向正在修改 OAuth 响应。
从远程服务器登录
如果 aigenlabs 无法打开浏览器窗口，请使用 --no-browser：
aigenlabs auth add minimax-oauth --no-browser
AigenLabs 将打印 URL 和用户码。在任意设备上打开该 URL 并在那里完成流程。
运行时出现"未登录 MiniMax OAuth"错误
auth 存储中没有 minimax-oauth 的凭据。您尚未登录，或凭据文件已被删除。
解决方法： 运行 aigenlabs model 并选择 MiniMax (OAuth)，或运行 aigenlabs auth add minimax-oauth。
退出登录
要移除已存储的 MiniMax OAuth 凭据：
aigenlabs auth remove minimax-oauth