夜雨聆风前两天一个读者在后台问我：网上 Hermes Agent 的教程怎么都是英文的？我连终端都找不到，怎么装？
我说你等等——国内其实已经有中文教程了。但你猜怎么着？我翻了一遍，大部分只告诉你怎么装，不告诉你装了之后能干嘛。
这不是教程，是"安装说明书"。
真正的保姆级教程应该是什么样的？从"终端是什么"开始讲，到"装完能干嘛"结束，中间每一个坑都提前告诉你。
好，不卖关子了。
这篇就是国内最完整的 Hermes Agent 保姆级教程——从零开始， Mac 和 Windows 都有，装完还能立刻上手干活。全程 3000 字+，我踩过的坑你一个都不用再踩。
Hermes Agent 到底是什么？凭什么这么火？
先简单说一下这东西是啥。
Hermes Agent 是 Nous Research （一个 AI 研究团队）开发的开源 AI 智能体。 2025 年底上线，到现在 GitHub 上已经飙到了105k Stars——什么概念？比很多明星开源项目还猛。
跟普通的 AI 助手最大的区别在于：它是能自己学习的。
你让它做一件复杂的事情，做完之后它会自动把方法写成一份"技能文档"存下来。下次你再让它做类似的事，它直接调技能，不用从头教。
举个例子。
你第一次让它"每天早上 9 点去 Hacker News 搜 AI 新闻，总结成三条发到微信"。它做完了，生成一个技能文件。第二天同样的任务，它执行得比前一天快 50%。
这就是它说的"越用越聪明"——不是营销话术，是真有这个机制。
说白了，别的 AI 是"用完即走"， Hermes 是"用得越多越好用"。
但你别一上来就想着玩花活儿。安装这一步，就能绊倒 80%的人。
装之前，先搞清楚三件事
我知道你急着想上手。但有三件事你必须在装之前搞清楚，不然装到一半卡住，心态直接崩。
第一件事：你的系统支持吗？
| Mac （ Intel 或 M 芯片） | |
| Windows | |
| Linux （ Ubuntu 等） |
不需要好电脑。官网说最低 4GB 内存，但我拿一台 2019 年的 MacBook Air （ 8GB ）试过，完全跑得动。
第二件事：你得有一个 API Key
Hermes 本身不产生智能，它需要一个"大脑"——也就是大模型的 API 。
推荐三条路线：
新手推荐OpenRouter。注册→拿 Key→粘贴， 5 分钟搞定。
第三件事：什么是终端？怎么打开？
如果你不知道"终端"是什么，我也帮你写清楚——
Mac 用户：按键盘左下角的 Command + 空格，弹出搜索框，输入"终端"，点击打开。出来的那个黑乎乎的窗口就是。
Windows 用户：你先别管终端，下面会教你装 WSL ，装好了自然就有了。
好，三件事搞清楚了？开装。
Mac 用户安装：一行代码， 5 分钟搞定
苹果电脑是体验最好的。自带 Linux 基因，相当于 Hermes 这个智能管家已经有现成的房子住了，直接入住就行。
打开终端，复制下面这行代码，回车：
curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash 然后去倒杯水。脚本会自动帮你： 1. 检测系统，装好 Python 3.11+、 Node.js 等依赖 2. 把 Hermes 的代码克隆到 ~/.hermes 目录下 3. 创建 Python 虚拟环境，装好所有包 4. 注册全局 hermes 命令 5. 弹出设置向导，让你配大模型
整个过程 5-10 分钟，取决于你的网速。
装完之后验证一下：
source~/.zshrc hermes--version 如果看到 hermes-agent v0.8.0 之类的版本号，说明装好了。
万一报错？运行
hermes doctor，它会自动检查环境问题并告诉你怎么办。
Windows 用户安装：建个房子，再请管家
Windows 用户麻烦一点。因为 Hermes 需要 Linux 环境才能跑，所以你要先用 WSL"建个房子"。
好消息是：这个房子建一次，以后所有 Linux 工具都能用。 而且步骤没那么恐怖，我帮你拆干净了。
第一步：打开 PowerShell
按键盘上的 Win 键（四个小方块的图标），搜"PowerShell"，右键选"以管理员身份运行"。
会弹出一个蓝底白字的窗口。这就是你接下来操作的地方。
第二步：装 WSL
在黑窗口里输入：
wsl--install回车。系统会自动下载并安装 WSL 2 和 Ubuntu 。大概 5-15 分钟，取决于网速。
装完之后会提示你重启电脑。马上重启。
第三步：设置 Ubuntu 账号
重启后，电脑可能会自动弹出一个 Ubuntu 窗口，让你设置用户名和密码。
user。不要用中文，不要有空格。如果重启后没弹窗，去开始菜单搜"Ubuntu"打开它。
第四步：更新系统包
在 Ubuntu 窗口里输入：
sudoaptupdate 如果提示输入密码，就输你刚才设的那个（同样不显示）。
第五步：装 Node.js
curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash- sudoaptinstall-ynodejs 第六步：一键安装 Hermes
好了，终于到了最关键的一步：
curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash 装完之后，运行 hermes --version 检查。看到版本号就说明装好了。
以后每次用 Hermes ，都在这个 Ubuntu 窗口里操作。 粘贴命令：在窗口内右键点击就是粘贴。或者按
Ctrl+Shift+V。
补充：万一安装失败怎么办？
我装的时候 Ubuntu 安装失败过一次——PowerShell 版本太低了。
解决：去微软官网下载最新版 PowerShell ，装完重启，重新运行 wsl --install。
还有一个常见问题：安装脚本跑的时候卡住了。直接按 Ctrl+C 打断，它会继续往下走的。
配大模型：最关键也最容易被坑的一步
装好之后，第一次运行会弹出设置向导，让你配大模型。这一步能卡住一半的人。
设置向导一般会自动弹出。如果没弹，手动输入：
hermessetup 选哪个提供商？
新手首选： OpenRouter 。
注册地址：openrouter.ai[2] * 注册→邮箱验证→拿 API Key * 在向导里选"OpenRouter"，粘贴 Key * 推荐模型： Claude Sonnet （质量稳）或 GPT-4o （速度快）
想省钱的： Ollama （完全免费）。
先装 Ollama ：
curl-fsSLhttps://ollama.com/install.sh|sh 然后拉模型（需要至少 64K 上下文窗口的模型）：
ollamapullgemma4 然后在 Hermes 向导里选"Custom endpoint"， API 地址填 http://127.0.0.1:11434/v1， API Key 留空。
注意：如果你的显卡不够好（显存低于 8GB ），不要选 Ollama 。老老实实走 OpenRouter 。
还有几个坑
坑 1 ： API Key 粘贴后什么都看不见 这是正常的。终端输入密码和 Key 的时候默认不显示任何字符。粘贴完直接回车就行。
坑 2 ：粘贴的时候不要粘两遍 粘完之后觉得"没反应"又粘了一遍？等着报错吧。两个 Key 叠一起，谁都认不出谁。
坑 3 ：从哪里迁移？ 向导会问你要不要从 OpenClaw 迁移。如果你之前用过小龙虾，可以选 Y 迁移记忆和技能。没用过的直接 N 跳过。
启动！跟你的第一个 AI 管家聊两句
配好模型之后，输入：
hermes 看到 > 提示符，说明启动成功了。
试试问它：
"我当前目录下有什么？列出文件。"
Hermes 会调用内置的文件操作工具，列出当前目录的文件。反应很快，一两秒就出了。
再试试复杂一点的：
"帮我搜索一下今天 AI 圈有什么大新闻。"
它会调用网页搜索工具，去网上抓取，然后整理成几条给你。
如果你用过 ChatGPT 或 Claude 的话，界面体验不一样——Hermes 会显示它每一步在干什么：
📋 计划：分析用户请求，搜索AI新闻 🔧 工具调用：web_search(query="AI news today 2026") 📊 结果：获取到15条结果 💬 回复：根据搜索结果总结... 这种透明度的好处是：你知道它在想什么、在干什么，而不是像一个黑盒子一样扔给你答案。
常用命令速查
/tools | |
/memory | |
/skills | |
/compress | |
/quit |
建议你先敲一遍 /tools，看看它到底能干什么。看完你会觉得——这玩意儿比我想象的猛。
能干嘛？ 8 个让你心动的实用场景
装好只是第一步。问题来了：有了 Hermes ，我能拿来干什么？
我用了这段时间，整理了 8 个我自己觉得最实用的场景：
场景 1 ：定时推送 AI 日报到微信
这是我最常用的功能。
hermescronadd 然后输入：
"每天早上 8 点半，搜索国内外 AI 领域最重要的 3 条新闻，每条用 100 字以内总结，发送到微信。"
设置好之后，每天早上你睁开眼，微信上就有三条 AI 简报等着你。不用自己刷了。
场景 2 ：让它帮你监控 GitHub 项目更新
如果你跟某个开源项目，想第一时间知道有什么变动：
hermescronadd "每 6 小时检查一次 GitHub 上的 NousResearch/hermes-agent 仓库，如果有新的 Release 或重大更新，给我总结。"
场景 3 ：让它接入 Telegram/Discord
Hermes 内置了 20 多个消息平台的支持。
装 Telegram 机器人的步骤很直白：
@BotFather，发 /newbot 创建机器人，拿到 tokenhermes gateway setup，选 Telegram ，粘贴 tokenhermes gateway 启动完事。以后你在 Telegram 上跟机器人说话，它在你的电脑上干活。
场景 4 ：帮你看论文、写摘要
扔给它一个链接：
"帮我打开这篇论文的链接，提取核心方法、实验结果和结论，用 500 字以内总结。"
它去读网页，然后给你一份人话版的摘要。
场景 5 ：管理你的待办事项和笔记
"在我的备忘录里记一笔：下周二是项目截止日，提前三天开始提醒我。"
Hermes 有持久记忆，下次你问它"我下周有什么重要的事"，它能回答出来。
场景 6 ：自动整理文件
"扫描我的下载文件夹，把 PDF 按主题分类，图片移到图片文件夹，超过 30 天没动过的文件列出来。"
它会直接在你的电脑上操作。
场景 7 ：跨平台消息转发
你可以让 Hermes 同时接入多个平台——比如 Telegram 收到一个消息，自动转发到 Discord 里。或者 Slack 上有人@你，它自动给你发微信通知。
场景 8 ：写代码、改 Bug
把项目路径告诉它：
"看这个项目的代码结构，帮我找到这个函数在哪些文件里被调用过。"
它会读代码、理解逻辑、给你答案。
进阶玩法：让它自动干活
如果你已经玩熟了基础功能，接下来就是让它当一个不用睡觉的员工。
Cron 定时任务
前面已经说了怎么设日报。但 Hermes 的 cron 不止可以做日报——
你可以设多个定时任务，比如：
查看所有定时任务：
hermescronlist 查看任务的执行记录：
hermescronlogs<id> MCP 集成——接入外部服务
MCP （ Model Context Protocol ）是个开放协议，让 Hermes 能连接 GitHub 、数据库、 Stripe 等各种外部服务。
比如接 GitHub ：
在 ~/.hermes/config.yaml 里加一段配置：
mcp_servers:github:command:npxargs:["-y","@modelcontextprotocol/server-github"]env:GITHUB_PERSONAL_ACCESS_TOKEN:"你的token"配完之后， Hermes 就能直接操作 GitHub——建 Issue 、审 PR 、搜代码，都行。
技能系统——用得越多越聪明
这可能是 Hermes 最被低估的功能。
每次你让它做一个需要 5 步以上工具调用的复杂任务，做完之后它会自动生成一份技能文件，存在 ~/.hermes/skills/ 下。
这些技能是可复用的——下次遇到类似任务，它直接加载技能，不需要再从零思考。
而且技能是可移植的——你可以把技能文件分享给朋友，他们直接导入就能用。
官方用的是 agentskills.io 的开放标准，以后应该会有一个技能市场。
跟其他 AI 智能体有什么区别？
我知道你可能会问： Hermes 、 OpenClaw 、 Cline 、 Cursor 这些到底有什么区别？
简单说——
Cursor： AI 编程工具，只在 IDE 里工作。Cline： VS Code 插件，也是编程为主。OpenClaw （小龙虾）：本地 AI 助手，强在文件操作和本地执行，能装 Skill 做各种事，微信版就是 WorkBuddy 。Hermes Agent：全能型 AI 智能体，强在自学能力、跨平台消息、定时任务、海量工具集成。
选哪个，取决于你的场景：
当然，像我前面说的——它们不冲突。完全可以一起装。
遇到问题怎么办？
几个高概率遇到的坑和解决办法：
"Model context too small" 报错 你用的模型上下文窗口太小了。 Hermes 要求最低 64K tokens。换成 Claude Sonnet 或 GPT-4o （都是 200K 上下文）。
Cron 任务不触发 先检查：网关（ Telegram/Discord ）是不是开着？时区对不对？用 hermes cron logs <id> 查看执行记录。
命令被安全模块阻止 Hermes 内置了 Tirith 安全系统，一些看起来危险的操作（比如把 curl 输出管道到 shell ）会被硬阻止。如果确定是安全操作，去配置里调整 Tirith 规则。
Token 用量太高 每次 CLI 对话大约消耗 6-8K 输入 token ，每次 Telegram 消息大约 15-20K 。长对话记得用 /compress 压缩。
还搞不定？官方的排查工具比大部分文档好用——运行 hermes doctor，自动检查环境、依赖、 API 连通性。
好，啰嗦完了。
从安装到配置到实战，这篇写了快 4000 字。你只需要做一件事：
把这篇文章收藏了，打开终端，开始装。
装好之后，你手机里那个只会聊天的 AI 突然变成了一个真的能帮你干活的员工。那种感觉——
就好像你养了一年的猫，突然开口帮你点了份外卖。
评论区说说：你第一个任务打算让它帮你干什么？我看谁的脑洞最大～
