实战：MiniMax OAuth 接入

这篇教程将手把手教你如何用浏览器登录的方式，免费接入 MiniMax 大模型，全程不需要 API Key 和信用卡。

---

为什么选 OAuth 登录？

想象一下，以前用 API Key 就像拿着把备用钥匙，得小心保管、定期更换；而 OAuth 登录就像刷脸进门——你在浏览器里授权一次，Hermes 会自动帮你“续门禁卡”，省心又安全。

MiniMax 官方还贴心地提供了全球版（minimax.io）和中国版（minimaxi.com）两个入口，本篇主要讲全球版，中国版用户文末有特别说明。

---

第 1 步：确认环境

• 已安装 Hermes Agent（Python 3.9+）
• 有一个 MiniMax 账号（去官网免费注册）
• 本地电脑有浏览器（服务器用户请看第 5 步）

第 2 步：启动并登录

打开终端，输入：

hermes model

在提供商列表里选择 MiniMax (OAuth)，Hermes 会自动弹出浏览器窗口，跳到 MiniMax 授权页面。点击“同意”后，回到终端，选择模型（推荐 MiniMax-M2.7），就可以开始聊天了！

登录信息会安全地保存在 ~/.hermes/auth.json，下次启动自动续期，无需重复登录。

第 3 步：手动登录（可选）

如果只想登录、不急着选模型，可以单独执行：

hermes auth add minimax-oauth

第 4 步：检查登录状态

hermes doctor

看到 ✓ MiniMax OAuth (logged in) 就说明一切正常。

第 5 步：远程服务器 / 无浏览器环境

在服务器上登录，加个参数就行：

hermes auth add minimax-oauth --no-browser

终端会显示一个网址和验证码，在你自己电脑的浏览器打开网址、输入验证码，就能完成远程授权。

第 6 步：切换模型（随时可换）

hermes model

或者直接指定：

hermes config set model.default MiniMax-M2.7
hermes config set model.provider minimax-oauth

---

中国版用户特别说明

如果你的账号在中国版平台（minimaxi.com），请改用 API Key 方式：

echo 'MINIMAX_CN_API_KEY=你的密钥' >> ~/.hermes/.env

---

常见问题速查

问题	解决办法
授权超时	重新运行 hermes auth add minimax-oauth
提示重新登录	同上，重新授权即可
登录状态丢失	运行 hermes model 重新选一次
想退出登录	hermes auth logout minimax-oauth

---

小结

用 OAuth 登录 MiniMax，零配置、免密钥、自动续期，体验非常顺滑。而且 MiniMax-M2.7 支持 20 万 token 上下文，复杂任务也能轻松应对。

下篇预告：我们将实战另一个主流大模型——通义千问（Qwen）的接入，看看阿里系模型在 Hermes 里表现如何，敬请期待！