Hermes Agent 是 Nous Research 的自托管 agent。和上一篇那类东西同源, 但多了一件别人没有的:它会把做过的事变成可复用的技能,并且在使用中自己改进它们。 这一篇讲装、配、以及它的能力边界。
本文写什么安装、配置、模型旋钮、沙箱与网关、必须知道的坑。 本文不写我们自己怎么配、跑在哪。也不做它与同类项目的排名。
| 出品 | Nous Research |
| 开源 | MIT,主语言 Python |
| 仓库 | NousResearch/hermes-agent 233,749 ★ / 46,868 fork,2025-07-22 建仓 |
| 版本 | 最新 release v2026.8.18(即 v0.20.4,2026-08-18) |
| 特点 | 学习闭环:自造技能、用时自我改进、能搜自己的历史会话、跨会话建立对你的模型 |
Windows 走 PowerShell 的 iex (irm …/install.ps1);也有 mac / Windows / Linux 的桌面版安装器。
这类教程通篇 curl … | bash:把一个网址的内容下载下来直接交给 shell 执行。
如果那个网址不是官方的,你就是在把机器交出去,而且是自愿的、无提示的。
而这个项目存在多个同名站点:2026-08-21 搜索时,
除官方站外还能搜到 hermes-agent.org、hermes-ai.net 等域名。
本文不判断它们各自是什么性质——但你必须自己确认哪个是官方的。
可自查的办法(对任何开源项目都通用):去 GitHub 上找到项目仓库, 看仓库页面上的 homepage / website 字段——那是维护者自己填的。 以它为准,别以搜索排名为准。
前置很轻:只需要 Git(Linux 上另需 curl 与 xz-utils)。
Python 3.11、Node 22、ripgrep、ffmpeg 都由安装脚本用 uv 自动拉,不用你手动装。
装到哪:用户级在 ~/.hermes/hermes-agent/,可执行文件 ~/.local/bin/hermes;
root 模式则在 /usr/local/ 下。
| 文件 | 装什么 |
|---|---|
~/.hermes/config.yaml | 设置 |
~/.hermes/.env | 密钥 |
用 hermes config set 写入时会自动分流:API key 进 .env,其余进 config.yaml。
这个设计让备份变得简单——配置随便备,密钥单独排除。
模型配置就是主心骨那篇讲的三个旋钮:
而且每个模型槽位都是这三个——主模型、辅助任务、上下文压缩、兜底。
base_url 指向任意 OpenAI 兼容端点,用 OPENAI_API_KEY 认证。
供应商可选 Nous Portal(hermes setup --portal 走 OAuth,不用手配 key)、
OpenRouter、OpenAI、或你自己的端点;hermes model 交互式切换。
执行沙箱七选一——决定它跑的命令在哪儿执行:
| 后端 | 意味着 |
|---|---|
local | 就在本机跑。最方便也最没有隔离 |
Docker | 容器里跑,本机受保护 |
SSH | 跑在远端机器上 —— 这是「本地→云」的过渡桥,见第 17 篇 |
Modal / Daytona | 无服务器,闲置时休眠,不用时几乎不花钱 |
Singularity / Vercel Sandbox | 另两种容器/沙箱环境 |
消息网关——决定你从哪儿跟它说话:Telegram、Discord、Slack、WhatsApp、
Signal、Email、Home Assistant。hermes gateway setup 起步,
hermes gateway install 装成系统服务(Linux systemd / macOS launchd)。
网关的默认策略值得单独表扬:默认拒绝所有不在白名单、也没经私信配对的用户。 详见第 15 篇。
记忆这件事很多 agent 都有。Hermes 多做了一步:把「怎么做成的」也记下来, 变成一条可复用的技能,并且在下次用到时自己改进它。
配套的还有跨会话检索(能搜自己的历史对话)和对用户的持续建模。 技能本身是可移植、可分享的,对接开放的技能标准。
自动生成的技能是模型对自己过去行为的总结,它可能把一次侥幸成功 固化成一条「以后都这么办」。
所以定期翻一下它给自己攒了哪些技能,把不对的删掉—— 和项目记忆一样,这类东西是要修剪的,不是要积累的。
| 命令 | 做什么 |
|---|---|
hermes / hermes --tui | 启动,后者是新版界面 |
hermes --continue | 接着上一次的会话 |
hermes model | 换模型 |
hermes tools | 开关工具,见第 16 篇 |
hermes doctor | 出问题先跑这个 |
hermes claw migrate | 从 OpenClaw 搬家,见下一篇 |
NousResearch/hermes-agent,Python,MIT,233,749 ★ / 46,868 fork,
建于 2025-07-22,最新 release v2026.8.18(v0.20.4,2026-08-18)。GitHub API,2026-08-21 核。install.sh / install.ps1;唯一前置 Git(Linux 另需 curl、xz-utils);
Python 3.11 / Node 22 / ripgrep / ffmpeg 由脚本经 uv 自动安装;
装到 ~/.hermes/hermes-agent/ + ~/.local/bin/hermes。官方文档,2026-08-21 核。~/.hermes/config.yaml + ~/.hermes/.env;
每个模型槽位统一 provider/model/base_url,
base_url 官方描述为「指向自定义 OpenAI 兼容端点,使用 OPENAI_API_KEY 认证」。hermes-agent.org、hermes-ai.net。
本文不判断其性质,只强调 curl | bash 前必须自行确认官方域名(建议以仓库 homepage 字段为准)。