编辑文档 - 在 Hermes Agent 中使用 MiniMax-M3：Token Plan 一键配置指南

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

## 安装 Hermes Agent

在终端中运行一键安装命令（支持 macOS、Linux 或 Windows WSL2）：

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

安装完成后，重载 shell 配置：

```bash
source ~/.bashrc    # Linux/macOS
```

验证安装成功：

```bash
hermes --version
```

更多信息请参考 [Hermes Agent 官方文档](https://hermes-agent.nousresearch.com/docs/)。

---

## 配置 MiniMax Token Plan

Hermes Agent 内置了对 MiniMax 的支持，通过 Token Plan 接入无需手动配置 API 地址，直接订阅即可使用。

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

```bash
hermes model
```

### Step 2：选择 Provider

从 provider 列表中，选择 **"MiniMax China (mainland China endpoint)"**

> 注意：如果你在国际地区使用，可选择 "MiniMax（minimax.io）" 接口。

### Step 3：输入订阅 Key

当提示输入 API Key 时，输入从 **MiniMax Token Plan 页面**获取的订阅 Key。

获取方式：访问 [MiniMax 开放平台](https://platform.minimaxi.com) → Token Plan → 复制订阅 Key。

### Step 4：选择模型

从模型列表中，选择 **MiniMax-M3**。

### Step 5：开始使用

回到终端，进入你的项目目录，启动 Hermes：

```bash
cd /path/to/your/project
hermes
```

直接在对话中使用 MiniMax-M3。

---

## 常用命令速查

| 命令 | 说明 |
|------|------|
| `hermes` | 启动交互式 CLI |
| `hermes model` | 打开模型选择器 |
| `hermes tools` | 配置启用的工具 |
| `hermes gateway` | 启动消息网关（连接 Telegram/Discord 等） |
| `hermes update` | 更新到最新版本 |
| `hermes doctor` | 诊断连接问题 |

---

## 常见问题

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

重载 shell 配置后重试：

```bash
source ~/.bashrc
```

或重新打开终端窗口。

### Q2：找不到 "MiniMax China" Provider

确认 Hermes Agent 是最新版本：

```bash
hermes update
```

### Q3：订阅 Key 无效

确认 Token Plan 处于生效状态，登录 [MiniMax 开放平台](https://platform.minimaxi.com) 检查订阅状态。

### Q4：Windows 用户

原生 Windows（PowerShell）安装：

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

Linux/macOS 命令在 WSL2 中同样适用。

### Q5：Token Plan vs API Key 区别

| 方式 | 获取方式 | 适用场景 |
|------|----------|----------|
| **Token Plan（推荐）** | MiniMax Token Plan 页面订阅 | 订阅制，按月/年计费，适合长期使用 |
| API Key | MiniMax API Key 管理页面 | 按量付费，适合灵活使用 |

---

## 为什么选 Hermes + MiniMax-M3？

| 特点 | 说明 |
|------|------|
| **跨会话持久记忆** | Hermes 记住你的项目上下文，配合 M3 的 1M 上下文越用越懂你 |
| **自改进学习** | 任务完成后自动生成 Skills，MiniMax-M3 帮你分析编码模式 |
| **多平台** | CLI 直接用，或者连接 Telegram 随时召唤 Agent |
| **40+ 工具** | Web 搜索、文件操作、代码执行等，直接调用不需额外配置 |
| **Token Plan** | 订阅制免 Key，一个命令完成配置 |

摘要

标签多个标签用逗号分隔

分类