> ## Documentation Index
> Fetch the complete documentation index at: https://platform.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> 在 Hermes Agent 中使用最新的 MiniMax M 系列模型进行自主 AI 编程。

<div style={{background:"#fffbeb",borderLeft:"4px solid #d97706",padding:"12px 16px",borderRadius:"6px",margin:"16px 0"}}>[**Hermes Agent**](https://github.com/NousResearch/hermes-agent) 是 Nous Research 出品的开源自我进化 AI Agent 框架。</div>

## 前提条件

* 拥有可用的 M Plan [订阅 Key](https://platform.minimax.cn/console/plan)
* 一台可访问终端的电脑（macOS、Linux 或 Windows WSL2）

***

<img src="https://mintcdn.com/minimax-zh/o4s7dA9m1MEvBPUq/images/hermes-agent-banner.png?fit=max&auto=format&n=o4s7dA9m1MEvBPUq&q=85&s=8a80dd5e8753f03a41d80d8da5510f89" alt="Hermes Agent" style={{borderRadius: '8px', marginTop: '12px', maxWidth: '100%'}} width="1145" height="196" data-path="images/hermes-agent-banner.png" />

## 安装 Hermes Agent

[Hermes Agent](https://github.com/NousResearch/hermes-agent) 是由 [Nous Research](https://nousresearch.com) 开发的开源自主学习 AI 智能体。它具备跨会话持久记忆、内置自改进学习能力、40+ 集成工具以及多平台支持（CLI、Telegram、Discord、Slack、WhatsApp）。

在终端中运行一键安装命令：

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

验证安装：

```bash theme={null}
hermes doctor
```

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

## 配置 MiniMax M Plan

<Tabs sync={false}>
  <Tab title="方式一：一键配置向导">
    如果使用一键配置向导，可以跳过上方手动安装，直接运行：

    ```bash theme={null}
    npx -y mmx-cli@latest agent setup
    ```

    在工具列表中选择 **Hermes Agent**，并填入订阅 Key。如果尚未安装，在第二个多选列表中保留 Hermes Agent。向导会运行官方安装器的非交互核心 CLI 阶段，跳过 `setup`、`gateway` 等可选流程，并检查 `hermes --version`。随后它会更新 `~/.hermes/config.yaml` 和 `~/.hermes/.env`。
  </Tab>

  <Tab title="方式二：手动配置 API Key">
    Hermes Agent 内置了对 MiniMax 的支持。运行模型选择器：

    ```bash theme={null}
    hermes model
    ```

    1. 从 provider 列表中选择 **MiniMax**。

    <img src="https://filecdn.minimax.chat/public/agent-tool/hermes/20260929/hermes-select-provider.png" alt="在 Hermes provider 列表中选择 MiniMax" style={{borderRadius: '8px', marginTop: '12px', maxWidth: '100%'}} />

    2. 选择 **MiniMax (China)**，使用中国站端点。

    <img src="https://filecdn.minimax.chat/public/agent-tool/hermes/20260929/hermes-china.png" alt="在 Hermes 中选择 MiniMax (China)" style={{borderRadius: '8px', marginTop: '12px', maxWidth: '100%', height: 'auto'}} />

    3. 输入从 [MiniMax M Plan 页面](https://platform.minimax.cn/console/plan)获取的 **订阅 Key**。

    4. 如果模型列表中没有 `MiniMax-M3.1-Flash-Preview`，选择 **Enter custom model name**，手动输入完整模型 ID。

    选好模型后，可编辑 `~/.hermes/config.yaml`，在现有的 `model:` 下设置 `context_length: 1000000`（1M 上下文），保留该节其他字段。
  </Tab>
</Tabs>

<Info>
  请在[套餐详情](https://platform.minimax.cn/console/plan)查看您的订阅 Key。订阅 Key 与按量付费 API Key 不同。
</Info>

## 开始使用

运行 `hermes`，开始与由最新 MiniMax M 系列模型驱动的 Hermes Agent 对话。

<Tip>
  Hermes Agent 的持久记忆和自改进技能系统意味着使用越多效果越好——您的编程模式、项目上下文和偏好会自动跨会话记忆。
</Tip>

## 思考深度

MiniMax-M3.1-Flash-Preview 默认开启思考且不可关闭。可用档位为 `low`、`medium`、`high`、`xhigh` 和 `max`；请勿使用 `none` 或 `minimal`。通过 `/reasoning` 选择档位时，以当前 Hermes Agent 版本支持的选项为准。