Hermes Agent从 0 到 1 保姆级安装使用教程，零基础也能直接上手

如果你最近刚接触 MaxHermes，最容易搞混的一件事，就是“到底要不要自己装环境”。先说结论：如果你只是想尽快开始用，优先走 MiniMax 的云端 Agent 入口；如果你想自己掌控模型、终端、消息平台接入和本地运行，再走 Hermes Agent 安装路线。MiniMax 公开入口已经提供 Agent 使用页面，而 MiniMax 开放平台也单独给出了“在 Hermes Agent 中使用 MiniMax-M2.7”的官方文档。

换句话说，这篇教程我会按最省事的方式来讲：先教你怎么“零门槛开始用”MaxHermes，再教你怎么“进阶安装 Hermes Agent 并接入 MiniMax”。这样无论你是纯小白，还是后面准备深度折腾，都能直接照着走。:

一、先搞懂：MaxHermes 和 Hermes Agent 不是一回事

MaxHermes更适合理解为 MiniMax 的云端 AI 助手形态，你可以直接从官方 Agent 入口开始使用；Hermes Agent 则是 Nous Research 的开源智能体框架，支持终端对话、消息网关、技能沉淀和多平台接入。MiniMax 当前官方文档明确支持把 MiniMax-M2.7 作为 Hermes Agent 的模型提供方来使用。

所以，零基础用户最简单的路线是：先用云端 Agent 体验，再决定要不要进入本地安装。开发者或重度用户，则可以直接安装 Hermes Agent，再接 MiniMax 的 Token Plan Key。

二、零基础最快上手：先从云端 MaxHermes 开始

如果你的目标是“今天就能开始用”，那就不用先装 WSL2、Python 或 Docker，直接打开 MiniMax Agent 官方入口登录即可。官方入口把它定位成 AI 超级助手，支持创作、分析、编程等任务。

第一次进入后，不建议你一上来就丢特别复杂的自动化任务。最好的做法，是先用 3 类简单任务测试它：第一类是文案改写，比如“把这段产品介绍改成更适合公众号发布的版本”；第二类是资料整理，比如“把这段会议记录整理成摘要、待办事项和行动清单”；第三类是模板生成，比如“帮我做一个每周工作复盘模板”。这样最容易快速判断它的输出风格是否适合你。这个步骤属于使用建议，不是官方强制流程。官方可确认的是，MiniMax 已提供 Agent 入口，且 Token Plan 围绕 M2.7 提供持续可用的模型额度。

第二步，你就可以开始“教它记住你”。比如告诉它：“以后我让你写官网稿，默认输出标题、描述、主体、总结四段结构。”“以后我让你整理资料，默认加重点结论和行动建议。” 这样做的意义在于，Hermes 系产品的核心卖点之一，就是记忆与技能沉淀。官方对 Hermes Agent 的描述就是“the agent that grows with you”。

三、想本地安装？先准备这 3 样东西

如果你决定进入进阶模式，开始本地安装 Hermes Agent，那前置准备其实并不复杂。第一，你需要一台可运行的设备。官方支持 Linux、macOS、WSL2，另外近期版本也已支持 Android 的 Termux；从项目介绍看，它甚至可以跑在低配 VPS 上。

第二，你需要一个可用的模型提供方或 API Key。官方 Quickstart 支持 Nous Portal、OpenAI、Anthropic、OpenRouter、GLM / Z.AI、Kimi / Moonshot、MiniMax 等多家提供方；如果你准备走 MiniMax 路线，则需要先订阅 Token Plan，再创建 Token Plan 专属 API Key。MiniMax 也特别说明，Token Plan Key 和按量计费 API Key 并不互通。

第三，你只需要具备基础终端操作能力。因为 Hermes Agent 的安装已经尽量简化为一条命令，新手只要会复制、粘贴、回车，基本就能完成第一轮安装。

四、第一步：一键安装 Hermes Agent

官方推荐的一键安装命令如下：

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

这条命令适用于 Linux、macOS 和 WSL2。安装完成后，Hermes Agent 提供两个主要入口：一个是直接运行 hermes 进入终端 UI；另一个是运行消息网关，通过 Telegram、Discord、Slack、WhatsApp、微信等平台与它对话。

如果安装后命令没有立即生效，通常需要重新加载 shell 配置，或者重开一个终端窗口。这个细节在 Hermes 官方 Quickstart 中也有对应说明。

五、第二步：配置 MiniMax 模型并完成初始化

如果你准备使用 MiniMax 模型，MiniMax 官方给出的推荐命令是：

hermes model

随后按提示完成 3 步：选择 MiniMax 作为 provider；输入 Token Plan API Key；选择 MiniMax-M2.7 作为模型。官方文档已经明确给出了这条路径。

这里要特别注意，MiniMax 的 Token Plan 是订阅制方案，提供 M2.7 以及其他模态模型的额度支持；是否使用 Token Plan 或按量计费，取决于你拿来调用的 API Key 类型。MiniMax 官方对此写得很清楚。

配置完成后，直接输入下面这条命令，就能进入 Hermes 的终端对话界面：

hermes

这一点也已经由 Hermes 官方 GitHub 页面确认：终端 UI 的启动方式就是 hermes。

六、第三步：打开 Web 面板，更适合新手操作

如果你不喜欢一直盯着终端，也可以直接启动 Hermes 的本地网页仪表盘。官方现在已经提供 Dashboard 入口，用来管理配置、API Keys、会话、技能和网关。对应命令是：

hermes dashboard 

这一步对新手特别友好，因为你可以在网页里更直观地管理会话和配置，不必每一步都靠命令行。虽然 Hermes 还有社区版 WebUI 项目，但官方当前最稳妥的本地网页入口，还是 Dashboard 这条命令。

七、第一次使用，建议先做这 3 个任务

第一，试试文案任务。比如“帮我把这段产品介绍改成更适合官网发布的版本，并输出 3 个可选标题。” 这类任务最容易看出它的表达能力。第二，试试整理任务。比如“把这段会议纪要整理成摘要、风险点和待办事项。” 第三，试试模板任务。比如“帮我生成一个适合每周复盘的固定模板。”

为什么建议从这三类开始？因为它们足够简单，又能快速建立你的个人偏好。Hermes 的核心价值，不只是做一次任务，而是随着使用逐渐理解你的风格和规则。官方对 Hermes 的定位，也正是“会随着你一起成长的 Agent”。

八、第四步：接入微信、飞书、Slack 等平台

很多人最关心的是：装好之后，能不能直接在微信或企业 IM 里用？答案是可以，但要走 Hermes 的消息网关。官方文档说明，最简单的消息平台接入方式是运行：

hermes gateway setup

随后在交互式向导中选择你想接的平台。Hermes 当前官方文档覆盖了 Telegram、Discord、Slack、WhatsApp、Signal、Email、SMS、Weixin（微信）、WeCom（企业微信）等多种渠道。

如果你要接微信，官方 Weixin 文档写得很具体：运行 hermes gateway setup 后选择 Weixin，系统会通过 iLink Bot API 请求二维码，在终端中显示二维码或提供 URL，等待你用微信移动端扫码并确认登录，然后自动把账号凭据保存到本地。

这一步最重要的提醒是：官方文档确认了接入方式，但并没有给出“绝对零风险”的承诺。所以更稳妥的理解是，Hermes 已支持微信接入，你应按官方向导配置，并结合自己的账号使用场景评估合规与运营风险。

配置完成后，启动网关即可：

```bash id="jjrm9z" hermes gateway start ```

如果后续要查看状态、停止或重启，也都可以通过对应的 gateway 子命令来管理。

九、开发者进阶：把 Hermes 真正变成你的专属生产力工具

如果你是开发者，Hermes 的价值会更明显。首先，它支持多模型切换，你可以把 MiniMax-M2.7 作为主力模型，也可以根据任务切换其他提供方。其次，它本身就是 Agent 框架，适合叠加你自己的工具、业务流程和消息平台。再进一步，你还可以结合 MiniMax 的 Token Plan 最佳实践，使用更长上下文和结构化测试方法来跑复杂任务。MiniMax 官方也专门给出了 M2.7 的使用技巧页面。更直白一点说，普通用户适合把 MaxHermes 当“会越来越懂你的云端助手”；开发者则更适合把 Hermes Agent + MiniMax 当“可长期进化的本地或半托管生产力系统”。

十、最推荐的上手路线

如果你是零基础，我建议你走这条路线：先打开 MiniMax Agent 官方入口，先跑文案改写、资料整理、模板生成这三类基础任务；熟悉之后，再决定是否安装 Hermes Agent。这样最省时间，也最不容易劝退自己。

如果你已经确定要长期使用，或者你希望接入微信、企业微信、Slack、Webhook 等场景，那就直接安装 Hermes Agent，再用 hermes model 配置 MiniMax-M2.7，用 hermes gateway setup 完成平台接入。Webhook 也是官方支持的，且同样可以通过网关向导启用。

总结

MaxHermes 从 0 到 1，其实没有很多人想象中那么复杂。你如果只是想尽快开始用，直接上 MiniMax Agent 云端入口就够了；你如果想更强的可控性、更多平台接入和更深的个性化能力，再安装 Hermes Agent，并接入 MiniMax Token Plan 和 MiniMax-M2.7。前者适合“先体验”，后者适合“长期搭建”。

一句话总结就是：小白先用云端 MaxHermes，进阶用户再上 Hermes Agent + MiniMax。 这条路最快，也最稳。

【免责声明】：部分内容、图片来源于互联网，如有侵权请联系删除，QQ：228866015