夜雨聆风点击下方👇 嘿哥的AI基地 关注公众号
一起探索AI的世界
这段时间，Hermes Agent 的讨论越来越多。很多人第一次接触它，最常问的其实不是“它强不强”，而是三个更现实的问题：
它到底是什么？
我这台电脑能不能装？
装完之后，第一步到底该做什么？
如果你也卡在这里，这篇文章就按最实际的思路来写：不讲太多花哨概念，先带你把 Hermes Agent 在 macOS、Linux、WSL2 上跑起来。
先说结论：
macOS 用户：直接本机安装，通常最省事。 Linux 用户：直接本机安装，通常最稳。 Windows 用户：不要在原生 Windows 环境里折腾，先装 WSL2，再在 WSL2 的 Linux 终端里安装。
Hermes Agent 官方目前支持 Linux、macOS 和 WSL2，不支持原生 Windows。常用命令包括 hermes、hermes setup、hermes model、hermes tools、hermes gateway、hermes doctor 等。
一、开始之前，先准备这三样东西
在正式安装之前，先别急着复制命令。你只需要先确认三件事：
第一，你有一个能正常使用的终端环境。
第二，你的系统里已经装好 git。
官方安装流程把 git 作为前置要求之一。至于 Python、Node.js、ripgrep、ffmpeg 这些依赖，官方文档说明安装器会自动处理。
第三，你至少准备好一种模型接入方式。
最常见的是 API Key，也可以后续接自托管模型端点。但对新手来说，最简单的方式仍然是先用一个现成的模型提供商，把基础流程跑通。
如果你第一次装，我的建议很简单：先求能用，再求高级。
二、macOS 怎么装？
macOS 是对新手比较友好的安装路径。只要终端环境正常，整体流程通常比较顺。
第一步，打开终端。
你可以直接按 Command + Space，输入 Terminal 打开。
第二步，确认 git 是否已安装。
先运行：
git --version如果能看到版本号，就可以继续。如果没有安装，可以执行：
xcode-select --install装完后再运行一次 git --version 确认。
这个步骤是因为官方把 git 作为前置要求。 Nous Research Docs
第三步，安装 Hermes Agent。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash这里最稳妥的做法不是去记某一条命令，而是直接从官方安装页面复制当前最新的安装命令。
因为安装脚本地址后续可能调整，直接以官方文档为准最保险。
官方文档提供的是一行安装方式，适用于 macOS、Linux 和 WSL2。
第四步，安装完成后，重新加载 shell。
如果你默认使用 zsh，执行：
source ~/.zshrc如果你用的是 bash，就执行：
source ~/.bashrc这一步非常重要。很多人安装完发现 hermes 命令不可用，问题往往不是没装成功，而是 PATH 还没重新加载。
第五步，运行配置向导。
如果安装器没有自动进入配置流程，就手动执行：
hermes setup通常这里会让你选择模型提供商、填写 API Key，并完成基础设置。
第六步，启动 Hermes：
hermes只要你能正常进入交互界面，说明第一阶段已经完成了。 GitHub
如果你想更稳一点，装完后建议再顺手执行三条命令：
hermes modelhermes toolshermes doctor它们分别适合拿来确认模型配置、查看工具启用状态，以及排查常见环境与配置问题。
对 macOS 新手来说，最推荐的节奏其实是：
先装好； 先把 hermes跑起来；先确认能完成一次正常对话； 再去研究 hermes tools和hermes gateway。
不要一开始就冲消息网关、定时任务、复杂终端后端，这样最容易把简单问题搞复杂。
三、Linux 怎么装？
Linux 的思路和 macOS 很像，只是安装 git 的方式因发行版不同会有一点差别。
如果你是 Ubuntu 或 Debian 用户，可以先运行：
git --version如果没装，再执行：
sudo apt updatesudo apt install -y git然后重新确认一次 git --version。
接下来，Hermes Agent 的安装方式与 macOS 一样，建议直接去官方安装文档复制最新的一行安装命令。官方把 Linux、macOS、WSL2 放在同一套 Quick Install 流程里。
安装完成后，多数 Linux 发行版执行：
source ~/.bashrc如果你用的是 zsh，则执行：
source ~/.zshrc然后手动运行配置向导：
hermes setup配置好模型提供商和 API Key 后，再执行：
hermes如果成功进入交互界面，就说明基础安装已经通了。之后也建议你跑一遍：
hermes modelhermes toolshermes doctor这一组命令非常适合新手做安装后的第一次自检。
如果你以后想把 Hermes 长期挂着运行，Linux 确实会比别的平台更适合折腾后台服务、消息网关和自动化任务。
但第一次安装时，我还是建议你先把 CLI 用顺手，再逐步扩展。
四、Windows 用户为什么一定要走 WSL2？
这个问题很多人一开始不太愿意接受，但官方支持范围其实写得很明确：原生 Windows 不支持，Windows 用户请使用 WSL2。
所以如果你是 Windows 用户，最合理的路线不是在 CMD、PowerShell 里硬装，而是先确认 WSL2 已经准备好。
你可以在 Windows 终端或 PowerShell 里执行：
wsl --status如果系统已经装好 WSL2，会显示对应信息；如果没有，通常可以先执行：
wsl --install完成后重启电脑，再进入 Ubuntu 或其他 Linux 发行版。
注意，后续 Hermes 的安装一定要在 WSL2 的 Linux 终端里完成，而不是在原生 Windows 命令行里继续操作。
进入 WSL2 之后，步骤就和 Linux 基本一致了。先确认 git：
git --version没有的话就安装：
sudo apt updatesudo apt install -y git然后去官方安装文档复制最新安装命令，在 WSL2 终端中执行。装完后执行：
source ~/.bashrc如果你是 zsh，就执行：
source ~/.zshrc接着运行：
hermes setup完成模型和 API Key 配置之后，再运行：
hermes只要进入交互界面，说明主流程已经跑通了。
WSL2 用户还有一个特别需要记住的点：CLI 跑通，通常不代表消息网关后台运行就一定同样顺利。
官方仓库近版本也专门补充了 WSL 相关指导，尤其是 systemd 和 gateway 的差异处理。
简单理解就是，WSL2 很适合你先把 Hermes 主体用起来，但如果你后面要跑长期在线的 gateway，就需要额外留意 WSL 的系统服务支持情况。 GitHub
所以如果你是 Windows 新手，我最建议的节奏就是：
先装 WSL2； 先把 Hermes CLI 跑通； 先别急着折腾后台常驻； 确认本体没问题之后，再研究 gateway。
五、装完之后，第一时间该做什么？
很多人装完以后会进入第二个误区：功能太多，不知道先做什么。
其实第一次安装成功后，只要按这个顺序来就够了。
先确认命令可用：
hermes --help再确认模型配置：
hermes model再查看工具启用状态：
hermes tools然后跑一次诊断：
hermes doctor最后，如果你已经能稳定在终端里使用 Hermes，再去接触：
hermes gateway这个顺序的核心逻辑很简单：先确认本体正常，再碰外部连接。
六、新手最容易踩的坑
第一个坑，是安装完直接提示 hermes: command not found。
这种情况先别慌，优先执行：
source ~/.bashrc或者：
source ~/.zshrc很多时候只是 shell 没有重新加载。
第二个坑，是安装脚本跑不动。
优先检查 git 是否已经安装，再检查网络环境和终端权限。
第三个坑，是模型配置完了，但还是不能正常聊天。
这时最先跑的命令应该是：
hermes doctor然后再回头检查 API Key、提供商和模型设置。
第四个坑，是 Windows 用户在原生环境里硬装。
这个方向本身就不对，直接切到 WSL2 会省很多时间。
第五个坑，是一开始就想把所有功能都配满。
Hermes 这类 Agent 功能很多，消息网关、技能、终端后端、定时任务、MCP，每个都能单独折腾很久。
对新手来说，先把 CLI 跑通，才是最重要的里程碑。
七、最后给新手一句最实用的建议
如果你只是想最快把 Hermes Agent 用起来，最推荐的落地方式其实非常简单：
macOS：直接本机安装 Linux：直接本机安装 Windows：先装 WSL2，再在 Ubuntu 里安装
然后只记住下面几个命令就够了：
hermes setup：重新运行完整配置向导hermes：启动交互式对话hermes model：选择或切换模型提供商和模型hermes tools：查看和配置工具hermes doctor：诊断常见环境与配置问题hermes gateway：配置或运行消息网关相关功能hermes update：更新到最新版本hermes version：确认版本hermes config show：查看当前配置hermes claw migrate：从 OpenClaw 迁移配置
如果只是第一次接触，先掌握前五个，其实就已经够用了。后面的能力可以等你跑顺了再慢慢研究。官方文档和仓库也还在持续更新，建议后续都以官方页面为准。
更详细的可以查看：
官方文档：https://hermes-agent.nousresearch.com/docs
官方仓库：https://github.com/NousResearch/hermes-agent
分享就到这里了，如果对大家有帮助，随手点个赞、转发、推荐三连吧，如果想第一时间收到推送，也可以给我个星标。
有任何想法，欢迎大家留言~
小手一赞，年入百万！👍👍👍
