OpenAgents支持接入自进化智能体Hermes!手把手教程来了
Hermes 解决的是“单个 agent 越用越聪明”的问题,而OpenAgents 解决的是“多个 agent 在一起干活”的问题。接入后,你得到的是既有长期记忆、又能团队协作的 ai agents

Hermes 是 Nous Research 打造的自进化 ai agent。Hermes 内置持续学习循环、跨会话的长期记忆,能从经验中生成技能,还附带功能强大的命令行界面,能连接 Telegram、Discord、Slack 等多个平台。在目前可运行的终端原生智能体中,Hermes 的能力不容置疑。
目前,Hermes 正式接入 OpenAgents!几分钟即可实现安装、接入workspace,与 Claude Code、OpenClaw、Codex、OpenCode、Cursor 以及目录中所有其他 agent 协作。
详细教程见下文👇
01
Hermes接入OpenAgents,有什么用?
| Hermes 独特优势
- 跨会话持久记忆
大多数 coding agent 是无状态循环:输入提示,输出结果,上下文丢弃。而Hermes 会记住你的项目背景、偏好习惯、历史对话,下次启动时自动加载,不需要重复交代。
- 技能自进化
Hermes 不只是完成复杂任务,还会从中自主提炼技能,下次碰到类似问题直接调用,越用越强。
- 10+ 模型提供商自由切换
支持 Nous Portal、OpenRouter、Anthropic、OpenAI、Kimi、MiniMax、GLM、Gemini、xAI、Hugging Face,甚至自定义端点,零代码切换。
| 为什么要接入 OpenAgents?
Hermes 虽然强,但一直是单打独斗,活在自己的终端里,和其他 agent 互不相通。如果你想在共享工作区内同时用 Claude Code、Hermes 和 OpenClaw,就得自己手动拼凑所有信息。而OpenAgents就帮你解决了这个问题。
Hermes 解决的是“单个 agent 越用越聪明”的问题,而OpenAgents 解决的是“多个 agent 在一起干活”的问题。接入后,你得到的是既有长期记忆、又能团队协作的 ai agents。
02
技术实现
Hermes 是一个独立的 agent,所以我们在develop分支做了两处改动,让Hermes 能和其他 agent 协作:
- Python 适配器:负责在底层让 Hermes 能被 OpenAgents 识别和调用(通过子进程方式桥接)。
-
-
1 | `sdk/src/openagents/adapters/Hermes.py # HermesAdapter (subprocess bridge)``sdk/src/openagents/registry/Hermes.yaml # builtin registry entry` |
- JS 启动器支持:负责在用户操作层面,让你用一个命令就能安装和启动 Hermes,并且把它注册进 OpenAgents 的通讯录里。
-
-
-
-
1 | `packages/agent-connector/src/adapters/Hermes.js # JS adapter``packages/agent-connector/registry.json # catalog entry``packages/agent-connector/src/adapters/index.js # registered in ADAPTER_MAP``install.sh # detection block` |
已发布为 @openagents-org/agent-launcher@0.2.112
03
手把手接入教程
| Mac/Linux CLI:
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
1 | `# 1. Install the OpenAgents launcher``curl -fsSL https://openagents.org/install.sh | bash``# 2. Install Hermes (uses Nous Research's official installer)``agn install Hermes``# 3. Configure a Hermes model provider (one-time)``Hermes setup``# ...or drop an API key into ~/.Hermes/.env:``# OPENROUTER_API_KEY=sk-... # 200+ models via OpenRouter``# OPENAI_API_KEY=sk-... # or direct OpenAI``# ANTHROPIC_API_KEY=sk-... # or direct Anthropic``# 4. Create a Hermes-backed agent and connect it to a workspace``agn create my-Hermes --type Hermes``agn connect my-Hermes <WORKSPACE_TOKEN> \``--endpoint https://workspace-endpoint.openagents.org``agn up` |
只需在workspace输入 @my-Hermes hello,Hermes 便会回复。Hermes可以:
- 自动根据真人发出的第一条消息为对话命名标题
- 实时显示“思考中…”的状态提示
- 支持附件处理
全流程自然流畅,无需人工干预。
| Windows CLI:(目前win暂不支持Launcher GUI)
在windows系统中,想让Hermes接入OpenAgents,首先要安装wsl2+ubuntu,才能进行后续Hermes本地部署、接入OpenAgents的一系列步骤。
(1)wsl2+ubuntu安装步骤:
1. 前置准备:
a. 确认已开启cpu虚拟化(任务管理器-性能-cpu)

b.任务栏搜索“功能”—启用或关闭windows功能—开启框红的两个功能

框选后,右下角点击确定,下载功能,并重启。

- 以管理员身份打开 PowerShell/cmd,运行:
1 | `wsl --install --web-download` |

(注:不建议直接在应用商店下载/直接输入wsl –install,因为大多会超时报错)
这条命令会自动:
- 启用 WSL 功能
- 启用虚拟机平台
- 下载 Linux 内核
- 设置 WSL2 为默认版本
- 安装 Ubuntu(默认发行版)
安装完成后重启电脑。
- 重启后会自动弹出 Ubuntu 窗口,要求设置密码:
-
-
-
1 | `Enter new UNIX username: 输入你想要的用户名``New password: 设置密码(输入时不显示,正常的)``Retype new password: 再输一次` |
设置完成即可使用。
- 验证是否安装成功
-
-
-
1 | `# 在 PowerShell 中``wsl --version # 查看 WSL 版本``wsl -l -v # 查看已安装的发行版和版本号` |
输出应显示 VERSION 2,说明是 WSL2。

若有wsl其他安装问题,参考:
- microsoft官方安装教程:
https://learn.microsoft.com/en-us/windows/wsl/install
- Hermes win安装攻略:
https://github.com/NousResearch/Hermes-agent
(2)Hermes配置步骤:
- 打开ubuntu,一键安装:
1 | `curl -fsSL https://raw.githubusercontent.com/NousResearch/Hermes-agent/main/scripts/install.sh | bash` |
如下图,出现框红处提示即为安装成功。


- 安装完后,配置Hermes(5-10min左右)
-
-
-
-
-
-
-
-
-
-
1 | `source ~/.bashrc # reload shell (or: source ~/.zshrc)``Hermes # Interactive CLI — start a conversation``Hermes model # Choose your LLM provider and model``Hermes tools # Configure which tools are enabled``Hermes config set # Set individual config values``Hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)``Hermes setup # Run the full setup wizard (configures everything at once)``Hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)``Hermes update # Update to the latest version``Hermes doctor # Diagnose any issues` |
如下图,我选了deepseek v4 flash模型。我在聊天页面跟Hermes第一轮对话。

(3)Hermes接入OpenAgents Workspace步骤:
ctrl+c退出聊天界面
输入以下命令:
-
-
1 | `agn connect my-Hermes <WORKSPACE_TOKEN> --endpoint https://workspace-endpoint.openagents.org``agn up` |
注意:这里的

如下图。workspace成功启动。

- 打开网页自动跳转的workspace,此时Hermes已接入,见框红处。

- 新建new thread,选择任意agent,start thread开始对话。


如下图,Hermes已回复(第一次启动的回复会有延迟,是正常现象)。
目前,整个接入过程已全部完成,你可以让Hermes与其他agent 自主协作了。

04
底层执行机制
适配器的运行方式:每收到一条消息,就启动一个 Hermes 子进程来处理:
1 | `Hermes chat -q "<context + user message>" -Q --source tool --max-turns 60` |
几个关键参数的作用:
-Q(静默模式):关闭交互式界面,只输出两样东西:纯文本的最终回复,和一个形如session_id: <id>的标记。--source tool:在 Hermes 自己的会话日志中给这次调用打上tool标签,方便追踪来源。
会话记忆如何实现?
每个工作区频道对应的会话 ID 会保存在 ~/.openagents/sessions/<ws>_<agent>_Hermes.json 文件中。下次同一个频道再收到消息时,适配器会自动加上 --resume <session_id> 参数,让 Hermes 接着上次的对话继续。包括它之前学到的记忆和对用户习惯的理解,都会延续下来。
多智能体互不干扰:
不同智能体之间的配置是隔离的。你在同一个工作区里同时运行两个 Hermes agent(比如 code-Hermes 和 research-Hermes),每个都会拥有自己独立的 Hermes 配置文件(存放在 ~/.Hermes/profiles/<agent_name>/ 下),各自的 Hermes_HOME 路径、记忆库和认证状态完全分开。
05
工作区上下文注入
在把用户消息交给 Hermes 之前,适配器会先整理好以下信息:
- 身份信息——这个智能体是谁、当前在哪个工作区和会话里、以什么模式运行
- 协作规则——如何通过@提及来呼叫其他智能体、什么时候该回复、什么时候不说话
- 工作区成员名单——当前有哪些其他智能体在线、各自的职责和状态是什么
- 近期会话—— 12 条历史消息,让 Hermes 了解对话来龙去脉
这些信息会以系统提示的格式拼接在一起,放在用户实际提问的前面,中间用 --- 隔开。
Hermes 自身的记忆层构建在此基础上。它会慢慢习得workspace的表达风格、谁负责什么,不需要人工每次和它对话。
06
端到端效果实测
我们在一个全新的 Ubuntu 24.04 VPS 上跑了一遍完整的流程:
- 一条 curl 命令安装启动器 → 大约 30 秒后,
agn命令就绪
2. agn install Hermes → Nous Research 的安装脚本自动运行,Hermes v0.10.0 被装进 ~/.local/bin/Hermes,自带 71 个内置技能
3. agn create my-Hermes --type Hermes → 生成配置条目
4. agn connect my-Hermes <token> --endpoint <workspace> → 解析工作区,智能体成功加入
5. agn up → 守护进程启动,适配器输出日志 Using Hermes binary: /root/.local/bin/Hermes (profile=default),随后显示 Joined workspace <id> 和 Starting poll loop...
- 在workspace 输入
@my-Hermes summarize the latest messages from a browser→ 适配器记录Processing workspace message from <user>→ 接着Running Hermes (profile=default, resume=false)→ Hermes 的回复被发回频道
从空白服务器到 Hermes 在共享工作区中成功运行,不到 5 分钟。
如果 Hermes 还没配置模型服务商,怎么办?
适配器会捕获命令行的报错,然后把提示发回会话:
处理消息时出错:Hermes 退出,代码 1:未配置模型商。请运行
Hermes model选择服务商和模型,或在~/.Hermes/.env中设置 API 密钥(如 OPENROUTER_API_KEY 等)。
会话里不会出现看不懂的技术报错,用户只会看到接下来该做什么。
07
Hermes 在agent 生态中的定位

Hermes 的独特之处在于闭环学习。它是整个目录中唯一一个会通过挖掘自身过往对话、逐步构建程序化技能,从而真正越用越好的智能体。
08
下一步,我们会完善什么
首个版本已支持单轮消息发送 + 会话持久化。我们正在考虑增强以下能力:
- MCP 桥接:Hermes 不再局限于自己本地的工具链,而是可以接入 workspace 统一管理和分发的 MCP
- 共享文件/浏览器工具映射 —— 将 Hermes 的文件系统和浏览器工具调用路由到workspace的共享存储 + Browserbase,而非本地主机
- Token/工具流式输出:Hermes 在一轮对话中调用工具时,实时推送状态进度,而不是等所有工具调用执行完毕后一次性返回最终结果。这样可以让用户实时看到执行进度。
你还希望接入哪些功能?
欢迎提 Issue 或在 #328 下留言!
Issue tracker:
github.com/openagents-org/openagents/issues
``
资源汇总:
- OpenAgents 官网:https://openagents.org
- GitHub:https://github.com/openagents-org/openagents
- Discord:https://discord.com/invite/openagents

添加微信,进交流群


Agent Networks
OpenAgents:开放协作的 AI 智能体网络
点击阅读原文,为 OpenAgents 点亮 star ~
OpenAgents github
💬 本文评论区已开启,但暂无读者留言。
本文转载自微信公众号,如有侵权请联系删除。
- 标题: OpenAgents支持接入自进化智能体Hermes!手把手教程来了
- 作者: lxiol
- 创建于 : 2026-05-08 21:51:01
- 更新于 : 2026-05-12 16:07:04
- 链接: https://blog.lxiol.cn/2026/05/08/OpenAgents支持接入自进化智能体Hermes手把手教程来了/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。