编辑文档 - Hermes Agent × MiniMax M3：免 API Key 接入 + 自改进学习实操指南（2025）

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

## 为什么用 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（推荐）

一行命令搞定所有依赖：

```bash
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）：

```powershell
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 指南](https://hermes-agent.nousresearch.com/docs/getting-started/termux)。

### 安装后验证

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

---

## 二、接入 MiniMax 的两种方式

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

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

**Step 1：运行模型选择器**

```bash
hermes model
```

**Step 2：从模型列表中选择**

在列表中找到并选择：
```
minimax-portal/MiniMax-M3
```

或通过 Token Plan 方式：

```
minimax-portal (MiniMax Token Plan)
```

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

**Step 3：开始使用**

```bash
hermes
```

直接在 CLI 中与 MiniMax M3 对话。

---

### 方式二：手动配置 API Key

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

**Step 1：获取 MiniMax API Key**

1. 访问 [platform.minimaxi.com](https://platform.minimaxi.com) → API Key 管理
2. 创建新 Key 并保存

**Step 2：配置环境变量**

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

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

```bash
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：运行模型选择器**

```bash
hermes model
```

选择 `minimax-portal/MiniMax-M3`。

**Step 4：测试**

```bash
hermes
```

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

---

## 三、完整使用流程演示

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

```bash
# 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：

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

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

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

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

---

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

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

### 配置多个 Provider

```bash
hermes model
```

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

### 在对话中切换

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

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

---

## 五、CLI 常用命令速查

| 命令 | 说明 |
|------|------|
| `hermes` | 启动交互式 CLI |
| `hermes model` | 打开模型选择器 |
| `hermes tools` | 配置启用的工具 |
| `hermes config set <key> <value>` | 设置配置项 |
| `hermes setup` | 运行完整设置向导 |
| `hermes setup --portal` | 一键配置 Nous Portal |
| `hermes gateway` | 启动消息网关（Telegram、Discord 等） |
| `hermes update` | 更新到最新版本 |
| `hermes doctor` | 诊断问题 |
| `hermes --help` | 查看帮助 |

---

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

### 1. 跨平台消息网关

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

```bash
hermes gateway
```

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

### 2. 定时任务（Cron）

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

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

### 3. 子 Agent 并行

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

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

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

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

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

---

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

| 对比项 | MiniMax Token Plan | MiniMax API |
|--------|-------------------|-------------|
| API Key | 不需要 | 需要 |
| 费用 | 订阅制（月/年） | 按量付费 |
| 支持的工具 | Hermes 内置支持 | 需手动配置 |
| 额度 | 订阅内固定 | 用多少付多少 |
| 适合场景 | 长期稳定使用 | 灵活、偶尔使用 |

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

---

## 八、常见问题

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

**解决方法**：
```bash
source ~/.bashrc
# 或者重新打开终端
```

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

**解决方法**：确认 Hermes Agent 是最新版本：
```bash
hermes update
```

### Q3：Token Plan 选择后无法响应

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

### Q4：Windows 上安装失败

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

### Q5：如何卸载？

```bash
# Linux/macOS
rm -rf ~/.hermes

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

---

## 九、MiniMax M3 适合 Hermes 的场景

| 场景 | 为什么适合 |
|------|------------|
| 大型代码库分析 | 1M 上下文让 M3 一次性看完整个项目 |
| 跨会话记忆 | Hermes 记忆 + M3 大上下文 = 越来越懂你的项目 |
| 并行多 Agent 任务 | M3 速度快（100 TPS），并行效率高 |
| 定时自动任务 | M3 便宜，24 小时运行的 Agent 成本低 |
| 多模态任务（截图+代码）| M3 原生多模态，Hermes 可以截图丢给 M3 分析 |

---

## 总结

| 步骤 | 操作 |
|------|------|
| 1 | 安装 Hermes（curl 一键 / PowerShell） |
| 2 | `hermes model` 打开模型选择器 |
| 3 | 选 `minimax-portal/MiniMax-M3`（Token Plan）或手动填 API |
| 4 | `hermes` 启动，开始对话 |
| 5 | 可选：连接 Telegram/Discord，开启定时任务 |

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

摘要

标签多个标签用逗号分隔

分类