万人催更的Hermes Agent保姆级教程来了——从安装到实战,我帮你把坑全踩了一遍

前两天一个读者在后台问我：网上 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	⚠️ 需要先装 WSL （ Windows 下的 Linux 子系统），我下面会一步步教
Linux （ Ubuntu 等）	✅ 很顺畅

不需要好电脑。官网说最低 4GB 内存，但我拿一台 2019 年的 MacBook Air （ 8GB ）试过，完全跑得动。

第二件事：你得有一个 API Key

Hermes 本身不产生智能，它需要一个"大脑"——也就是大模型的 API 。

推荐三条路线：

•省心路线：用 OpenRouter （openrouter.ai^[1]），注册送$1 额度，支持 200+模型，随便切换

•直连路线： Anthropic （ Claude 的官方 API ），质量最高但贵一点

•免费路线：装 Ollama （本地跑开源模型），完全免费但需要配置高点

新手推荐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`	列出 Hermes 当前能用的所有工具（预装 40+个）
`/memory`	查看它记住了你什么
`/skills`	查看它学会了哪些技能
`/compress`	长对话时压缩，省 token
`/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 机器人的步骤很直白：

1.去 Telegram 搜 @BotFather，发 /newbot 创建机器人，拿到 token

2.运行 hermes gateway setup，选 Telegram ，粘贴 token

3.运行 hermes gateway 启动

完事。以后你在 Telegram 上跟机器人说话，它在你的电脑上干活。

场景 4 ：帮你看论文、写摘要

扔给它一个链接：

"帮我打开这篇论文的链接，提取核心方法、实验结果和结论，用 500 字以内总结。"

它去读网页，然后给你一份人话版的摘要。

场景 5 ：管理你的待办事项和笔记

"在我的备忘录里记一笔：下周二是项目截止日，提前三天开始提醒我。"

Hermes 有持久记忆，下次你问它"我下周有什么重要的事"，它能回答出来。

场景 6 ：自动整理文件

"扫描我的下载文件夹，把 PDF 按主题分类，图片移到图片文件夹，超过 30 天没动过的文件列出来。"

它会直接在你的电脑上操作。

场景 7 ：跨平台消息转发

你可以让 Hermes 同时接入多个平台——比如 Telegram 收到一个消息，自动转发到 Discord 里。或者 Slack 上有人@你，它自动给你发微信通知。

场景 8 ：写代码、改 Bug

把项目路径告诉它：

"看这个项目的代码结构，帮我找到这个函数在哪些文件里被调用过。"

它会读代码、理解逻辑、给你答案。

进阶玩法：让它自动干活

如果你已经玩熟了基础功能，接下来就是让它当一个不用睡觉的员工。

Cron 定时任务

前面已经说了怎么设日报。但 Hermes 的 cron 不止可以做日报——

你可以设多个定时任务，比如：

•每小时检查一下你服务器的健康状态

•每天晚上 11 点总结今天的待办完成情况

•每周五下午 5 点生成周报草稿

查看所有定时任务：

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 智能体，强在自学能力、跨平台消息、定时任务、海量工具集成。

选哪个，取决于你的场景：

•你主要写代码？→ Cursor 或 Cline

•你要一个能操作本地文件、帮你管理桌面的管家？→ OpenClaw

•你要一个能上网、能搜信息、能定时干活、能接各种消息平台的全能助手？→ Hermes

当然，像我前面说的——它们不冲突。完全可以一起装。

遇到问题怎么办？

几个高概率遇到的坑和解决办法：

"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 突然变成了一个真的能帮你干活的员工。那种感觉——

就好像你养了一年的猫，突然开口帮你点了份外卖。

评论区说说：你第一个任务打算让它帮你干什么？我看谁的脑洞最大～