为什么用 Hermes + MiniMax M3？

这个组合有三个特别适合的场景：

1. 想要 1M 上下文的 Agent 体验

MiniMax M3 提供 1M tokens 上下文，Hermes Agent 可以把整个代码库、甚至多个项目一起丢给 M3 分析，不用担心上下文不够而被截断。

2. 不想管理 API Key

Hermes Agent 支持 MiniMax Token Plan，订阅制，无需手动配置 API Key、base URL 等，一键切换开箱即用。

3. 自改进学习 + 大上下文 = 越用越懂你

Hermes 会持续学习项目结构和你的编码习惯，MiniMax M3 的大上下文让它能基于完整的项目上下文做越来越精准的推荐和修改。

一、安装 Hermes Agent

Linux / macOS / WSL2（推荐）

一行命令搞定所有依赖：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装脚本会自动安装：uv、Python 3.11、Node.js、ripgrep、ffmpeg 和 Git。

Windows（原生 PowerShell）

Hermes Agent 正式支持 Windows 原生运行（不需要 WSL2）：

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

安装内容与 Linux 相同，包括一个便携版 Git Bash（MinGit，~45MB，完全独立不干扰系统 Git）。

如果你更习惯 WSL2，Linux/macOS 的安装命令同样适用。

Android / Termux

参考 Termux 指南。

安装后验证

source ~/.bashrc    # 重载 shell 配置（Linux/macOS）
hermes --version    # 查看版本，确认安装成功

二、接入 MiniMax 的两种方式

方式一：MiniMax Token Plan（推荐——最简单）

Hermes Agent 内置 MiniMax Token Plan 支持，订阅后无需配置任何 API Key。

Step 1：运行模型选择器

hermes model

Step 2：从模型列表中选择

在列表中找到并选择：

minimax-portal/MiniMax-M3

或通过 Token Plan 方式：

minimax-portal (MiniMax Token Plan)

选择后，Hermes Agent 会自动使用 MiniMax M3，无需额外配置。

Step 3：开始使用

hermes

直接在 CLI 中与 MiniMax M3 对话。

方式二：手动配置 API Key

如果你用的是 MiniMax API（而非 Token Plan），按以下步骤配置：

Step 1：获取 MiniMax API Key

1. 访问 platform.minimaxi.com → API Key 管理
2. 创建新 Key 并保存

Step 2：配置环境变量

export MINIMAX_API_KEY="你的API_KEY"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的API_KEY"

写入 ~/.bashrc 或 ~/.zshrc：

echo 'export MINIMAX_API_KEY="你的API_KEY"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API_KEY"' >> ~/.bashrc
source ~/.bashrc

Step 3：运行模型选择器

hermes model

选择 minimax-portal/MiniMax-M3。

Step 4：测试

hermes

输入测试问题，验证是否正常响应。

三、完整使用流程演示

场景：在项目中启动 Hermes + MiniMax M3

# 1. 进入项目目录
cd /path/to/your/project

# 2. 启动 Hermes
hermes

# 3. 选择模型（如果首次使用）
hermes> hermes model
# 选择 minimax-portal/MiniMax-M3

# 4. 开始对话
hermes> 分析这个项目的代码结构，找出可能需要优化的部分

使用 Skills 功能（M3 的强项场景）

Hermes Agent 可以自动生成 Skills（任务模板），MiniMax M3 的 1M 上下文让它能基于完整的项目上下文生成更精准的 Skills：

hermes> 帮我创建一个「代码审查」的 Skill，要求自动检查命名规范、注释完整性、安全问题

自改进学习（M3 观察用户习惯）

hermes> 总结一下我在这项目中的编码风格偏好

M3 基于完整的会话历史（1M 上下文）可以给出准确的风格分析，Hermes 会把这个信息存入记忆，下次自动应用。

四、配置多个模型（快速切换）

Hermes 支持同时配置多个模型，通过 hermes model 随时切换：

配置多个 Provider

hermes model

在选择界面可以看到所有已配置的 Provider：
- Nous Portal（默认）
- OpenRouter（200+ 模型）
- MiniMax
- Kimi/Moonshot
- 小米 MiMo
- Hugging Face
- OpenAI
- 自定义端点

在对话中切换

hermes> /model MiniMax-M3
# 切换到 MiniMax M3

hermes> /model gpt-4o
# 切换回 GPT-4o

五、CLI 常用命令速查

六、Hermes Agent 的特色功能（配合 M3 使用）

1. 跨平台消息网关

配置好 MiniMax M3 后，可以把 Hermes 连接到 Telegram：

hermes gateway

然后在 Telegram 上和 MiniMax M3 对话，Agent 在服务器端跑任务。

2. 定时任务（Cron）

Hermes 内置 Cron 调度器，可以定时让 M3 执行任务：

hermes> 每天晚上10点帮我检查代码库是否有未提交的更改并生成报告

3. 子 Agent 并行

可以分支出多个子 Agent 并行工作，充分利用 M3 的大上下文：

hermes> 同时分析 src/api 和 src/utils 两个目录

4. 批量轨迹生成（研究用）

对于训练数据生成场景，Hermes 支持批量轨迹生成和压缩：

hermes batch --tasks ./tasks.json --model MiniMax-M3

七、MiniMax Token Plan vs API：选哪个？

推荐：如果长期使用 Hermes + MiniMax，Token Plan 更省心；如果只是临时测试或偶尔用，直接用 API 即可。

八、常见问题

Q1：安装后提示 command not found: hermes

解决方法：

source ~/.bashrc
# 或者重新打开终端

Q2：模型选择器里找不到 MiniMax

解决方法：确认 Hermes Agent 是最新版本：

hermes update

Q3：Token Plan 选择后无法响应

解决方法：检查 Token Plan 是否有效：
1. 登录 MiniMax 账户确认订阅状态
2. 尝试重新选择：hermes model → 重选 MiniMax

Q4：Windows 上安装失败

解决方法：确认 PowerShell 以管理员权限运行，或使用 WSL2。

Q5：如何卸载？

# Linux/macOS
rm -rf ~/.hermes

# Windows（PowerShell）
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\hermes"

九、MiniMax M3 适合 Hermes 的场景

总结

Hermes Agent 的自改进学习 + MiniMax M3 的 1M 上下文，这个组合在大项目、多会话、跨平台场景下特别有优势。如果你之前用过 Claude Code 但想要更强的记忆和自动化能力，或者想要一个可以在 Telegram 上随时调用的 Coding Agent，Hermes + M3 值得一试。