先把边界说清

Hermes 难点不在安装，难点在装完以后你会不会继续用。

很多人第一次接触它，会先把它想成另一个聊天工具。这样理解，后面很容易用错。Hermes 是一套 agent runtime，重点是记忆、任务拆分、代码执行、定时任务和上下文文件。

所以这篇不讲概念，直接做两件事：把它装起来，再用两个最短的例子看它到底擅长什么。

先看平台边界

截至北京时间 2026 年 4 月 11 日，Hermes 官方支持 Linux、macOS 和 WSL2。Windows 原生不支持。

这句话最好一开始就记住。因为 Windows 用户最容易浪费时间的地方，就是在原生 PowerShell 里找路。官方没有给这条路，继续试只会浪费时间。Windows 上最省事的办法，就是先装 WSL2，把 Hermes 当 Linux 工具用。

安装前再确认一件事：机器上先有 Git。官方安装器会顺手处理掉大部分依赖，Git 有了，后面就会轻松很多。

macOS：直接走官方安装器

macOS 这边最省事。先确认 Git：git --version。

如果系统弹出 Command Line Tools 的安装提示，就先装完。然后直接跑官方安装器：

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

装完以后重载 shell。你用 zsh 就跑 source ~/.zshrc，用 bash 就跑 source ~/.bashrc。然后先别急着进去聊天，先查环境：hermes doctor，再看状态：hermes status。

这两步没明显报错，再继续：先跑 hermes model 选 provider，再跑 hermes 正式进 CLI。能看到欢迎界面和当前模型，基本就说明装好了。

Windows：先装 WSL2，再按 Linux 路线走

Windows 的路径也不复杂，只是比 macOS 多一步。

先以管理员身份打开 PowerShell，执行：

PowerShell powershell 
wsl --install

如果你想直接指定 Ubuntu，就用：

PowerShell powershell 
wsl --install -d Ubuntu

重启电脑以后，第一次打开 Ubuntu，系统会让你创建 Linux 用户名和密码。做完这一步，再在 Ubuntu 终端里继续。

先确认 Git：git --version。如果没有，就先跑：

Bash bash 
sudo apt update
sudo apt install -y git

然后就和 macOS 一样了。在 Ubuntu 里跑官方安装器。

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

装完以后重载 shell，再跑 hermes doctor、hermes model 和 hermes。

最关键的一条只有一条：后面所有 Hermes 命令，都在 WSL2 里跑，不要再切回 Windows PowerShell。

provider 第一次怎么选

很多人第一次真正卡住，往往是在 provider。

如果你只是想尽快看 Hermes 是什么，优先选 Nous Portal 或 OpenAI Codex。这两条都比较顺手，前者偏省事，后者偏登录即用。

如果你已经知道自己后面要经常切模型，可以选 OpenRouter。它更灵活，但也意味着你要自己管 API key 和费用。

本地模型这条路可以晚一点再碰。Hermes 支持走 OpenAI-compatible endpoint，所以你后面当然可以接 Ollama、vLLM 或别的本地服务。但第一次安装时，最好不要把装工具和折腾本地模型绑成一件事。先让 Hermes 正常跑起来，再说别的。

装完以后，先别急着上大任务

第一轮验证很简单，三步就够。

先看 CLI 能不能起：hermes。

再看环境和配置：hermes doctor，hermes status --deep。

最后做一轮最小问答：hermes chat -q "Hello. Tell me what tools you currently have available."。

这三步都正常，再往下试能力。要不然你一上来就丢复杂任务，出了问题也很难判断到底是安装没好、provider 没选对，还是任务本身写得有问题。

例子一：让它并行读懂一个仓库

第一个例子最适合开发者。它不需要消息网关，也不需要别的平台账号。本地有个代码仓库就行。

先进入项目目录，然后启动 Hermes。接着给它一段任务：先读这个仓库里的 README、AGENTS.md 和关键目录；并行做三件事，一是找启动入口和主执行流程，二是找测试命令和测试最薄弱的区域，三是找最值得优先理解的三个目录；最后给出一张十分钟接手这个项目的地图；中间的大量搜索和命令输出不要全贴回来，只给结论。

这个例子能很快看出 Hermes 和普通聊天壳子的差别。它会自动把 AGENTS.md、.hermes.md、.cursorrules 这类上下文文件吃进去，也会把任务拆成几个工作面去做。中间那些搜索结果和命令输出，也不会一股脑全塞回主上下文。

你跑完以后，再补一句：以后在这个项目里，默认先告诉我测试命令，再动代码。把这个偏好记住。

然后退出，重新开一个 session，再问它：继续刚才那个项目，先按你记住的流程走。

如果它能顺着接上，你就知道它不只是记住这一轮聊天，还能把你的工作偏好延续到下一次。

例子二：把它变成一个定时研究员

第二个例子试 cron。这个功能特别容易被忽略，因为很多人装完以后，视野还停留在当前窗口这一轮对话里。

你可以直接在 CLI 里说：创建一个定时任务；每个工作日早上九点，访问 Hacker News 首页；筛出和 AI agent、coding agent、MCP 相关的帖子；用中文写五条简短摘要；如果 ~/hermes-reports 不存在就先创建；把结果保存到 ~/hermes-reports/hn-agent-digest.md，并覆盖旧文件。

如果你更习惯显式命令，也可以直接用 hermes cron create 去建任务，再用 hermes cron list 看列表；不想等明天的话，就手动跑一次 hermes cron run 和 hermes cron tick。

这里补一条新手很容易漏掉的：你真想让定时任务按时自动跑，得让网关在后台持续运行。最直接的方式是先用 hermes gateway 前台跑起来；后面确定长期使用了，再看 hermes gateway install。

这个例子重点不在抓网页，而在三件事：任务能从现在排到之后继续跑；cron 跑在 fresh session 里，不会把你当前窗口里的脏上下文一并拖进去；结果会落到文件里，不会因为你关掉窗口就没了。

新手最容易踩的几个坑

第一个坑，是在 Windows 上死磕原生安装。别试，直接 WSL2。

第二个坑，是装完以后先怀疑模型不行，却不先跑 hermes doctor。很多问题其实只是 provider 没配好、PATH 没刷新、shell 没重载。

第三个坑，是第一次就同时折腾本地模型、cron、skills、MCP、gateway。这样排错会很痛苦。更稳的顺序是：先让 CLI 跑起来，再让 provider 跑通，然后试一个并行任务，再试一个定时任务，最后再加别的扩展。

第四个坑，是把 Hermes 当成更复杂的聊天框，结果老问一些根本体现不出它优势的问题。你真想看出它的差别，就给它那些会跨 session、跨工具、跨时间的任务。

装好以后，至少看到这几件事

如果下面这些都成立，基本就说明这次安装已经成了：hermes doctor 没明显报错；hermes model 已经选好一个能用的 provider；hermes 能正常进入 CLI；你能用一个仓库任务看见它自动吃到 context files；你能创建并查看一个 cron 任务。

到这一步，这次安装就算真的完成了。

对新手来说，不用今天把所有功能都碰一遍。先记住一件事：Hermes 适合那些会持续、会分支、会跨工具、会跨时间的任务。这个感觉对了，后面再加 skills、MCP、gateway，就不会乱。